Skip to content

Stellwerk

Keep files up to date on every computer in a business, without a cloud or a file server. Project folders, templates and plans reach the office PC, the boss's laptop and the notebook at the site; a PC that is off catches up as soon as it is back.

Stellwerk is a central web UI for Syncthing on your own server. Pair a device once, then decide in one place which folders it gets, in which direction and at which path. Every device is set up automatically; nobody clicks "accept" on each PC.

Stellwerk overview: a folder by device matrix with the server column, live status and a draft of two changes

How it works in one minute

flowchart LR
    UI["Web UI<br/>(your browser)"] -- HTTPS --> Z
    subgraph Server
        Z["Zentrale<br/>web UI, database,<br/>desired state"] -- REST API --> H["Hub Syncthing<br/>full copy of every folder"]
    end
    subgraph "Each device"
        A["stellwerk-agent"] -- REST API --> S["own Syncthing"]
    end
    A -- "WebSocket (HTTPS)<br/>desired state, status" --> Z
    S -- "Syncthing protocol (TLS)<br/>files" --> H
  • The Zentrale runs on your server. It stores which folder goes to which device and turns that into a desired state for every device.
  • A small agent runs on every device (Linux, Windows, macOS). It brings its own Syncthing, receives its desired state from the Zentrale and configures its Syncthing to match it.
  • A hub Syncthing on the server is a member of every folder and keeps a full copy with versions. Devices sync with the hub, so two PCs that are never on at the same time still get each other's changes.
  • Syncthing moves the files, encrypted and directly between device and server. Stellwerk only steers Syncthing; it never touches your files except when you resolve a conflict or restore a version.

Where to go next

If you want to … Read
try it and sync a first folder Getting started
know what each part of the UI does User guide
run the server for real: container, reverse proxy, backups, updates Installation
look up an option, a port or a file Reference
know who can access what Security
fix something that does not work Troubleshooting
understand the design: protocol, reconciler, data model Architecture
build, test or change Stellwerk Development

Status

Stellwerk is before v1.0. The Zentrale, the agent with its service and the Windows installer, pairing with a code or in the LAN, the matrix, live status, conflicts, versions and ignore patterns work and are tested against real Syncthing instances on Linux, Windows and macOS. Every release publishes the image tristanteu/stellwerk and the agents on GitHub. Open before v1.0: self-update of the agent on Windows. See the roadmap.