TJ3WEBD(1)

💅 TJ3WEBD — the TaskJuggler reports web server

okay bestie, welcome to tj3webd, the part of the TaskJuggler manual that lives in the TaskJuggler section of your man pages. it's giving "serve your project reports to the browser" and honestly? iconic. 🫶

---

✨ SYNOPSIS ✨

tj3webd [options]

that's it, that's the whole vibe. options only, no positional args, we keep it clean. 🌸

---

💖 DESCRIPTION 💖

so the TaskJuggler web server? it exists to serve up the HTTP reports of your TaskJuggler projects, and literally any HTML5-compliant web browser can look at them. no cap.

and the way it does that is by leaning on the TaskJuggler daemon (tj3d) for two things: data hosting and report generation. so tj3webd is not doing the heavy lifting alone, it's got a partner in crime. main character energy, but make it a duo. 🔥

---

🎀 OPTIONS 🎀

• -c, --config <FILE> — point it at the specific YAML configuration file you want it to use. yes, a YAML one. ✨
• --silent — don't show off, bestie. no program info, no progress info. just quiet. 🙈
• --no-color — don't use ANSI control sequences to color the terminal output. the whole idea is that colors should only show up when you're spooling to an ANSI terminal, so if that detection fails on you, use this flag to force the colors off.
• --debug — turns on Ruby debug mode. 🐛
• -d, --dont-daemonize — don't shove the program into daemon mode. instead it stays connected to the terminal and shows you debug output. like, it stays with you. 💜
• -p, --port <NUMBER> — use this specific TCP/IP port to connect to the TaskJuggler daemon. Default: 8474.
• --pidfile <FILE NAME> — write the process ID of the daemon into the file you name here.
• --logfile <FILE NAME> — log daemon messages to the file you name here.
• --urifile <FILE NAME> — if the port is 0, use this file to read the URI of the TaskJuggler daemon.
• --webserver-port <NUMBER> — use this specific TCP/IP port to serve the web browser requests. Default: 8080.
• -h, --help — show this message. hi. 👋
• --version — show version info.

---

🌈 ENVIRONMENT 🌈

• HOME — the user's home folder. it's used to search for the configuration file when you didn't specify one.

---

🦋 FILES 🦋

.taskjugglerrc or taskjuggler.rc

tj3d goes looking for a config file named .taskjugglerrc or taskjuggler.rc in the current path, in the user's home path as specified by the HOME environment variable, or in /etc/. it's a whole search party. 🔍

at a minimum, the file has to contain:

_global:
  authKey: ********

(the user should specify their own auth key and set the file permissions accordingly, fr fr — that's on you, not on the program 💀).

if you want your config file somewhere else entirely, use the -c, --config FILE option to say so. location freedom, slay. 💅

---

👑 COPYRIGHT 👑

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 ⭐

• tj3d(1)
• The full TaskJuggler manual is available online at http://www.taskjuggler.org/tj3/manual/, or via the tj3man command.

---

and that's the whole page, no notes. now go serve some reports. 🍓🧚

taskjuggler 3.8.1, dated January 2026, out here living its best TJ3WEBD(1) life. bye bestie, mwah 💖