**Objective**: Update Containerized Speckle Stack to latest Version

Hello there!

Here we run Speckle as containerized services defined by docker compose. (Deploying a Server - Docker Compose | Speckle Docs) and I am not fully clear about updating the stack to latest version. "docker inspect reveals that we have “SPECKLE_SERVER_VERSION=2.18.4” running. We like to update the stack but according to Deploying a Server - Docker Compose | Speckle Docs we have no differences in the docker-compose.yml. Releases · specklesystems/speckle-server · GitHub shows “2.20.2” as “latest”.

How could we tag the image in the docker-compose.yml to update?. Would it be “image speckle/server:2.20.1”?

Thanks in advance!
Hans

1 Like

Hey @hans220126 welcome to Speckle community.

Our docs for self-deployment with Speckle have a brief instruction on updating:

Server Manual setup - Update the server to new versions

And there it states there is no automatic mechanism and it is indeed appropriate to adjust the docker-compose file:


We recommend first backing up your data prior to modifying or updating the server. You can find instructions on how to do that here.


  • Connect to Your Server: SSH into the virtual machine (VM) where your Speckle server is running.

  • Navigate to the Docker Compose Directory:

     cd /path/to/your/docker-compose-folder
    
  • Stop and Take Down the Current Stack:

    docker compose down
    

This will stop and remove the current containers.

  • Check for Changes in the Documentation: Review any updates or changes in the Speckle documentation and update your docker-compose.yml file if necessary. If there are no changes, you can skip this step.

  • Pull the Latest Images:

    docker compose pull
    

This command will download the latest Docker images based on the tags specified in your docker-compose.yml.

  • Update the Image Tag if Needed: If you need to specify a particular version (for instance, 2.20.2), make sure the image tag in your docker-compose.yml reflects this version:

    image: speckle/server:LATEST_VERSION_RELEASE
    
  • Restart the Server Stack:

    docker compose up -d
    

This will start the server stack in detached mode, running the latest images.

NB The documentation page has a full docker-compse description, new server versions maybe associated with new FLAG settings to check at the same time

3 Likes

Thank you Jonathon! There are several Speckle services with their own image. Would that mean that the tags need to be idential for all the services - image: speckle/speckle-docker-compose-ingress:2 (speckle-ingress)
image: speckle/speckle-frontend-2:2 (speckle-frontend)
image: speckle/speckle-server:2 (speckle-server)
image: speckle/speckle-preview-service:2 (speckle preview service)
image: speckle/speckle-webhook-service:2 (speckle-webhook service)
image: speckle/speckle-fileimport-service:2 (speckle-fileimport service)

Thank you for your support!

Regards
Hans

Hans, I will defer to the server team on temporary leave right now. I hope to get you an asap