taskchampion-sync-server

taskchampion-sync-server

Docker 应用程序 from UnraidUser-3609265787's Repository

概述

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

要求

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

运行时参数

网络用户界面
http://[IP]:[PORT:8080]/
网络
bridge
外壳
sh
特权
false
额外参数
--restart=unless-stopped

模板配置

WebUI PortPorttcp

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

目标
8080
默认值
8007
价值
8007
DataPathrw

Persistent storage for the SQLite task database.

目标
/var/lib/taskchampion-sync-server
默认值
/mnt/user/appdata/taskchampion-sync-server
价值
/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).

默认值
99
价值
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).

默认值
100
价值
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.

目标
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.

目标
NO_CREATE_CLIENTS
默认值
false
价值
false
Listen AddressVariable

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

目标
LISTEN
默认值
0.0.0.0:8080
价值
0.0.0.0:8080

详细信息

存储库
ghcr.io/furan917/taskchampion-sync-server:latest
最后更新2026-06-02
初见2026-05-16

在Unraid 上运行 taskchampion-sync-server 。

taskchampion-sync-server 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。