Skip to content

Taskserver - Taskwarrior Synchronisation Server


Unknown, Unknown licenses found

Licenses found

Notifications You must be signed in to change notification settings


Repository files navigation


Thank you for taking a look at Taskserver!

Taskserver is a daemon or service that will allow you to share tasks among different client applications, primarily Taskwarrior.

Taskserver is compatible with Taskwarrior version 2.4.x and later, but works best with the latest Taskwarrior.


Taskserver setup is complex. Be very careful when following instructions. Here is the only supported Taskserver setup guide. Ignore all others.


For troubleshooting, here is the only supported Taskserver troubleshooting guide. Ignore all others.


Almost every configuration problem is caused by not following the setup guide above carefully enough, followed by not following the troubleshooting guide carefully enough. If you cut corners or skip steps, it will not work.


There is extensive online documentation. You'll find all the details at

At the site you'll find online documentation, downloads, news and more. Additionally there are three man pages installed:

  • taskd(1)
  • taskdctl(1)
  • taskdrc(5)


For support options, take a look at

Please use pull requests, or alternately send your code patches to

Branching Model

We use the following branching model:

  • master is the stable branch. Building from here is the same as building from the latest tarball, or installing a binary package. No development is done on the master branch.

  • 1.2.0 is the current development branch. All work is done here, and upon release it will be merged to master. This development branch is not stable, may not even build or pass tests, and should be treated accordingly. Make backups.


There are many binary packages available, but to install from source requires:

  • git
  • cmake
  • make
  • C++ compiler, currently gcc 4.7+ or clang 3.3+ for full C++11 support

Download the tarball, and expand it:

$ curl -O
$ tar xzf taskd-1.2.0.tar.gz
$ cd taskd-1.2.0

Or clone this repository:

$ git clone --recursive
$ cd taskserver

In case of errors with libshared (URL pointing to

$ sed -i 's/\/TM/\/GothenburgBitFactory/' .git/config
$ git submodule update

Then build:

$ cmake -DCMAKE_BUILD_TYPE=release .
$ make
[$ make test]
$ sudo make install


Your contributions are especially welcome. Whether it comes in the form of code patches, ideas, discussion, bug reports, encouragement or criticism, your input is needed.

Visit Github and participate in the future of Taskserver.


Taskserver is released under the MIT license. For details check the LICENSE file.