Self-hosted

Docker Compose

Starten Sie die Open-Source-Version von FoxDesk mit Docker Compose: Anwendung, MariaDB und Hintergrunddienst aus dem fertigen Image.

Self-hosted

Diese Anleitung gilt ausschließlich für die Open-Source-Version von FoxDesk, die Sie auf Ihrer eigenen Infrastruktur betreiben.

Nutzen Sie FoxDesk Cloud?

Die Anforderungen an Server, PHP, Datenbank, Cronjobs, Backups und Updates auf dieser Seite gelten nicht für FoxDesk Cloud.

FoxDesk Cloud testen

Was 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).