taskd(5)

📦
version 1.1.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 taskd(5) 💖

okay so bestie, welcome to the User Manuals section, page taskd(5) — this is the literal blueprint for how you configure the taskd(1) server, and honestly? it's giving "small file, big power." let's get into it 🫶

🌸 NAME 🌸

taskdrc — the configuration details for the taskd(1) server. yes that's it, that's the name, she's simple and she knows it 💅

✨ CONFIGURATION VARIABLES ✨

so here's the whole menu of valid variable names and their default values, no gatekeeping:

  • ca.cert — the fully qualified path to the CA certificate. it's optional, so no pressure 🦋
  • ciphers — the list of GnuTLS ciphers to use. the default is "NORMAL". for the full tea, go check your GnuTLS documentation, she has all the details ✨
  • confirmation=on — decides whether certain commands get confirmed. defaults to on. consent era 💖
  • client.cert — fully qualified path of the client cert. this one's used by the 'client' command, iykyk
  • debug=off — logs debugging information. default is off, obviously
  • debug.tls=0 — the GnuTLS log level, an integer from 0 to 9, where 0 means no logging and 9 means sensitive data leaks. caution! 😭 like genuinely, be careful
  • extensions=<path> — fully qualified path of the Taskserver extension scripts. currently there are none, so it's giving "placeholder main character" 💀
  • family=IPv4 — specifies the address family to use. can be 'IPv4', 'IPv6', or not specified at all, which means 'any'. default is no value ⭐
  • ip.log=on — logs the IP addresses of incoming requests. default on
  • log=/tmp/taskd.log — fully-qualified path name to the Taskserver log file. alternately, setting the value to '-' sends all logging to STDOUT. quick note: this does not apply when the server is run as a daemon 🙈
  • pid.file=/tmp/taskd.pid — fully-qualified path name to the Taskserver PID file. the 'taskdctl' script uses this to start/stop the daemon, so don't lose her 🎀
  • queue.size=10 — size of the connection backlog. see man listen for the lore
  • request.limit=1048576 — size limit of incoming requests, in bytes. use a value of zero '0' to mean no size limit at all, live your truth 🔥
  • server=localhost:53589 — the address (IPv4, IPv6 or DNS) of the Taskserver, followed by a colon and the port number. iconic format, no notes
  • server.cert — fully qualified path to the server certificate 👑
  • server.crl — fully qualified path to the server certificate revocation list
  • server.key — fully qualified path to the server key 🔑
  • trust — the trust level of the server, which determines how the client certificates are verified. if the value is 'allow all' then no verification is performed. defaults to 'strict'. bestie, 'allow all' is the wild-child setting, choose wisely 💀
real talk though: sending the HUP signal to the Taskserver causes a configuration file reload before the next request is handled. so you can refresh the vibes without a full restart, slay ✨

🔥 ENVIRONMENT VARIABLES 🔥

environment variables provide values that would otherwise be required at the command line. literally just convenience, and we love her for it 💜

  • TASKDDATA=<root> — most commands require either --data <root> or this environment variable. and if you provide both? the command line overrides the environment. periodt, CLI wins 👑

🎀 CREDITS & COPYRIGHTS 🎀

Copyright (C) 2012 - 2015, Göteborg Bit Factory. 🫶

Taskserver is distributed under the MIT license. see http://www.opensource.org/licenses/mit-license.php for more information.

🌈 SEE ALSO 🌈

taskd(1), taskdctl(1)

for more information regarding Taskserver, see the following:

you can contact the project by emailing <support@taskwarrior.org> 💌

🦋 REPORTING BUGS 🦋

bugs in Taskserver may be reported to the issue-tracker at <http://taskwarrior.org

ngl the original page forgot to close that bracket and honestly? relatable. we stan a chaotic queen 😭

okay bestie that's the whole page, every single variable accounted for, no cap, no crumbs left behind 💅✨

and for the cute sign-off: this was taskd 1.1.0, dated 2015-05-10 — go forth and configure responsibly 🍓🧚💖

📦 where this page comes from