Skip to content

Flixbox v0.2.0

Latest

Choose a tag to compare

@aleaz aleaz released this 19 Sep 03:42

Flixbox v0.2.0 — release notes

Status: Published — GitHub Release (v0.2.0).
Tag: v0.2.0
Baseline: builds on v0.1.1

Highlights

  • CLI contract (ADR 0021): version, doctor, status --json, lifecycle backup / restore / update, recyclarr sync / sync-profiles, bash/zsh completions, exit taxonomy 2–6 on operator paths, global --no-color
  • Doctor FS guards: hardlink probe on DATA_DIR; refuse NFS/SMB/9p on CONFIG_DIR; exFAT / WSL mount checks. Host port preflight stays on up / reload (not doctor)
  • Notifications (ADR 0012): optional Compose profile notifications → Apprise API with loopback host UI; configure wires Radarr/Sonarr Connect (destinations stay manual) — 18 — Notifications
  • VPN resilience (ADR 0013): Gluetun HEALTH_* knobs; optional profile vpn-heal (gluetun-monitor + dedicated POST/EXEC socket-proxy). Requires FLIXBOX_MODE=vpn. Never auto-switches to Direct — 07 — VPN
  • configure: clears Jellyfin LocalNetworkAddresses when it is only :: (restart/wizard footgun) — Troubleshooting
  • CLI --env-file / --project-dir remain out of scope (one stack per checkout). Digest pins stay advanced/optional (version tags are the default UX)

Upgrade from v0.1.1

git pull
./bin/flixbox update          # pull pinned tags + reconcile
# Optional:
./bin/flixbox up notifications
# VPN mode only:
./bin/flixbox up vpn-heal

Review .env.example for new HEALTH_* / VPN_HEAL_* comments and profile list.

Security notes

  • Homepage continues to use a read-only Docker socket-proxy.
  • vpn-heal adds a separate proxy with POST/EXEC (container restart/recreate/exec). Leave off unless you need stranded-qBit recovery after Gluetun recreate. Prefer FLIXBOX_MODE=vpn only.
  • Apprise UI publishes on 127.0.0.1 only by default (no app auth). The CLI refuses non-loopback APPRISE_BIND_IP when enabling notifications (exit 4).
  • Assisted configure may create a temporary opaque public ntfy seed (${CONFIG_DIR}/apprise/.flixbox-seed-url) so *arr Connect Test works — replace destinations before trusting events.

Docs

  • English canonical user guide; Spanish mirror updated for notifications / VPN heal / CLI.
  • Image pins: 14 — Image pins

Explicitly not in this release

  • Global -q/-v, fish completions
  • CLI --env-file / --project-dir
  • Default digest (@sha256:) pins
  • v0.3 media profiles (SABnzbd, Lidarr, …)