8c9a40780a
All checks were successful
Docker Build & Push / build-and-push (push) Successful in 1m44s
70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# Cazubu - Dein Cannabis Zucht Buddy 🌱
|
|
|
|
Cazubu ist eine moderne Webanwendung zur Verwaltung und Überwachung deiner Cannabis-Zucht ("Homegrow"). Sie hilft dir, den Überblick über Pflanzen, Inventar, Samen und Umweltbedingungen zu behalten.
|
|
|
|
|
|
|
|
## Funktionen 🚀
|
|
|
|
* **Pflanzenverwaltung:** Lebenszyklus, Details, Bildergalerie, Aktivitäten-Log.
|
|
* **Sensor-Überwachung:** Live-Daten (Temp/Feuchte) & Historie (24h/7d/30d).
|
|
* **Inventar & Samenbank:** Zonen, Gefäße, Genetik-Datenbank.
|
|
* **Dashboard:** Alles auf einen Blick.
|
|
|
|
---
|
|
|
|
## Installation & Betrieb 🛠️
|
|
|
|
Dieses Projekt ist für den Betrieb als Docker-Container ausgelegt. Es bietet eine **automatische Datenbank-Initialisierung** beim ersten Start.
|
|
|
|
### 1. Voraussetzungen
|
|
* Docker Engine
|
|
* Eine laufende MySQL/MariaDB Datenbank (extern oder als separater Container)
|
|
|
|
### 2. Container starten (Docker CLI)
|
|
|
|
Der Container prüft beim Start automatisch, ob die Datenbanktabellen existieren. Wenn nicht, wird die Struktur angelegt und ein Standard-Benutzer erstellt.
|
|
|
|
Verwende diesen Befehl, um den Container zu starten. Passe die Werte für `DB_SERVER`, `DB_USERNAME`, `DB_PASSWORD` und `DB_NAME` an deine Umgebung an.
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name cazubu \
|
|
--restart unless-stopped \
|
|
-p 8080:80 \
|
|
-e DB_SERVER="192.168.1.100" \
|
|
-e DB_USERNAME="cazubu_user" \
|
|
-e DB_PASSWORD="dein_sicheres_passwort" \
|
|
-e DB_NAME="cazubu_db" \
|
|
-v cazubu_uploads:/var/www/html/uploads \
|
|
172.30.1.213/admin/cazubu:latest
|
|
```
|
|
|
|
**Wichtig:** Das Volume `-v cazubu_uploads:/var/www/html/uploads` ist notwendig, damit hochgeladene Bilder bei einem Update nicht verloren gehen!
|
|
|
|
### Umgebungsvariablen
|
|
|
|
| Variable | Beschreibung | Standard |
|
|
|----------|--------------|----------|
|
|
| `DB_SERVER` | IP oder Hostname des Datenbankservers | `172.30.242.130` |
|
|
| `DB_USERNAME` | Datenbank-Benutzer | `cazubu` |
|
|
| `DB_PASSWORD` | Datenbank-Passwort | (intern) |
|
|
| `DB_NAME` | Name der Datenbank | `cazubu` |
|
|
|
|
---
|
|
|
|
## Bedienung 📖
|
|
|
|
* **Login:** `testnutzer` / `Start123!` (Wird automatisch bei Erstinstallation erstellt)
|
|
* **Passwort ändern:** Bitte ändere das Passwort sofort nach dem ersten Login unter "Profil".
|
|
|
|
### Sensoren verbinden 🌡️
|
|
|
|
Jeder Benutzer hat einen eigenen API-Key (siehe "Profil").
|
|
Sende Sensordaten per HTTP GET Request an:
|
|
|
|
```
|
|
http://DEINE-IP/api.php?apikey=DEIN_KEY&pflanze=ID&sensor=temp&wert=24.5
|
|
```
|
|
|
|
*(API-Key findest du im Profil, Pflanzen-ID in der Detailansicht)* |