Aller au contenu principal

OpenProject — Mise à jour

OpenProject tourne en Docker Compose sur le serveur. Pour trouver le dossier d'installation :

docker compose ls

La colonne CONFIG FILES donne le chemin du docker-compose.yml.

Mise à jour mineure (17.x → 17.y)​

Le tag 17-slim suit automatiquement la dernière 17.x : pas de risque de passer en 18 par accident.

  1. Sauvegarder (indispensable) :

    sudo /usr/local/bin/backup_openproject.sh

  2. Mettre à jour depuis le dossier d'installation :

    docker compose pull
    docker compose build --pull proxy
    docker compose up -d

  3. Suivre les migrations :

    docker compose logs -f seeder web

  4. Vérifier la version dans Administration → Informations.

hocuspocus

L'image openproject/hocuspocus est figée sur une version précise dans docker-compose.yml (ex. 17.8.0). L'aligner à la main sur la version d'OpenProject.

proxy

L'image proxy est construite localement : docker compose pull ne la met pas à jour, d'où le build --pull.

Mise à jour majeure (17 → 18)​

  1. Lire les notes de version d'OpenProject 18.
  2. Sauvegarder.
  3. Récupérer le nouveau docker-compose.yml de la version 18 et reporter les personnalisations.
  4. Changer TAG dans .env.
PostgreSQL

Le .env doit contenir POSTGRES_VERSION=17 (version actuelle de la base). Une image PostgreSQL d'une autre version majeure ne démarre pas sur des données existantes. Ne jamais changer cette valeur sans suivre la procédure officielle de migration PostgreSQL.

Secrets​

Le fichier .env contient SECRET_KEY_BASE, le mot de passe PostgreSQL et le secret hocuspocus. Il est inclus dans la sauvegarde et ne doit jamais être publié (ni dans GitLab, ni dans cette doc).