Skip to content

Service management and updates ​

Run these commands from the example Compose directory.

sh
docker compose ps -a
docker compose logs --tail=100 api worker mattermost
docker compose stop
docker compose up -d

ps -a also shows completed migrations. stop stops containers. down additionally removes containers and the network. The database volume remains unless -v is supplied.

Update ​

  1. Set draining: true on workflows and reload them.
  2. Stop admission from custom connectors. If you use GitLab review, run docker compose stop review in its example directory. Accepted runs continue in Orpheus, and GitLab publication resumes after the connector restarts.
  3. Wait for active Orpheus work and Mattermost delivery to finish.
  4. Back up the database and configuration.
  5. Change image versions in .env.
  6. Stop application services, pull images, migrate and start again:
sh
docker compose stop mattermost web worker api
docker compose pull
docker compose run --rm migrate
docker compose up -d --force-recreate api worker mattermost web
  1. Verify /ready, /readyz, web sign-in and a test task. Disable draining and resume event admission. Restart the GitLab connector from its example directory with docker compose up -d review when used.

A plain restart does not apply changed Compose environment settings. Recreate containers instead. When updating a profile or template, account for the workflow revision.

Investigate failed migrations before starting applications. Rolling back an image does not roll back the database.