TIREX-MASTER(1)

📦
version 0.8.0 · 8 versions
, in ubuntu stonking

💖 TIREX-MASTER 💖

okay bestie, so this is the tirex-master page from the User Contributed Perl Documentation section of the manual — it's the manpage for the tirex master daemon and honestly it's giving ✨load balancer energy✨ but for map tiles. let's get into it 🫶

🌸 SYNOPSIS 🌸

tirex-master [OPTIONS]

that's it. that's the whole vibe. no positional args, just options, periodt 💅

✨ OPTIONS ✨

  • -h, --help — shows you the help message. the "hi bestie what do you need" button 🎀
  • -d, --debug — runs in debug mode. you'll literally see the actual messages being sent and received, plus other debug messages. it's giving main character energy but for log output 👑
  • -f, --foreground — runs in the foreground. super useful when something like a systemd service is the one starting it up 🙈
  • -c, --config=DIR — use the config directory DIR instead of /etc/tirex. your config, your rules, no cap 🦋

🌈 DESCRIPTION 🌈

so the tirex master process is the one that gets requests for metatiles from mod_tile and other sources, queues them all up, and then ships them off to the rendering backends. it has a whole sophisticated queueing and rendering manager that decides what gets rendered when. literally the girlboss of tile scheduling, she's got a plan and she's sticking to it ⭐

heads up bestie: unless you pass the --debug option, tirex-master will detach from the terminal. so don't be confused when it looks like nothing happened — she just left the chat 💀

🎀 FILES 🎀

  • /etc/tirex/tirex.conf — the configuration file. the sacred text 📜
  • /etc/tirex/renderer/*.conf — the renderer configuration files.
  • /etc/tirex/renderer/*/*.conf — the map configuration files. yes, nested, we love a directory tree 🧚
  • /var/log/tirex/jobs.log — default location for the jobs logfile. it contains one line for each metatile rendered. one line per metatile, no notes, just receipts 💅

💜 SEE ALSO 💜

see the tirex-send manpage for the list of commands you can send to a running tirex-master. (yes, you can talk to her while she's working, she's very responsive 🫶)

<http://wiki.openstreetmap.org/wiki/Tirex>

🌸 AUTHORS 🌸

Frederik Ramm <frederik.ramm@geofabrik.de>, Jochen Topf <jochen.topf@geofabrik.de> and possibly others.

and that's the whole page babes 💖 this was perl v5.40.1, dated 2026-08-09, and it's the TIREX-MASTER(1) page — go render some tiles, ily, bye 👑✨

📦 where this page comes from