Files
Crumb-Core-v.1/QUICKSTART.md

65 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🦉 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
```bash
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.
```bash
sudo ./native_crumbcore_v1/native-install.sh
```
### 3. Diagnose & Start
Prüfe, ob der Wald atmet:
```bash
sudo ./native_crumbcore_v1/strato_doctor.sh
```
---
## 🛠️ Tägliche Arbeit
### Updates einspielen
Niemals einfach überschreiben! Nutze den Updater für Backups & Clean Restart:
```bash
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:
```bash
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](native_crumbcore_v1/FIRST_STEPS_FOR_GARDENERS.md)** für die Philosophie dahinter.
**Happy Gardening! 🌲💚**