OpenProject sur VPS : Gantt, jalons et suivi d'heures

• Gantt interactif avec dépendances entre tâches et chemin critique
• Suivi du temps par tâche et par projet, exportable en CSV pour la facturation
• Jalons et livrables contractuels attachés à la roadmap
• Wiki intégré pour la documentation projet, sans outil tiers
• Gestion des versions et releases pour les projets logiciels
• Contrôle d'accès granulaire par rôle (lecteur, contributeur, chef de projet, administrateur)
• Licence GPLv3 : le code source est auditable et aucune télémétrie n'est imposée

OpenProject, Plane et Kaneo : trois outils, trois positionnements

Comparatif

Faites défiler le tableau

1. 01

   Préparer le VPS

   Connectez-vous en SSH, mettez à jour les paquets et installez Docker avec le plugin Compose : apt update && apt install -y docker.io docker-compose-plugin. Vérifiez l'installation avec docker compose version (v2.x attendu).

2. 02

   Récupérer le Compose officiel

   Clonez le dépôt de déploiement officiel : git clone https://github.com/opf/openproject-deploy.git /opt/openproject && cd /opt/openproject/compose. Ce dépôt maintient le fichier docker-compose.yml et le fichier d'environnement .env recommandés par l'équipe OpenProject.

3. 03

   Configurer les variables d'environnement

   Copiez l'exemple : cp .env.example .env puis éditez .env. Les variables obligatoires sont : OPENPROJECT_HOST__NAME=votre-domaine.com (double underscore), OPENPROJECT_HTTPS=true, et SECRET_KEY_BASE généré par openssl rand -hex 64. Définissez aussi POSTGRES_PASSWORD et OPENPROJECT_DB_PASSWORD avec la même valeur forte.

4. 04

   Démarrer les conteneurs

   Lancez docker compose up -d. L'image openproject/community:latest télécharge environ 600 Mo. Le premier démarrage prend deux à quatre minutes le temps que les migrations de base de données s'exécutent. Surveillez avec docker compose logs -f web jusqu'à voir la ligne Listening on tcp://0.0.0.0:8080.

5. 05

   Vérifier que l'application répond

   Depuis le VPS : curl -s -o /dev/null -w "%{http_code}" http://localhost:8080. Un code 200 ou 302 confirme que l'application est en ligne. À ce stade elle est accessible uniquement en local — le reverse proxy nginx suivra à l'étape suivante.

1. 06

   Installer nginx et certbot

   Sur Debian/Ubuntu : apt install -y nginx certbot python3-certbot-nginx. Assurez-vous que le DNS de votre domaine pointe vers l'IP du VPS avant de continuer.

2. 07

   Créer le vhost nginx

   Créez /etc/nginx/sites-available/openproject avec le contenu suivant : server { listen 80; server_name votre-domaine.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-Proto https; proxy_read_timeout 120s; client_max_body_size 100M; } }. Activez le site : ln -s /etc/nginx/sites-available/openproject /etc/nginx/sites-enabled/ && nginx -t && systemctl reload nginx.

3. 08

   Obtenir le certificat TLS

   Exécutez certbot --nginx -d votre-domaine.com. Certbot modifie le vhost pour écouter sur le port 443, ajoute les directives ssl_certificate et configure la redirection HTTP→HTTPS automatiquement. Le certificat se renouvelle via le timer systemd certbot.timer.

Créer son premier projet et configurer le Gantt

1. 09

   Accéder à l'interface et changer le mot de passe admin

   Ouvrez https://votre-domaine.com dans un navigateur. Connectez-vous avec admin / admin et changez le mot de passe immédiatement. Configurez ensuite l'URL de l'application dans Administration > Paramètres > Général si elle n'a pas été détectée automatiquement depuis OPENPROJECT_HOST__NAME.

2. 10

   Créer un projet et inviter les membres

   Cliquez sur « Nouveau projet », choisissez un nom, activez les modules utiles : Tâches, Gantt, Suivi du temps, Wiki. Invitez les membres depuis l'onglet Paramètres > Membres en leur assignant un rôle (Membre, Chef de projet, etc.).

3. 11

   Créer des tâches et définir les dépendances

   Dans la vue Liste des tâches, créez les premières tâches avec des dates de début et de fin. Basculez en vue Gantt pour visualiser la chronologie. Pour créer une dépendance, ouvrez une tâche et renseignez le champ « Précédée par » avec le numéro de la tâche parente.

4. 12

   Configurer les jalons

   Un jalon est une tâche de type Milestone. Créez-en depuis la vue Gantt (type « Jalon ») ou depuis la liste en changeant le type. Les jalons apparaissent sous forme de losange sur le diagramme — utiles pour marquer les livrables contractuels.

5. 13

   Activer les feuilles de temps

   Dans Administration > Paramètres > Journaux de travail, activez le module. Chaque membre peut ensuite saisir son temps via le bouton chronomètre sur une tâche ouverte. Les rapports agrégés par projet et par période sont accessibles depuis Rapports > Journaux de travail.

Dépannage — erreurs fréquentes

• 502 Bad Gateway au premier démarrage : les migrations Rails ne sont pas terminées. Attendez deux à cinq minutes et vérifiez docker compose logs web pour confirmer l'écoute sur le port 8080.
• Page blanche ou erreur 500 : SECRET_KEY_BASE est vide ou incorrectement défini. Régénérez-le avec openssl rand -hex 64 et redémarrez avec docker compose up -d --force-recreate.
• Pièces jointes refusées : la taille par défaut de nginx est 1 Mo. Augmentez client_max_body_size dans le vhost (100 Mo recommandés pour les fichiers projets).
• Problème d'envoi d'e-mails : configurez les variables OPENPROJECT_SMTP_* dans .env (hôte SMTP, port 587, identifiants). Sans configuration SMTP, les invitations de membres ne partent pas.
• Mise à jour de l'image : docker compose pull && docker compose up -d. OpenProject effectue les migrations automatiquement au démarrage. Faites une sauvegarde de la base avant chaque mise à jour majeure.