SDBX Seedbox in a Box

scene release // linux // compose // no cloud landlord

Your media stack.
Under your root.

Index. Fetch. Sort. Stream. SDBX turns explicit answers into a digest-pinned seedbox built as a Compose project. No hosted control plane, no SDBX account. Use the Dashboard for quick operations or the CLI for scripting and full command access.

root@localhost:/opt/sdbx tty0 · local session 
root@sdbx:~# install -d -m 0750 /opt/sdbx
root@sdbx:~# cd /opt/sdbx && sdbx init
# read the config. yes, actually read it.
root@sdbx:/opt/sdbx# sdbx up
root@sdbx:/opt/sdbx# sdbx status
./bootstrap choose an interface
  • amd64/first-class
  • arm64/compatible
  • MIT/no DRM
  • zero accounts
SDBX DASHBOARD :: https://sdbx.example.test/ 200 · box online
SDBX dashboard showing project health, running services, stack actions, and registry status
Remote-ready behind Authelia, with your configuration and data kept on your server. loading

registry.entries

— reviewed services

profiles.loaded

— starting points

targets.arch

— amd64 + arm64

source.license

MIT forks welcome

/etc/sdbx/interfaces :: choose your interface

Same server.
Two interfaces.

Both interfaces operate the same .sdbx.yaml, lock, generated Compose project, and local broker checks. Use the Dashboard for quick operations or the CLI for scripting and complete command access.

MODE 01 https://sdbx.example.test/

WEB UI // DASHBOARD

Everything important at a glance.

Open services, check health, inspect logs, and handle routine operations without memorizing commands. The same verified project remains available to the CLI at any time.

  • Authenticate remotely through Authelia as an administrator.
  • Inspect services, health, routes, and bounded logs.
  • Manage addons and typed project settings.
  • Run diagnostics, backups, restores, and stack actions.
  • Read security evidence and the redacted audit trail.
open dashboard
MODE 02 root@sdbx:/opt/sdbx#

CLI // ADVANCED MODE

Complete control from the terminal.

Keyboard-heavy, grep-friendly, and automation-ready. The complete control surface for operators who consider JSON a user interface.

  • Initialize, generate, lock, launch, inspect, and recover.
  • Manage registries, addons, presets, and integrations.
  • Use structured JSON output in scripts and runbooks.
  • Keep every generated file available for diff and review.
drop to tty0
.sdbx.yaml .sdbx.lock compose.yaml same engine // same receipts

/proc/sdbx/workflow :: no cursed black boxes

Trace every hop.
Trust no magic.

Prowlarr, Sonarr, qBittorrent, Gluetun, Jellyfin, Plex: separate services, one inspectable workflow. Open the generated Compose file. Diff it. Break it. You get to keep every piece.

sdbx.nfo :: media workflow generated from v1 registry · no stowaways
  1. 01/indexProwlarr speaks to the indexers you configure.
  2. 02/fetchqBittorrent stays inside Gluetun’s network namespace.
  3. 03/sortSonarr handles the supported TV automation path.
  4. 04/streamJellyfin or Plex serves your suspiciously tidy library.
We automate the connections. You own the box.

Digest-pinned images, generated configuration, supported integrations, and enough logs to explain the blast radius.

tail -f /var/log/sdbx.vibes

/dev/tty0 :: zero YAML speedrun required

Talk to the wizard.
Keep the receipts.

Answer the deployment questions only your box can answer. SDBX does the repetitive wiring, then leaves the generated project where you can grep it.

Answer deployment questions, not YAML trivia.

Domain, access, media server, storage, VPN, automation, and addons.

Guided setup · synthetic values
SDBX setup wizard showing domain, media server, VPN, and automation choices
Feature-true demo · no real credentials Scroll sideways to inspect the full terminal.

DASHBOARD :: WHEN THE VIBES FAIL

Tail the logs.
Find the ghost.

The CLI and Authelia-protected dashboard read the same verified project. Your configuration stays inspectable and there is no hosted control plane between you and your server.

01 / 04

Swipe sideways to inspect the full console capture.

PS(1) :: services runtime / health / routes / logs
SDBX Services view showing running state, health, routes, and log inspection controls
Read every daemon from one instrument panel.
sdbx status --json

Read the instruments.

Service state, health, ports, and bounded logs without jumping between tools.

sdbx addon enable sonarr

Patch intent, not containers.

Enable addons, change validated settings, and regenerate the runtime from one source of truth.

sdbx doctor

Exorcise before `rm -rf`.

Run diagnostics, inspect audit history, and create or restore encrypted backups.

registry://underground/known-good

Known daemons.
No mystery payloads.

Load a profile or pick daemons individually. Bring another registry when the official opinion is too polite for your homelab.

— core building blocks — optional addons — service categories

Loading the product catalog…

~/.config/sdbx/profiles :: pick your poison

Start known-good.
Mutate responsibly.

Minimal box, TV automation, or the full definitely-just-a-Linux-server profile.

EOF :: YOUR SERVER / YOUR BANDWIDTH / YOUR BUSINESS

Large disks.
Zero cloud landlord.

Bring Linux, Docker, disks, and media you are allowed to access. We automate the stack. What enters /media remains between you and your jurisdiction.

./bootstrap-the-box