TeddyTafForge — Proxmox VE LXC Helper

Ein-Kommando-Deployment von TeddyTafForge — optional zusammen mit TeddyCloud — als unprivilegierter LXC-Container auf Proxmox VE.

Was ist das?

TeddyTafForge ist eine Web-Oberflaeche zum Bauen eigener Tonie-Audiodateien (.taf) fuer eine Toniebox. Es laeuft neben TeddyCloud (dem quelloffenen Toniebox-Server): TafForge uebernimmt Audio-Import, Kapitel-Bearbeitung und TAF-Encoding; TeddyCloud liefert die Dateien an die Box und stellt die Admin-UI. Man braucht beide Teile — dieser Helper installiert sie wahlweise gemeinsam in einem LXC oder TafForge als Sidecar zu einer bestehenden TeddyCloud.

Kernfeatures

• Ein Curl-Befehl auf dem Proxmox-Host erzeugt einen fertigen LXC (interaktive whiptail-Dialoge).
• Zwei Installations-Scopes: sidecar (nur TafForge) oder all-in-one (TafForge + TeddyCloud im selben LXC).
• Unprivilegierter LXC per Default, nur nesting=1,keyctl=1 als Features.
• Native TeddyCloud-Build aus dem Quellcode (kein Docker-in-LXC) im all-in-one-Modus.
• Vendored Installer-Stack unter vendor/tafforge-install/ — der Wrapper laeuft ohne separaten Fetch; nur der App-Quellcode wird zur Installationszeit vom GitHub-Mirror geklont.
• DEBUG=1-Modus mit vollstaendigem bash -x-Trace auf dediziertem FD und [DBG …]-Checkpoints.
• Bind-Mount der TeddyCloud-Daten im Sidecar-Modus (als mp0, backup=0).
• CI auf Forgejo: shellcheck + bashate + Syntax-Check + Dry-Run-Smoke-Test.

Navigation

• Architecture — Komponenten, Datenfluss und Mermaid-Diagramm
• Setup — Installation, Update, Entwicklung und CI

Was der Helper NICHT tut

• Kein LXC-Backup (das ist vzdump / Proxmox Backup Server).
• Keine TLS-Terminierung (Reverse-Proxy davorstellen).
• Kein Auto-Update (bewusst manuell).
• Kein Monitoring.

Quelle: README.md, ct/teddytafforge.sh, install/*.sh im Repo.