Crumb-Core-v.1/QUICKSTART.md

🦉 Crumbforest Quickstart (Native Edition)

"Naked Setup" – Direkte Installation auf Debian/Linux. Kein Docker. Keine Abstraktion. Echte Maschinen.

📦 Voraussetzungen

• Debian 12+ Server
• Root/Sudo Zugriff
• Eine feste IP oder Domain (z.B. via sslip.io)

🚀 Installation in 3 Schritten

1. Repository klonen

cd /opt
git clone https://github.com/YOUR_USER/crumbcrm_crumbcore_v1.git crumbforest
cd crumbforest

2. Native Installer starten

Das Skript erledigt alles: Python venv, MariaDB Setup, Nginx Config & Systemd Services.

sudo ./native_crumbcore_v1/native-install.sh

3. Diagnose & Start

Prüfe, ob der Wald atmet:

sudo ./native_crumbcore_v1/strato_doctor.sh

---

🛠️ Tägliche Arbeit

Updates einspielen

Niemals einfach überschreiben! Nutze den Updater für Backups & Clean Restart:

git pull
sudo ./native_crumbcore_v1/native-update.sh

Logs lesen ("Der Wald spricht")

• Diagnose: sudo ./native_crumbcore_v1/strato_doctor.sh
• Live Logs: sudo journalctl -u crumbforest -f
• Handbuch: native_crumbcore_v1/log_analyse_handbuch.md

Berechtigungen reparieren (Notfall)

Wenn die Eule oder Cache zickt:

sudo ./native_crumbcore_v1/fix_eule.sh

---

💡 Warum Native?

Wir nutzen kein Docker, weil wir lernen wollen.

• Wir wollen sehen, wie systemd einen Service am Leben hält.
• Wir wollen verstehen, wie nginx Requests weiterleitet.
• Wir wollen, dass unsere Logs direkt im Journal landen, nicht in einem Container-Overlay.

Lies native_crumbcore_v1/FIRST_STEPS_FOR_GARDENERS.md für die Philosophie dahinter.

Happy Gardening! 🌲💚