Docker Compose
Starten Sie die Open-Source-Version von FoxDesk mit Docker Compose: Anwendung, MariaDB und Hintergrunddienst aus dem fertigen Image.
Diese Anleitung gilt ausschließlich für die Open-Source-Version von FoxDesk, die Sie auf Ihrer eigenen Infrastruktur betreiben.
Die Anforderungen an Server, PHP, Datenbank, Cronjobs, Backups und Updates auf dieser Seite gelten nicht für FoxDesk Cloud.
FoxDesk Cloud testenWas Docker Compose startet
Das FoxDesk-Repository enthält eine docker-compose.yml mit drei Diensten:
| Dienst | Aufgabe |
|---|---|
app |
Webserver mit PHP 8.2 und Apache. Veröffentlicht standardmäßig Port 8080 auf 127.0.0.1. |
cron |
Führt einmal pro Minute die Hintergrundaufgaben aus: E-Mail-Abruf, wiederkehrende Tickets, Erinnerungen und geplante Berichte. |
db |
MariaDB 11. Außerhalb des Compose-Netzwerks nicht erreichbar. |
Anwendungsdateien, config.php, Uploads, Speicher, Backups und die Datenbank liegen in benannten Volumes und bleiben bei Neustarts und Image-Upgrades erhalten.
Mit dem fertigen Image starten
Sie benötigen Docker Engine mit dem Compose-Plugin (docker compose).
git clone https://github.com/lukashanes/foxdesk.git
cd foxdesk
cp .env.example .env
Setzen Sie in .env die Werte DB_PASSWORD und DB_ROOT_PASSWORD. Ohne sie startet Compose nicht. Einen Wert erzeugen Sie zum Beispiel mit openssl rand -hex 24.
Jedes Release wird als Image für amd64 und arm64 in der GitHub Container Registry veröffentlicht. Legen Sie die Version in .env fest und starten Sie ohne lokalen Build:
echo "FOXDESK_IMAGE=ghcr.io/lukashanes/foxdesk:X.Y.Z" >> .env
docker compose pull app cron
docker compose up -d --no-build
docker compose ps
Ersetzen Sie X.Y.Z durch die aktuelle Version aus der Release-Liste. Verwenden Sie eine feste Version statt latest, damit ein Neustart das Release nicht unerwartet ändert. app und db sollten healthy melden.
Wenn Sie das Image lieber aus dem Quellcode bauen, lassen Sie die Zeile mit FOXDESK_IMAGE weg und führen Sie aus:
docker compose up -d --build
Installationsassistenten ausführen
Öffnen Sie http://localhost:8080/install.php und durchlaufen Sie die beiden Schritte. Im Datenbankschritt tragen Sie ein:
| Feld | Wert |
|---|---|
| Datenbank-Host | db |
| Port | 3306 |
| Datenbankname | DB_NAME aus .env (Standard foxdesk) |
| Datenbankbenutzer | DB_USER aus .env (Standard foxdesk) |
| Passwort | DB_PASSWORD aus .env |
Der Assistent legt das Datenbankschema an und schreibt config.php in ein eigenes Volume. Er speichert außerdem die verwendete Adresse als Anwendungs-URL. Läuft FoxDesk hinter einem Reverse Proxy, rufen Sie den Assistenten über die öffentliche HTTPS-Adresse auf.
HTTPS vorschalten
FoxDesk leitet HTTP für alle Hostnamen außer localhost und 127.0.0.1 auf HTTPS um. Ein produktiver Betrieb braucht deshalb einen TLS-Reverse-Proxy vor dem Dienst app. Lassen Sie den Port auf 127.0.0.1, damit nur der Proxy den Container erreicht. Beispiel für Caddy auf dem Host:
helpdesk.example.com {
reverse_proxy 127.0.0.1:8080
}
Updates und Backups
Installieren Sie neue FoxDesk-Releases mit dem Updater in der Anwendung unter Admin > Settings > System. Er sichert vorher Dateien und Datenbank und bietet eine Wiederherstellung mit einem Klick. Um das Image auf ein neueres Release zu bringen, ändern Sie die Version in FOXDESK_IMAGE und führen dieselben Befehle pull und up -d --no-build aus. Der Container sichert Datenbank und Dateien, bevor er sie aktualisiert.
Die Backups aus der Anwendung enthalten weder Uploads noch den Speicher. Vollständige Backups, Wiederherstellung, Traefik und alle Konfigurationsvariablen beschreibt die ausführliche Docker-Anleitung auf GitHub (Englisch).
