TJD3(1)

📦
version 3.8.1 · 5 versions
, in ubuntu resolute, ubuntu stonking

💅 TJD3 — the TaskJuggler daemon, bestie edition

okay so real quick: this is the manual page for tj3d(1), aka the TaskJuggler daemon, from the TaskJuggler family. yes the header says TJD3(1) and the command is tj3d — that's just how it is, we don't question the vibes. sit down, grab a strawberry 🍓, and let's get into it.

✨ SYNOPSIS ✨

tj3d [options] [<tjp file> [<tji file> ...] ...]

that's it, that's the whole entrance. options, then optionally a <tjp file>, and then as many <tji file>s as your little heart desires (the ... after them literally means "keep going bestie").

🌸 DESCRIPTION 🌸

so the TaskJuggler daemon is your little report-making machine that hangs out in memory 👑. it can be used to quickly generate reports for a bunch of scheduled projects that are resident in memory — like, they're already loaded and chilling, so reports come out fast.

once the daemon has been started, you use tj3client to control it. that's the whole dynamic. daemon stays up, client does the talking.

💅 OPTIONS 💅

  • -c, --config <FILE> — point it at the YAML configuration file you want it to use.
  • --silent — hush mode. don't show program and progress information.
  • --no-color — no ANSI control sequences coloring your terminal output. colors should only be used when spooling to an ANSI terminal, and if that detection fails, this option forces colors off. periodt.
  • --debug — turn on Ruby debug mode.
  • -d, --dont-daemonize — don't put the program into daemon mode. keeps it connected to the terminal and shows debug output.
  • -p, --port <NUMBER> — use the specified TCP/IP port to serve tj3client requests. (Default: 8474.)
  • --logfile <FILE NAME> — log daemon messages to the specified file.
  • --urifile <FILE NAME> — if the port is 0, use this file to store the URI of the server.
  • -w, --webserver — start a web server that serves the reports of the loaded projects. 🌈
  • --webserver-port <NUMBER> — use the specified TCP/IP port to serve web browser requests. (Default: 8080.)
  • -h, --help — show this message.
  • --version — show version info.

🚨 SECURITY 🚨

okay bestie, listen closely, this is the important part 🙈. the author advises:

"the daemon has not received any kind of security review ... only use the daemon in a trusted environment with only trusted users!"

like. no security review. at all. so keep it in a trusted environment with only trusted users, fr fr. don't be brave about this one 💀.

🦋 ENVIRONMENT 🦋

  • HOME — the user's home folder. used to search for the configuration file if not specified.

🎀 FILES 🎀

  • .taskjugglerrc or taskjuggler.rc — tj3d searches for a config file named .taskjugglerrc or taskjuggler.rc in the current path, the user's home path as specified by the HOME environment variable, or /etc/. at a minimum the file must contain:
_global:
  authKey: ********

(the user should specify their own auth key and set file permissions accordingly, pls pls pls 🫶). an alternative config file location may be specified using the -c, --config FILE option.

  • tj3d.log — the tj3d log file, created in the working directory. location can be overridden using the --logfile FILE option.

Copyright © 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020

by Chris Schlaeger <cs@taskjuggler.org>

this program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

for more info about TaskJuggler see http://www.taskjuggler.org

🌟 SEE ALSO 🌟

and that's the whole page, babe ✨ this was TaskJuggler 3.8.1, dated January 2026 — go be the main character of your own project schedule, mwah 💖

📦 where this page comes from