Auto-hébergement

Docker Compose

Lancez l’édition open source de FoxDesk avec Docker Compose : l’application, MariaDB et les tâches de fond à partir de l’image publiée.

Auto-hébergement

Ces instructions concernent uniquement l’édition open source de FoxDesk installée sur votre propre infrastructure.

Vous utilisez FoxDesk Cloud ?

Les exigences relatives au serveur, à PHP, à la base de données, aux tâches cron, aux sauvegardes et aux mises à jour de cette page ne s’appliquent pas à FoxDesk Cloud.

Essayer FoxDesk Cloud

Ce que Docker Compose démarre

Le dépôt FoxDesk contient un fichier docker-compose.yml avec trois services :

Service Rôle
app Serveur web avec PHP 8.2 et Apache. Publie par défaut le port 8080 sur 127.0.0.1.
cron Exécute chaque minute les tâches de fond : réception des e-mails, tickets récurrents, rappels et rapports planifiés.
db MariaDB 11. Elle n’est pas accessible hors du réseau Compose.

Les fichiers de l’application, config.php, les pièces jointes, le stockage, les sauvegardes et la base de données sont dans des volumes nommés. Ils sont conservés lors des redémarrages et des mises à niveau de l’image.

Démarrer avec l’image publiée

Il vous faut Docker Engine avec le plugin Compose (docker compose).

git clone https://github.com/lukashanes/foxdesk.git
cd foxdesk
cp .env.example .env

Dans .env, renseignez DB_PASSWORD et DB_ROOT_PASSWORD. Sans ces valeurs, Compose refuse de démarrer. Vous pouvez en générer une avec openssl rand -hex 24.

Chaque version est publiée sous forme d’image pour amd64 et arm64 sur GitHub Container Registry. Fixez la version dans .env et démarrez sans construction locale :

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

Remplacez X.Y.Z par la version actuelle indiquée dans la liste des versions. Fixez une version plutôt que latest, afin qu’un redémarrage ne change pas la version de façon inattendue. app et db doivent indiquer healthy.

Pour construire l’image à partir du code source, omettez la ligne FOXDESK_IMAGE et exécutez :

docker compose up -d --build

Lancer l’installateur

Ouvrez http://localhost:8080/install.php et suivez les deux étapes. À l’étape de la base de données, saisissez :

Champ Valeur
Hôte de la base db
Port 3306
Nom de la base DB_NAME de .env (par défaut foxdesk)
Utilisateur DB_USER de .env (par défaut foxdesk)
Mot de passe DB_PASSWORD de .env

L’installateur crée le schéma de la base et écrit config.php dans son propre volume. Il enregistre aussi l’adresse utilisée comme URL de l’application. Si FoxDesk se trouve derrière un proxy inverse, lancez l’installateur depuis l’adresse HTTPS publique.

Placer HTTPS devant l’application

FoxDesk redirige HTTP vers HTTPS pour tous les noms d’hôte sauf localhost et 127.0.0.1. Un déploiement réel nécessite donc un proxy inverse TLS devant le service app. Laissez le port publié sur 127.0.0.1 pour que seul le proxy atteigne le conteneur. Exemple avec Caddy sur l’hôte :

helpdesk.example.com {
    reverse_proxy 127.0.0.1:8080
}

Mises à jour et sauvegardes

Installez les nouvelles versions de FoxDesk avec la mise à jour intégrée dans Admin > Settings > System. Elle sauvegarde d’abord les fichiers et la base, et permet de revenir en arrière en un clic. Pour passer l’image à une version plus récente, modifiez la version dans FOXDESK_IMAGE et relancez les commandes pull et up -d --no-build. Le conteneur sauvegarde la base et les fichiers avant de les mettre à niveau.

Les sauvegardes intégrées ne contiennent ni les pièces jointes ni le stockage. Le guide Docker complet sur GitHub (en anglais) décrit les sauvegardes complètes, la restauration, Traefik et toutes les variables de configuration.