taskchampion-sync-server

taskchampion-sync-server

Docker-Anwendung from UnraidUser-3609265787's Repository

Übersicht

TaskChampion Sync Server is the official sync backend for Taskwarrior 3.x. It allows tasks to be synchronised across multiple devices. Task data is encrypted client-side — the server never sees plaintext. IMPORTANT: you must set Client ID(s) before the container will start. The upstream taskchampion-sync-server provides no HTTP authentication by design; access control is via UUID allowlisting only. For internet-facing deployments, place this behind a reverse proxy with HTTP Basic Auth (e.g. Nginx Proxy Manager).

Anforderungen

Clients must use Taskwarrior 3.0 or any app implementing the TaskChampion sync protocol. Before starting the container, generate a UUID for each device with `uuidgen` and add them all to the Client ID(s) field. Each Taskwarrior client also needs a shared encryption secret (never sent to the server).

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:8080]/
Netzwerk
bridge
Shell
sh
Privilegiert
false
Extra Params
--restart=unless-stopped

Konfiguration der Vorlage

WebUI PortPorttcp

Host port mapped to the container's internal port 8080. Default is 8007 to avoid conflicts with common Unraid services.

Ziel
8080
Standard
8007
Wert
8007
DataPathrw

Persistent storage for the SQLite task database.

Ziel
/var/lib/taskchampion-sync-server
Standard
/mnt/user/appdata/taskchampion-sync-server
Wert
/mnt/user/appdata/taskchampion-sync-server
PUIDVariable

UID the server process runs as. Defaults to Unraid's nobody user (99). Change to match your user ID on other systems (run `id` to find it).

Standard
99
Wert
99
PGIDVariable

GID the server process runs as. Defaults to Unraid's users group (100). Change to match your group ID on other systems (run `id` to find it).

Standard
100
Wert
100
Client ID(s)Variable

Required. UUID(s) allowed to sync. Comma-separated for multiple devices (e.g. uuid1,uuid2). Generate a UUID with `uuidgen` on Linux/Mac or use an online generator. The container will not start without this.

Ziel
CLIENT_ID
No Create ClientsVariable

Set to true to prevent new clients from registering after initial setup. Only useful after all your devices have synced at least once — enabling this before first sync will block even allowed clients.

Ziel
NO_CREATE_CLIENTS
Standard
false
Wert
false
Listen AddressVariable

Address and port the server binds to inside the container. Only change this if you also adjust the container port above.

Ziel
LISTEN
Standard
0.0.0.0:8080
Wert
0.0.0.0:8080

Einzelheiten

Repository
ghcr.io/furan917/taskchampion-sync-server:latest
Zuletzt aktualisiert2026-06-01
Erstmals gesehen2026-05-16

Führen Sie taskchampion-sync-server auf Unraid aus.

taskchampion-sync-server ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.