@@ -46,18 +46,23 @@ On that server, download `docker-compose.yml` from the link above (it is pinned
4646to the latest release) into the current directory. Then run
4747
4848``` sh
49- TASKCHAMPION_SYNC_SERVER_HOSTNAME=taskwarrior.example.com docker compose up
49+ TASKCHAMPION_SYNC_SERVER_HOSTNAME=taskwarrior.example.com \
50+ TASKCHAMPION_SYNC_SERVER_CLIENT_ID=your-client-id \
51+ docker compose up
5052```
5153
54+ The ` TASKCHAMPION_SYNC_SERVER_CLIENT_ID ` limits the server to the given client
55+ ID; omit it to allow all client IDs.
56+
5257It can take a few minutes to obtain the certificate; the caddy container will
5358log a message "certificate obtained successfully" when this is complete, or
5459error messages if the process fails. Once this process is complete, configure
5560your ` .taskrc ` 's to point to the server:
5661
5762```
5863sync.server.url=https://taskwarrior.example.com
59- sync.server.client_id=[ your client-id]
60- sync.encryption_secret=[ your encryption secret]
64+ sync.server.client_id=your- client-id
65+ sync.encryption_secret=your- encryption- secret
6166```
6267
6368The docker-compose images store data in a docker volume named
@@ -149,4 +154,12 @@ docker run -t -d \
149154
150155This start TaskChampion Sync-Server and publish the port to host. Please
151156note that this is a basic run, all data will be destroyed after stop and
152- delete container.
157+ delete container. You may also set ` DATA_DIR ` , ` CLIENT_ID ` , or ` LISTEN ` with ` -e ` , e.g.,
158+
159+ ``` sh
160+ docker run -t -d \
161+ --name=taskchampion \
162+ -e LISTEN=0.0.0.0:9000 \
163+ -p 9000:9000 \
164+ taskchampion-sync-server
165+ ```
0 commit comments