Repository navigation
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, lifecyclebackup/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/9ponCONFIG_DIR; exFAT / WSL mount checks. Host port preflight stays onup/reload(notdoctor) - Notifications (ADR 0012): optional Compose profile
notifications→ Apprise API with loopback host UI;configurewires Radarr/Sonarr Connect (destinations stay manual) — 18 — Notifications - VPN resilience (ADR 0013): Gluetun
HEALTH_*knobs; optional profilevpn-heal(gluetun-monitor+ dedicated POST/EXEC socket-proxy). RequiresFLIXBOX_MODE=vpn. Never auto-switches to Direct — 07 — VPN configure: clears JellyfinLocalNetworkAddresseswhen it is only::(restart/wizard footgun) — Troubleshooting- CLI
--env-file/--project-dirremain 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-healReview .env.example for new HEALTH_* / VPN_HEAL_* comments and profile list.
Security notes
- Homepage continues to use a read-only Docker socket-proxy.
vpn-healadds a separate proxy withPOST/EXEC(container restart/recreate/exec). Leave off unless you need stranded-qBit recovery after Gluetun recreate. PreferFLIXBOX_MODE=vpnonly.- Apprise UI publishes on
127.0.0.1only by default (no app auth). The CLI refuses non-loopbackAPPRISE_BIND_IPwhen enablingnotifications(exit 4). - Assisted
configuremay 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, …)