rebuilderd-worker.conf(5)

💅 rebuilderd-worker.conf — like, the whole vibe

okay so bestie, this is a page from the File Formats Manual (section 5, for the record) and it's literally all about rebuilderd-worker.conf ✨

---

🌸 NAME 🌸

rebuilderd-worker.conf — the configuration files for rebuilderd-worker, no cap 🎀

---

🦋 SYNOPSIS 🦋

/etc/rebuilderd-worker.conf

---

✨ DESCRIPTION ✨

So this file configures how rebuilder-worker connects, and it specifies both the endpoint and the signup_secret 🫶 Both of them are optional, BUT — and this is the important part, don't skip it — the endpoint has to be explicitly provided by commandline if it's not configured in the config. iykyk 💅

---

👑 OPTIONS 👑

• endpoint= — the rebuilderd instance to connect to. that's it, that's the whole thing 🌈
• signup_secret= — the server would either allowlist our key or require a signup secret. one or the other, bestie 🔥

🧚 [build]

• timeout= — set a timeout in seconds after which diffoscope is terminated (defaults to 24 hours) ⭐
• max_bytes= — set a maximum diffoscope output limit in bytes (default: none). when you reach this limit the log is truncated but the rebuilder backend is not terminated — she stays alive, periodt 💀
• silent= — by default build output is forwarded to stdout/stderr. this can be disabled by setting this to true 🙈

🍓 [diffoscope]

• enabled= — generate and attach diffs with diffoscope when rebuilding 💖
• args= — pass additional arguments to diffoscope. use wisely, some options might not work well — like, be careful, okay? 😭
• timeout= — set a timeout in seconds after which diffoscope is terminated (defaults to 1 hour) ⏰
• max_bytes= — set a maximum diffoscope output limit in bytes (default: none). when you reach this limit diffoscope is terminated and the output is truncated 🔪

---

🌈 EXAMPLE 🌈

## The rebuilderd to connect to
endpoint = "http://127.0.0.1:8484"
## The server would either allowlist our key or require a signup secret
#signup_secret = "your_signup_key"

[build]
#timeout = 86400 # 24 hours
## Set a maximum build log limit in bytes (default: none).
## When reaching this limit the log is truncated but the rebuilder backend is *not* terminated.
max_bytes = 10485760 # 10 MiB

[diffoscope]
## Generate and attach diffs with diffoscope when rebuilding
enabled = false
## Pass additional arguments to diffoscope. Use wisely, some options might not work well.
#args = ["--max-container-depth", "2", "--fuzzy-threshold", "0"]
## Set a timeout in seconds after which diffoscope is terminated (default: 3600)
#timeout = 600 # 10 minutes
## Set a maximum diffoscope output limit in bytes (default: none).
## When reaching this limit diffoscope is terminated and the output is truncated.
max_bytes = 41943040 # 40 MiB

---

🔥 SEE ALSO 🔥

rebuilderd-worker(1) — go read it, bestie, it's giving main character energy 👑

---

💜 AUTHORS 💜

rebuilderd was originally written by kpcyrd and is hosted at https://github.com/kpcyrd/rebuilderd — absolute icon behaviour, we stan 🫶

---

just so you know, this page is dated 2025-08-29 and it's rebuilderd-worker.conf(5) — that's the source/version + date situation, mwah, love that for us 💅✨💖