DEPRECATION WARNING

Since the release of Taskwarrior version 3.0.0 the taskd server is no longer applicable and has been replaced by TaskChampion Sync-Server. For that reason, this repository together with the container image will be archived here in the next days.

Once archived, the repository will appear as a directory inside docker-archived-projects and will contain everything here (including the git history). On the other hand, the docker images will be removed from both Quay and GitHub.

My advice is to upgrade as soon as possible to Taskwarrior version 3 or higher and, if you need it, use the new server. If you want to use the new server in Docker do the following.

git clone git@github.com:GothenburgBitFactory/taskchampion-sync-server.git
cd taskchampion-sync-server
source .env
docker build -t taskchampion-sync-server .
mkdir /volume/to/permanet/data # Set your own directory here
chown 100:100 /volume/to/permanet/data
docker run -d \
  --name=task-sync-server \
  -p 8080:8080 \
  -v /volume/to/permanet/data:/var/lib/taskchampion-sync-server \
  taskchampion-sync-server

Note that this new server does not have (for now) user authentication methods, so maybe in your case it is more interesting to use a cloud storage server as detailed in the task-sync(5) manpage.

Taskwarrior Server (taskd) container

(c) 2015-2024 Óscar García Amor

Redistribution, modifications and pull requests are welcomed under the terms of MIT license.

Taskwarrior is Free and Open Source Software that manages your TODO list from your command line. It is flexible, fast, efficient, and unobtrusive. It does its job then gets out of your way.

This container packages taskd, Taskwarrior sync server, under Alpine Linux, a lightweight Linux distribution.

Visit Quay or GitHub to see all available tags.

Run

To run this container exposing taskd default port and making the data volume permanent in /srv/taskd, simply run.

docker run -d \
  --name=taskd \
  -p 53589:53589 \
  -v /srv/taskd:/var/taskd \
  ghcr.io/connectical/taskd

This makes a set of self signed certificates and minimal configuration to run server.

Environment variables

Certificate attributes can be customized using environment variables.

Variable	Default value
CERT_BITS	4096
CERT_EXPIRATION_DAYS	365
CERT_ORGANIZATION	"Göteborg Bit Factory"
CERT_CN	localhost
CERT_COUNTRY	SE
CERT_STATE	"Västra Götaland"
CERT_LOCALITY	"Göteborg"

Note that, by default, the generated certificates will have their CN set to localhost.

If you have never run the container you can launch it as follows to set the certificate values.

docker run -d \
  --name=taskd \
  -e CERT_BITS=4096 \
  -e CERT_EXPIRATION_DAYS=365 \
  -e CERT_ORGANIZATION="Göteborg Bit Factory" \
  -e CERT_CN=localhost \
  -e CERT_COUNTRY=SE \
  -e CERT_STATE="Västra Götaland" \
  -e CERT_LOCALITY="Göteborg" \
  -p 53589:53589 \
  -v /srv/taskd:/var/taskd \
  ghcr.io/connectical/taskd

If you have the container running and you need to regenerate the certificates or modify their parameters.

• Make sure that the container is running.
• Execute a shell in the running container.

  docker exec -t -i \
    <container-id> sh

• Go to /var/taskd/pki and delete all pem files, you should be left with only the generate scripts (generate*) and the vars file.

  rm *pem

• Run.

  export CERT_BITS=4096
  export CERT_EXPIRATION_DAYS=365
  export CERT_ORGANIZATION="Göteborg Bit Factory"
  export CERT_CN=localhost
  export CERT_COUNTRY=SE
  export CERT_STATE="Västra Götaland"
  export CERT_LOCALITY="Göteborg"
  ./generate

Manual setup

The run.sh script that launch taskd server always look for config file in data volume /var/taskd. If found it, simply run the server, but if config file is absent run.sh will build a new default config and its certificates.

If you make the data volume permanent you can access to its contents and make modifications that you need. The significant files are.

• config taskd config itself.
• log directory of log.
• org taskd data.
• pki directory that contains certs and certs generation helpers.

You can do any changes to this, but remember that if you delete config file, the run.sh script will rebuild everything.

Please refer to Taskwarrior Docs to know how do modifications, add users, etc.

Shell run

In some cases, you could need to run taskd command. You can run this container in interactive mode, simply do.

docker run -ti --rm \
  -v /srv/taskd:/var/taskd \
  ghcr.io/connectical/taskd /bin/sh

This mounts the permanent data volume /srv/taskd into taskd data directory and gives you a interactive shell to work.

Please note that the --rm modifier destroy the container after shell exit.