Skip to content
Shellbay

Containers · about 5 min · 5 steps

Update a Docker Compose project

Pulls newer images for a Compose project, recreates the containers that changed and removes the project's old images.

Runs on

  • Debian / Ubuntu: supported
  • RHEL / Fedora: supported
  • Alpine: supported

Before you start

  • Run the Docker Engine and Compose workflow first.

What it changes on your server

  • Runs docker compose pull and docker compose up -d in the folder you choose.
  • Containers whose image changed are recreated, which briefly interrupts them. Volumes and their data are kept.
  • Removes the images the project used before, once nothing uses them. Other projects' images are left alone.

What Shellbay asks you

  1. Which Compose project?

    Enter the folder on the server that holds the project's compose.yaml. Images pinned to a fixed version only change when you edit the file; tags like latest get the newest image.

    Project folder
    Text, up to 255 characters. Default: /opt/app

    Example: /opt/app

Steps

  1. Note the current images
  2. Download newer images
  3. Recreate changed containers
  4. Remove the old images
  5. Check the containers run

Shellbay checks the server before the first step, and stops at the first step that fails.

When it's done

  • The project in ‹project folder› runs the newest images its compose file allows. If something broke, pin the previous image version in the file and run Start a Docker Compose project.