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.
Ces instructions concernent uniquement l’édition open source de FoxDesk installée sur votre propre infrastructure.
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 CloudCe 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.
