Upgrading a docker container from before 2025

Before 2025, upgrading the Tillit Edge Docker required destroying the existing container, which led to missing files necessary for the new version. Starting in 2025, this issue has been resolved, and upgrades can now be performed without losing critical files.

If your docker-compose.yml file resembles the example below and is missing the lines added in "Since 2025," you will need to complete pre-upgrade steps before proceeding with the upgrade. If not, then you can easily use docker compose pull and docker compose up -d --force-recreate to upgrade to latest version of the image

Example docker-compose File Before 2025

version: '3.7'
services:
  TillitEdge:
    image: gotillit/edge:latest
    environment:
      - INIT_CONFIG=/greengrass/v2/config.yaml
      - AWS_REGION=ap-southeast-2
    volumes:
      - ./tillitEdgeConfig:/tillit/
      - ./SystemsManagerConfig:/var/lib/amazon/ssm
    privileged: true #Allows device defender to read from tmpfs
    restart: always

Example docker-compose File Since 2025

services:
  TillitEdge:
    image: gotillit/edge:latest
    environment:
      - INIT_CONFIG=/greengrass/v2/config.yaml
      - AWS_REGION=ap-southeast-2
    volumes:
      - ./tillitEdgeConfig:/tillit/
      - ./greengrass/packages:/greengrass/v2/packages
      - ./greengrass/deployment:/greengrass/v2/deployments
      - ./greengrass/config:/greengrass/v2/config
      - ./greengrass/logs:/greengrass/v2/logs
    restart: always

Pre-Upgrading Before 2025

If you are upgrading from a version prior to 2025, you will need to copy required files from the running container to the host system in the same directory as your docker-compose.yml file. Below are the steps to accomplish this:

Using Command Line (Recommended)

1. Open a Terminal: Open a terminal window and list the running containers:

   docker container list

2. Copy the Container ID: Locate and copy the Container ID of the TilliT Edge container you wish to update.

3. Prepare the Host Directory: Navigate to the directory containing the docker-compose.yml file and create a greengrass directory:

   mkdir greengrass

4. Copy Files from the Container: Use the following commands to copy the necessary files from the container to your local directory. Replace <container_id> with the Container ID from Step 2:

   docker cp <container_id>:/greengrass/v2/packages ./greengrass/packages
   docker cp <container_id>:/greengrass/v2/deployments ./greengrass/deployments
   docker cp <container_id>:/greengrass/v2/config ./greengrass/config
   docker cp <container_id>:/greengrass/v2/logs ./greengrass/logs

5. Update the docker-compose.yml: Modify the docker-compose.yml file to include the updates listed in "Since 2025."

6. Pull the Latest Image: Run the following command to pull the latest version of the TilliT Edge image:

   docker-compose pull

7. Recreate the Container: Restart the container with the latest version of the image:

   docker-compose up -d --force-recreate

8. Verify the Upgrade: Check in TilliT to ensure the Edge is functioning as expected.

Using Docker Desktop (Not Recommended)

1. Prepare the Host Directory: Open the folder location containing the docker-compose.yml file and create a greengrass directory.

2. Access the Container Files: Open Docker Desktop and locate the TilliT Edge container. Navigate to the Files tab, then open the greengrass/v2 directory within the container.

3. Copy Required Folders: Save the following folders by right clicking them from the container to the greengrass directory on your host system:

   • packages

   • deployments

   • config

   • logs

4. Update the Image: In Docker Desktop, go to the Images panel and select Pull from the context menu to update the image.

5. Recreate the Container: Open a terminal, navigate to the directory containing the docker-compose.yml file, and run the following commands:

   docker-compose pull
   docker-compose up -d --force-recreate

6. Verify the Upgrade: Check in TilliT to ensure the Edge is functioning as expected.