Démarrer

Installation

Une machine Linux avec Docker suffit. Pour une équipe de dix agents, deux cœurs et 4 Go de mémoire tiennent sans effort.

Prérequis

Docker 24 ou plus récent, avec le plugin compose
Un nom de domaine pointant vers la machine, et le port 443 ouvert
PostgreSQL 16 et Redis 7 (fournis par le compose si vous n'en avez pas)
Un stockage S3 ou MinIO pour les pièces jointes

1. Récupérer le dépôt

git clone https://github.com/open-helpdesk/core.git
cd core
cp .env.example .env

2. Renseigner les variables

APP_URL=https://aide.votredomaine.fr
DATABASE_URL=postgres://ohd:motdepasse@postgres:5432/ohd
REDIS_URL=redis://redis:6379
SECRET_KEY=  # openssl rand -hex 32
S3_ENDPOINT=https://s3.fr-par.scw.cloud
S3_BUCKET=ohd-fichiers
MAIL_INBOUND=imap  # ou webhook
MAIL_SMTP_URL=smtp://utilisateur:motdepasse@smtp.votredomaine.fr:587

Ne laissez pas SECRET_KEY vide : les jetons de session et les liens de fichiers en dépendent. Changer cette valeur déconnecte tout le monde.

3. Démarrer

docker compose up -d
docker compose exec app ohd migrate
docker compose exec app ohd create-admin --email vous@votredomaine.fr

Les migrations s'appliquent aussi automatiquement au démarrage. La commande est là pour les mises à jour surveillées.

4. Reverse proxy

Le conteneur écoute sur le port 3000 en HTTP. Exemple avec Caddy :

aide.votredomaine.fr {
  reverse_proxy localhost:3000
}

Sauvegardes

Sauvegardez la base et le bucket de fichiers. Une restauration testée vaut mieux qu'une sauvegarde jamais ouverte : rejouez le dump sur une machine de test une fois par trimestre.

docker compose exec postgres pg_dump -U ohd ohd | gzip > ohd-$(date +%F).sql.gz

Mise à jour

git pull
docker compose pull
docker compose up -d

Lisez les notes de version avant de passer une version majeure : elles signalent les changements de configuration à faire avant le redémarrage.