🚀 README: Deploy_Scanner_Nullfeld_to_Core_v0.0
Deployment Infrastructure + SNOOP_MAGIC + lovely_orcas Wisdom
Von: Orca, Snoop, Bugsy & die Crew
Für: Alle, die deployen müssen - mit Stil und ohne Stress
🎯 Was ist Deploy-Scanner?
Orca erklärt: 🐋
"Die Brücke zwischen Repos.
Scanner → Nullfeld → Core.
Deployment as Infrastructure.
Mit SNOOP_MAGIC Protocol!"
Snoop ergänzt: 🦭
"Deployment ist nicht Technik.
Deployment ist CREW MOVE.
Alle arbeiten zusammen.
Das ist SNOOP_MAGIC! ✨"
📦 Was ist drin?
1. 🚀 Deployment-System
Für:
- CrumbScanner (mit Qdrant!)
- Nullfeld (Password-Reset System)
Features:
- Nginx Virtual Hosts
- SSL/HTTPS (Let's Encrypt)
- PHP-FPM Optimization (16GB RAM!)
- Backup/Rollback System
- Deploy-Scripts (Bash)
- Status Monitoring
2. 🦭 SNOOP_MAGIC
Snoop: 🦭
"SNOOP_MAGIC ist mein Protokoll.
Crew Move!
Deployment ist Teamwork.
Nicht allein, sondern zusammen!"
Docs:
- SNOOP_MAGIC.md - Die Magie erklärt
- SNOOP_MAGIC_PROTOCOL.md - Das Crew-Protokoll
3. 🌊 lovely_orcas
Orca: 🐋
"The Wisdom of the Ocean.
Orca & Eule im Kontakt.
Tiefsee-Weisheit für Infrastructure."
Doc:
- lovely_orcas.md 🌊 - Ocean Wisdom
🚀 Quick Start
# 1. Clone
git clone https://194-164-194-191.sslip.io/git/kruemel/Deploy_Scanner_Nullfeld_to_Core_v0.0
cd Deploy_Scanner_Nullfeld_to_Core_v0.0
# 2. Auf Server hochladen
scp -r . root@194.164.194.191:/root/deploy-scanner/
# 3. SSH zum Server
ssh root@194.164.194.191
# 4. Konfigurieren (wichtigste Anpassungen)
cd /root/deploy-scanner
nano scripts/deploy.sh # Zeile 21-27: Pfade & Git-URLs
nano nginx/crumbscanner.conf # Zeile 25: root-Pfad
nano nginx/nullfeld.conf # Zeile 25: root-Pfad
# 5. Deployen!
cd scripts
sudo ./deploy.sh
# 6. Status prüfen
./status.sh
Bugsy: 🐛
"Das war's! 6 Schritte.
Von Clone bis Running.
So soll Deployment sein!"
📂 Package-Inhalt
Deploy_Scanner_Nullfeld_to_Core_v0.0/
│
├── nginx/ # Nginx Virtual Host Configs
│ ├── crumbscanner.conf # CrumbScanner mit SSL, PHP-FPM, Qdrant
│ └── nullfeld.conf # Nullfeld mit SSL, PHP-FPM
│
├── scripts/ # Automatisierung (alle ausführbar!)
│ ├── deploy.sh # ⭐ MAIN: Vollständiges Deployment
│ ├── backup.sh # 💾 Automatisches Backup-System
│ ├── rollback.sh # 🔄 Notfall-Wiederherstellung
│ └── status.sh # 📊 System-Health-Check
│
├── docs/ # Dokumentation
│ ├── README.md # Hauptdokumentation (500+ Zeilen)
│ ├── DEPLOYMENT_GUIDE.md # 🚀 Step-by-Step für Anfänger
│ ├── CHEATSHEET.md # ⚡ Quick Reference
│ ├── FILE_STRUCTURE.md # 📂 Detaillierte File-Beschreibungen
│ ├── MISSING_INFO.md # ❓ Was noch angepasst werden muss
│ ├── START_HERE.md # 🎯 Wo anfangen?
│ │
│ ├── lovely_orcas.md # 🌊 The Wisdom of the Ocean
│ ├── SNOOP_MAGIC.md # 🦭 Die Magie
│ ├── SNOOP_MAGIC_PROTOCOL.md # 🦭✨ Crew Move Protocol
│ │
│ ├── env.example.crumbscanner # ⚙️ Environment-Template
│ ├── env.example.nullfeld # ⚙️ Environment-Template
│ │
│ ├── fix_upload_permissions.sh # 🔧 Permission-Fix
│ ├── user_management.sh # 👥 User-Management
│ └── status.sh # 📊 Status-Script
│
└── UPDATE_v1.1.md # Changelog
Orca: 🐋
"Alles organisiert.
Jede Datei hat einen Zweck.
Das ist Infrastructure as Order!"
⚡ Die 4 Haupt-Scripts
1. 🚀 deploy.sh - Das Herz
Was es macht:
[1/8] System-Abhängigkeiten
→ nginx, php8.2-fpm, mariadb, docker, composer, certbot
[2/8] Git-Projekte klonen/updaten
→ /var/www/crumbscanner
→ /var/www/nullfeld
[3/8] Composer Dependencies
→ composer install (falls composer.json vorhanden)
[4/8] Nginx-Konfiguration
→ Virtual Hosts aktivieren
→ PHP-FPM Integration
[5/8] PHP-FPM Optimierung
→ 50 Worker für 16GB RAM
→ Dynamic PM
[6/8] Datenbanken
→ crumbscanner + nullfeld
→ UTF8MB4 Collation
[7/8] Qdrant Docker
→ Container starten
→ Ports 6333/6334
[8/8] SSL (optional)
→ Let's Encrypt Zertifikate
→ Auto-Renewal
Bugsy: 🐛
"Ein Script, 8 Schritte.
Alles automatisch.
Idempotent = kann mehrfach laufen!"
2. 💾 backup.sh - Die Sicherheit
Features:
- Vollautomatische Backups
- Files + DB + Qdrant
- 30-Tage Rotation
- Timestamped Archives
Usage:
./backup.sh
# Backups liegen in:
/root/backups/backup_2026-01-27_14-30-00.tar.gz
Orca: 🐋
"Ohne Backup kein Deployment.
Das ist Ocean-Weisheit.
Immer Backup BEVOR du änderst!"
3. 🔄 rollback.sh - Der Rettungsanker
Features:
- Interaktives Rollback
- Wähle Backup-Version
- Automatische Wiederherstellung
- Service-Restart
Usage:
./rollback.sh
# Zeigt alle Backups
# Wähle welches du wiederherstellen willst
# Fertig!
Snoop: 🦭
"Fehler passieren.
Rollback ist nicht Scheitern.
Rollback ist LEARNING.
SNOOP_MAGIC erlaubt Fehler!"
4. 📊 status.sh - Der Health-Check
Was es prüft:
- Nginx läuft?
- PHP-FPM läuft?
- MariaDB läuft?
- Docker/Qdrant läuft?
- Disk Space okay?
- Services erreichbar?
Usage:
./status.sh
# Output:
✅ Nginx: Running
✅ PHP-FPM: Running
✅ MariaDB: Running
✅ Qdrant: Running (Docker)
✅ Disk Space: 45% used (OK)
✅ crumbscanner.194-164-194-191.sslip.io: Reachable
✅ nullfeld.194-164-194-191.sslip.io: Reachable
Bugsy: 🐛
"Run das täglich!
Automatisiere es mit Cron!
Monitoring ist PFLICHT!"
🦭 SNOOP_MAGIC Protocol
Snoop erklärt: 🦭
"SNOOP_MAGIC ist KEIN Tech-Protokoll.
Es ist ein CREW-Protokoll.
Die 5 SNOOP-Prinzipien:
1. Crew > Individual
"Deployment ist Teamwork.
Nicht 'ich deploye'.
Sondern 'wir deployen'."
2. Communication > Automation
"Scripts sind gut.
Aber sprich mit der Crew!
Sage BEVOR du deployest."
3. Backup > Deploy
"Erst Backup. Dann Deploy.
IMMER.
Keine Ausnahme."
4. Rollback > Fix
"Fehler? Rollback first.
Dann fix in Ruhe.
Production ist heilig."
5. Learn > Blame
"Fehler passieren.
Lerne daraus.
Blame niemanden.
SNOOP_MAGIC = Safe Space."
Orca: 🐋
"Das ist Infrastructure as Culture.
Nicht nur Tools.
Sondern WIE wir Tools nutzen."
🌊 lovely_orcas Wisdom
Orca: 🐋
"The Ocean teaches Infrastructure.
Tief. Geduldig. Machtvoll."
Die 3 Ocean-Lessons:
1. Depth over Speed
"Orcas tauchen tief.
Deployment braucht Tiefe.
Schnell deployen = Probleme.
Tief deployen = Stabilität."
2. Pod over Solo
"Orcas jagen im Pod.
Nie allein.
Deployment im Team.
SNOOP_MAGIC = Pod-Jagd."
3. Echo over Silence
"Orcas nutzen Echolokation.
Feedback ist essentiell.
Status-Check = Echo.
Monitoring = Sehen im Dunkeln."
Maya-Eule: 🦉
"Orca & Eule im Kontakt.
Tiefsee trifft Wald.
Das ist lovely_orcas.
Wuhuuuuu! 🌊"
✨ Besondere Features
🔐 SSL/HTTPS
Automatische Integration:
- Let's Encrypt
- HTTPS-Redirect
- Auto-Renewal vorbereitet
Setup:
# Im deploy.sh ist SSL optional
# Aktiviere es wenn Domain bereit
sudo certbot --nginx -d crumbscanner.example.com
⚡ PHP-FPM Optimization
Für 16GB RAM:
- 50 Worker (pm.max_children)
- Dynamic Process Manager
- Optimale Performance
Config:
pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 15
Bugsy: 🐛
"Getestet! 16GB = 50 Worker.
Sweet Spot für Performance!"
🐳 Qdrant Docker
Automatisches Setup:
- Docker Container für Qdrant
- Ports 6333 (API) + 6334 (Internal)
- Proxy via Nginx
- Dashboard-Zugriff
URLs nach Deploy:
https://crumbscanner.194-164-194-191.sslip.io/qdrant/
📊 Monitoring
Built-in:
- Real-time Status-Check (status.sh)
- Service-Health
- Disk Space Monitoring
- Log-Aggregation
Erweiterbar:
- Prometheus Integration (Future)
- Grafana Dashboards (Future)
- CrumbMIDI Sonification! (Future) 🎵
📚 Die Dokumentation
Für Anfänger:
START: docs/DEPLOYMENT_GUIDE.md
- Step-by-Step mit Copy-Paste
- Erwartete Ausgaben
- Troubleshooting
Für Profis:
START: docs/CHEATSHEET.md
- Alle Commands auf einen Blick
- Quick-Debugging
- One-Liner Collection
Für Vollständigkeit:
START: docs/README.md
- Komplette Feature-Beschreibung (500+ Zeilen)
- Performance-Tuning
- Security Best Practices
Für Navigation:
START: docs/START_HERE.md
- Wo anfangen?
- Workflow-Diagramme
- Quick-Help
Orca: 🐋
"4 Docs für 4 Personas.
Jeder findet seinen Einstieg.
Das ist lovely_orcas Design!"
❓ Was du noch anpassen musst
Siehe: docs/MISSING_INFO.md
Minimum (3 Stellen):
1. scripts/deploy.sh → Zeile 21-27 (Pfade, Git-URLs)
2. nginx/*.conf → Zeile 25 (root-Pfad)
3. nginx/*.conf → Zeile 49-50 (PHP-FPM Socket/TCP)
Das war's! Alles andere ist optional.
Bugsy: 🐛
"3 Anpassungen.
Rest läuft automatisch.
Zero-Config Philosophie!"
🎯 Nach dem Deployment
Deine Sites sind live:
🌐 https://crumbscanner.194-164-194-191.sslip.io
🌐 https://nullfeld.194-164-194-191.sslip.io
Wichtige Commands:
cd /root/deploy-scanner/scripts
./status.sh # System-Check
./backup.sh # Backup erstellen
./rollback.sh # Im Notfall!
Logs checken:
tail -f /var/log/nginx/crumbscanner_error.log
tail -f /var/log/nginx/nullfeld_error.log
Snoop: 🦭
"Nach Deploy: Status-Check!
IMMER.
Das ist SNOOP_MAGIC Rule #1!"
🔒 Security (Built-in)
Alle Scripts enthalten:
✅ Security Headers
✅ Git-Verzeichnis Schutz (.git blocked)
✅ Hidden-Files Schutz (.env, .htaccess blocked)
✅ SSL Best Practices
✅ XSS/CSRF Protection
✅ Rate Limiting (vorbereitet)
Orca: 🐋
"Security ist DEFAULT.
Nicht optional.
Ocean-Weisheit!"
🐛 Troubleshooting
Deployment schlägt fehl?
# Siehe: docs/DEPLOYMENT_GUIDE.md → "Troubleshooting"
# Quick-Check:
sudo systemctl status nginx
sudo systemctl status php8.2-fpm
sudo systemctl status mariadb
Website nicht erreichbar?
# Siehe: docs/CHEATSHEET.md → "Debugging"
# Quick-Test:
curl http://localhost
curl https://crumbscanner.194-164-194-191.sslip.io
Rollback nötig?
./scripts/rollback.sh
# Wähle Backup
# Fertig!
Bugsy: 🐛
"Wenn alles versagt:
Rollback.
Fix in Ruhe.
Dann redeploy.
Keine Panik!"
💡 Pro-Tipps
1. CHEATSHEET ausdrucken
"Und neben Monitor legen!"
- FunkFox 🦊
2. Backups automatisieren
crontab -e
# Täglich um 3 Uhr morgens:
0 3 * * * /root/deploy-scanner/scripts/backup.sh
3. Status-Check regelmäßig
# Alle 5 Minuten? Warum nicht!
*/5 * * * * /root/deploy-scanner/scripts/status.sh >> /var/log/deploy-status.log
4. Logs monitoren
# Terminal-Multiplexer (tmux/screen)
# Ein Pane pro Logfile
tail -f /var/log/nginx/*.log
Orca: 🐋
"Monitoring ist nicht Feature.
Monitoring ist ROUTINE.
Wie Orcas die Tiefe checken!"
🌟 Highlights
✅ Zero-Config → Scripts funktionieren out-of-the-box
✅ Production-Ready → Alle Best Practices implementiert
✅ Well-Documented → 6+ Docs (>1500 Zeilen)
✅ Idempotent → Scripts können mehrfach laufen
✅ Safe → Backup-System vor kritischen Ops
✅ Tested → Debian 12 + Ubuntu 20.04+
✅ SNOOP_MAGIC → Crew-Protocol inklusive! 🦭
✅ lovely_orcas → Ocean Wisdom! 🌊
Snoop & Orca: 🦭🐋
"Das ist nicht nur Deployment.
Das ist Infrastructure as Art!"
💚 Crew-Stimmen
Orca (Ocean Wisdom): 🐋
"Deployment ist wie Tauchen.
Vorbereitung ist alles.
Tief = Stabil.
Pod = Crew.
Echo = Monitoring."
Snoop (SNOOP_MAGIC): 🦭
"Crew Move > Solo Act.
Communication > Automation.
Backup > Deploy.
Rollback > Fix.
Learn > Blame."
Bugsy (Pragmatismus): 🐛
"3 Anpassungen. Deploy. Fertig.
Das ist wie es sein soll!"
DeepBit (Architektur): 🎺
"Nginx + PHP-FPM + MariaDB + Qdrant.
Classic LAMP + Modern Vector DB.
Best of Both Worlds!"
FunkFox (Flow): 🦊
"Deployment hat Rhythmus:
Clone → Config → Deploy → Check.
Smooth wie 128 BPM!"
Maya-Eule (Weisheit): 🦉
"Orca & Eule im Kontakt.
Tiefsee trifft Wald.
Das ist Infrastruktur-Harmonie.
Wuhuuuuu! 🌊"
🧩 Die Puzzle-Verbindung
Orca: 🐋
"Deploy-Scanner ist die BRÜCKE."
Verbindungen:
Deploy-Scanner ←→ CrumbScanner (Deployed Service)
↓
Deploy-Scanner ←→ PWD_NULLFELD (Deployed Service)
↓
Deploy-Scanner ←→ Crumb-Core (Integration Target)
↓
Deploy-Scanner ←→ Infrastructure (Server, Nginx, DB)
Allein: Deployment-Tool
Zusammen: Infrastructure-Glue 🌲
📈 Roadmap
v1.1 (Next):
- [ ] Prometheus Integration
- [ ] Grafana Dashboards
- [ ] CrumbMIDI Sonification (Deployment-Sounds!)
- [ ] Multi-Server Support
- [ ] Docker Compose Alternative
- [ ] Kubernetes Manifests (?)
Snoop: 🦭
"Aber nur wenn Crew es braucht.
Nicht Features for Features.
SNOOP_MAGIC = Need-Based!"
🦉 Fazit
Orca & Snoop zusammen: 🐋🦭
"Deploy-Scanner ist mehr als Scripts.
Es ist Infrastructure Philosophy.SNOOP_MAGIC = Crew-Protocol.
lovely_orcas = Ocean-Wisdom.
Zusammen = Deployment with Heart.Nicht schnell deployen.
Sondern GUT deployen.
Tief. Im Pod. Mit Echo.Das ist Deploy-Scanner. 💚"
📚 Weitere Dokumentation
Im Repo:
- DEPLOYMENT_GUIDE.md - Step-by-Step
- CHEATSHEET.md - Quick Reference
- FILE_STRUCTURE.md - Architektur
- MISSING_INFO.md - Was anpassen
- START_HERE.md - Navigation
- lovely_orcas.md - Ocean Wisdom 🌊
- SNOOP_MAGIC.md - Die Magie 🦭
- SNOOP_MAGIC_PROTOCOL.md - Crew Protocol
Im Crumbforest:
- STERNENKARTE.md - Alle Repos
- VOM_KABEL_ZUR_CREW.md - Infrastructure erklärt
- DAS_ABBILD.md - Zustand > Zeit
🔗 Links
Repository: https://194-164-194-191.sslip.io/git/kruemel/Deploy_Scanner_Nullfeld_to_Core_v0.0
CrumbScanner: https://194-164-194-191.sslip.io/git/kruemel/crumbscanner_pepperPHP_init
PWD_NULLFELD: https://194-164-194-191.sslip.io/git/kruemel/PWD_NULLFELD_RESET-v.0.0
Geschrieben von: Orca, Snoop, Bugsy, DeepBit & die Crew
Für: Alle die deployen - mit Stil und Crew-Love
Version: v1.0
Status: Production-Ready 🟢
Lizenz: Internal Project
#deployment #snoop_magic #lovely_orcas #infrastructure #crewmove 🦭🐋💚
🚀 Deploy
↓
💾 Backup (first!)
↓
🔄 If Error: Rollback
↓
📊 Status Check
↓
✅ Success
Deployment as Crew Move.
SNOOP_MAGIC Protocol.
lovely_orcas Wisdom.
🦭🐋 Snoop & Orca approve.