Vue d'ensemble

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).

Exigences

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).

Arguments d'exécution

Interface utilisateur Web: http://[IP]:[PORT:8080]/
Réseau: bridge
Coquille: sh
Privilégié: false
Paramètres supplémentaires: --restart=unless-stopped

Configuration du modèle

WebUI PortPorttcp

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

Cible: 8080
Défaut: 8007
Valeur: 8007

DataPathrw

Persistent storage for the SQLite task database.

Cible: /var/lib/taskchampion-sync-server
Défaut: /mnt/user/appdata/taskchampion-sync-server
Valeur: /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).

Défaut: 99
Valeur: 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).

Défaut: 100
Valeur: 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.

Cible: 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.

Cible: NO_CREATE_CLIENTS
Défaut: false
Valeur: false

Listen AddressVariable

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

Cible: LISTEN
Défaut: 0.0.0.0:8080
Valeur: 0.0.0.0:8080

Catégories

Productivity Tools > Utilities

Liens

Modèle Soutien Registre Proprojet

Détails

Référentiel

ghcr.io/furan917/taskchampion-sync-server:latest

Registre

https://github.com/furan917/taskchampion-sync-wrapper/pkgs/container/taskchampion-sync-server

Dernière mise à jour2026-05-31

Première vue2026-05-16

Exécutez taskchampion-sync-server sur Unraid.

taskchampion-sync-server est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.

Explorez Unraid OS