XED /CCC — cBOX@ /Container Control

Bash-Bootstrap und Werkzeuge für nested LXC-Stacks auf Proxmox VE 9 mit Debian 13 / Ubuntu 24.04+.

Status: Stufe 1 — firstboot.sh v0.7.0 (DE/EN-TUI, idempotent, ccc-Self-Install) + ccc v0.0.1 (Python-Skelett) Lizenz: MIT Distribution: https://ccc.xed.dev (Bash) · https://pypi.org/project/xed-ccc/ (Python)

Schnellstart

In jeder frischen Debian/Ubuntu-LXC-Box als root:

# Pre-Step (minimal-LXC-Templates haben kein curl vorinstalliert):
apt update && apt install -y curl ca-certificates

# firstboot.sh ausführen:
bash <(curl -s https://ccc.xed.dev/firstboot.sh)

Oder als One-Liner:

apt-get update -qq && apt-get install -y -qq --no-install-recommends curl ca-certificates && bash <(curl -s https://ccc.xed.dev/firstboot.sh)

Das setzt Zeitzone, Locales, Default-Editor und Basis-Pakete — alles via Whiptail-TUI im Debian-Installer-Stil. Idempotent: kann beliebig oft wiederholt werden.

UX-Pattern (seit v0.5.0)

• Sechs-Phasen-State-Machine mit <Zurück>-Button: Sprache → Zeitzone → Locales → Default-Locale → Pakete → Übersicht. Im ersten Dialog ist Cancel = Abort-Confirmation, sonst Cancel = zurück zur vorherigen Phase.
• DE/EN-Sprachwahl als allererster Dialog. Alle weiteren Whiptail-Texte sind übersetzt; info/ok/err-Logs bleiben deutsch.
• Idempotente Pre-Selection beim Re-Run:
  • Locales: drei-wertige Erkennung via /etc/locale.gen (ACTIVE/DISABLED/ABSENT). User-Wille wird respektiert — abgewählte Locales kommen nicht als Default-ON wieder.
  • Pakete: Marker-Datei /var/lib/xed-ccc/firstboot.applied trennt allerersten Run (Skript-Defaults greifen) vom Re-Run (nur dpkg-Ist-Zustand zählt).
• Deselect = Uninstall/Disable: bei Pakete mit Yesno-Confirmation (Daten-Verlust-Schutz), bei Locales ohne (reversibel).
• Optionaler apt dist-upgrade + autoremove + autoclean-Schritt am Ende, nur wenn Updates verfügbar sind. Yesno-Prompt im interaktiven Modus, ENV DIST_UPGRADE=yes für Auto-Run.

Non-Interactive (CI / Auto-Provisioning)

TZ=UTC \
  LOCALES="de_AT.UTF-8 en_US.UTF-8" \
  DEFAULT_LOCALE=de_AT.UTF-8 \
  PKGS="htop curl wget sudo psmisc net-tools iproute2 iputils-ping gnupg nano" \
  bash <(curl -s https://ccc.xed.dev/firstboot.sh)

TTY-Hinweis

bash <(curl -s URL) (Process Substitution) bewahrt das TTY und erlaubt interaktive Whiptail-Dialoge. curl URL | bash (klassische Pipe) verbraucht stdin und erzwingt Non-Interactive-Mode mit ENV-Defaults.

Was firstboot.sh tut

Bewusst nicht enthalten: Bridge-/iptables-/nested-LXC-Setup. Das kommt mit lxc-host-setup.sh (Skript 2/3, geplant) als separates Skript für cBOX-Outer-Container.

Phase 2 — ccc (Python-Tool, ab v0.0.1)

Nach firstboot.sh kommt das Python-Tool für Rollen-Konfiguration — Pendant zu pct aus Proxmox, aber innerhalb der LXC-Box laufend.

Installation (zwei Wege)

# Variante A — automatisch via firstboot.sh Phase 7 (empfohlen für frische Boxen):
#   firstboot.sh fragt nach ccc-Installation, klont Repo nach /opt/xed-ccc/,
#   baut venv und symlinkt /usr/local/bin/ccc in einem Schritt.

# Variante B — PyPI (für SysOps die Python kennen, bestehende Boxen):
pipx install xed-ccc      # isolierte Tool-Installation (empfohlen)
pip install xed-ccc       # System-Python (mit pep668-bypass)

Updates (nach Erst-Installation):

# Variante A — firstboot.sh Re-Run (Phase 7 macht fetch+reset im /opt/xed-ccc/):
bash <(curl -s https://ccc.xed.dev/firstboot.sh)

# Variante B — pipx-Pfad:
pipx upgrade xed-ccc

# Geplant — Self-Update als Python-Verb:
ccc update

Verben (analog pct)

ccc list                  # verfügbare Rollen mit Status
ccc create pmDESK         # Rolle in aktueller Box installieren
ccc create pmDESK --dry-run  # nur Plan zeigen
ccc menu                  # interaktive TUI (Stub, Textual kommt später)
ccc --version
ccc --help

Rollen-Roadmap

Roadmap

Architektur und Designentscheidungen: siehe WHITEPAPER.md im Entwicklungs-Workspace (privat).

Designprinzipien

• Vertrautheit > Eleganz — ccc ≈ pct semantisch, ccc-tui ≈ Proxmox-Webinterface
• Drei-Skripte-Modell statt Universal-Skript mit Modus-Switch
• Idempotenz (mailinabox-Stil) — curl ... | bash jederzeit wiederholbar
• Kaizen — kleine Schritte, ausprobieren statt endlos planen
• Bash für einmalige Setups, Python für wachsende Werkzeuge

Lizenz

MIT — siehe LICENSE.