taskd - Taskserver
Contents
Commands
Taskserver supports several commands, which provide administrative capabilities. The commands are:
taskdinit[--data<root>][options]
Performs a one-time initialization of the Taskserver instance. Creates the bare data structure.
Either '--data <root>' must be specified, or TASKDDATA must be set.
taskdhelp<command>[options]
Provides option and syntax help for each command.
taskdconfig[options][--data<root>][--force][<name>[<value>]]
Allows modification of the taskd configuration. Can add, remove, modify or list all configuration
settings. Either '--data <root>' must be specified, or TASKDDATA must be set.
taskdserver[--daemon][options]
Starts the server in daemon or TTY mode. While there is no interactivity, the difference is
whether taskd is attached to a TTY or not.
Note that sending the HUP signal to the taskd server causes a configuration file reload before the
next request is handled.
taskdadd[--data<root>]org<org>taskdadd[--data<root>]group<org><group>taskdadd[--data<root>]user<org><user>
Adds organizations, groups and users. Either '--data <root>' must be specified, or TASKDDATA must
be set.
taskdremove[--data<root>]org<org>taskdremove[--data<root>]group<org><group>taskdremove[--data<root>]user<org><user>
Removes organizations, groups and users. Either '--data <root>' must be specified, or TASKDDATA
must be set.
taskdsuspend[--data<root>]org<org>taskdsuspend[--data<root>]group<org><group>taskdsuspend[--data<root>]user<org><user>
Suspends organizations, groups and users. Either '--data <root>' must be specified, or TASKDDATA
must be set.
taskdresume[--data<root>]org<org>taskdresume[--data<root>]group<org><group>taskdresume[--data<root>]user<org><user>
Resumes organizations, groups and users. Either '--data <root>' must be specified, or TASKDDATA
must be set.
taskddiagnostics
Displays diagnostic information important when reporting bugs.
taskdvalidate<JSON|file>
Parses the quoted JSON string or JSON file. Useful for debugging JSON that is generated by
Taskserver clients.
taskdclient[options]<host:port><file>[<file>...]
Sends the Taskserver request in <file> to <host:port>. Options specified must include ca.cert (for
self-signed certs), client.cert, client.key.
Common Options
Most commands support the following options:
--NAME=VALUE
Temporary configuration override.
--force
Does not ask for confirmation of changes.
--quiet
Suppresses verbose output.
--debug
Shows debugging information.
--data<root>
Many commands require the location of the data root, so either it must be provided as shown, or
via the TASKDDATA environment variable.
Configuration
The Taskserver configuration file can be found in the top level of the data root. It is recommended that
the 'taskd config' command is used to manipulate this file.
Note that any configuration variable may be overridden on the command line using this syntax:
$ taskd server --NAME=VALUE
In all commands but one, this will _temporarily_ override the value, but with the 'init' command, which
creates a config file, overrides are made permanent.
Credits & Copyrights
Copyright (C) 2010 - 2015, Göteborg Bit Factory.
Taskserver is distributed under the MIT license. See http://www.opensource.org/licenses/mit-license.php
for more information.
Description
Taskserver is a sync server for Taskwarrior and related products.
Environment Variables
Environment variables provide values that would otherwise be required at the command line.
TASKDDATA=<root>
Most command require either '--data <root>' or this environment variable. If both are provided,
the command line overrides the environment.
Name
taskd - Taskserver
Reporting Bugs
Bugs in Taskserver may be reported to the issue-tracker at
<http://taskwarrior.org
taskd 1.1.0 2015-05-10 taskd(1)
See Also
taskdrc(5),taskdctl(1) For more information regarding Taskserver, see the following: The official site at <http://taskwarrior.org> The official code repository at <https://git.tasktools.org/scm/tm/taskd.git> You can contact the project by emailing <support@taskwarrior.org>
Synopsis
taskd<command>[options][<args>]taskd-v|--versiontaskd-h|--helptaskddiagnosticstaskdvalidate<JSON|file>taskdhelp[<command>]
