TilliT
HomepageChangelogDeveloper
  • Home
  • Introduction to TilliT
    • Introduction for New TilliT Customers
    • Videos
  • Getting Started
    • Overview
    • Definitions
    • Set up a Site & Assets
    • Set up an Activity
    • Create an Order
    • Start an Order
    • Next steps
  • Planning
    • Overview
    • Data Gathering
      • Site & Assets
      • Production Orders
      • Activities
      • Shifts & Calendars
      • Materials
      • Process Variables
      • Attributes
      • Articles
      • Checklist
  • Knowledge Base
    • Everyday Usage
      • Layout Overview
      • Login to TilliT
      • Basic functionality
      • Lock screen
      • Pinning Assets
      • Switch Site
      • Next Steps
      • Activities
        • Claiming
        • Completing
        • Manually starting
      • Orders
        • Create adhoc Order
      • Events
        • Raising an Event Using the UI
      • Notifications
    • Scheduler
      • Introduction
      • Feature Overview
      • Scheduler to Digital Operations integration
      • Scheduling
        • Scheduling
        • Orders
        • Scenarios
        • Inventory
      • Configuration
        • Operations
        • Equipment
        • Personnel
        • Materials
        • Availability
        • Optimisation
        • Changeovers
        • Loading data with excel Add-in
      • MVP Setup Guide
    • Insights
      • Activity report
      • Production Report
      • Dashboards
      • Advanced Analytics
        • Sharing dashboard
    • Users
      • User
        • User Confirmation
        • User channels
        • User subscriptions
      • Groups
      • Permissions
      • User authentication with SSO
    • Boards
    • Settings
      • Asset Hierarchy
        • Site
        • Asset
          • Asset Attributes
          • Asset Tolerances
          • Downtime periods
          • Attribute Group
          • Edge data tags
        • Asset class
        • Order Templates
          • Order Template with Unit Conversion
        • Calendar
          • Calendar item
        • Shifts Templates
          • Creating Shift Templates
          • Manual shift patterns
        • Asset Meter
      • Material Definition
        • Material
        • Material group
        • Material attributes
          • Example of material attributes
        • Material tolerance
          • Example of Material tolerance
        • Material component
        • Material conversion
      • Activity Templates
        • Activity template
          • Creating an activity
          • Where
          • When
          • Versioning
          • Building
          • Elements
            • Item types
              • Item properties
                • Active item & hidden expressions
                • Hint
                • Tolerance Source
              • Update Attribute
              • Board Item
              • Raise event
            • Data Types
              • Evaluate Data types & Dynamic Note
              • Note
              • Option list
              • Dynamic option list
              • Barcode
              • GS1 Barcode Scanner
              • Edge data
              • Material Component
              • Image capture
              • Sections
              • Digital Signature
              • Material
              • Dynamic Form Items
              • Inventory Key
        • Activity class
      • Events
        • Event Type
        • Event Relay
        • Event Schedule
      • Articles
      • Integrations
        • Adding Webhook Subscriptions
        • MQTT Integration
        • Receive the TilliT Event
        • Notifications
      • Configuration
        • Attribute
        • Attribute group
        • Tolerances
        • Dashboard group
        • Report Templates
          • Creating and Using Report Templates
        • Process variable
        • Unit of Measure
        • Run Rate Template
      • Translation
      • Audit Log
    • Edge
      • Introduction
      • Before You Start
        • Security / Firewall
        • TilliT Edge
        • Understanding your Networks
        • Common Installation Solutions
        • Managing and Publishing changes
      • Physical Device
        • Setup
      • Using Docker
        • Upgrading a docker container from before 2025
      • Common Data Sources
        • OPC-UA
        • Modbus TCP
        • Ethernet IP
        • Profinet
        • RTLE
        • Simulator
      • Data Tags
        • Data Tag Templates
        • Order Number Tag Template
        • Edge Data Tag Options
      • Edge Triggers
      • TilliT Sensors
        • Connect TilliT Edge to a Wireless Gateway
        • Bind a Wireless Counter to a Wireless Gateway
        • Configure FEN-20 PNP Sensor
      • Troubleshooting
      • Windows Edge Installer
    • History
    • OEE
      • Two Steps to Availability
      • Two Steps to Performance
      • A Step to Quality
    • Track and Trace
      • Before you begin
      • Transaction Types
      • Movement Types
      • Movement Types Field
      • Adding Material Movement to an Activity Template
      • Completing the Activity
      • Reporting
    • Mobile View
      • Device shortcut
      • Unable to enter Negative Numbers
    • Importing, Exporting and Cloning Entities
    • Troubleshooting
  • Tools
    • Excel add-in
      • How to Install the Excel Add-in
        • Excel Online
        • Desktop
      • How to Update the Excel Add-in
      • Loading multiple orders
      • Maintaining Master Data in Bulk
      • Downloading Time-Series Data
    • Staging Environment
    • Ignition Module
      • Installation
      • TilliT Tag Provider
        • Data From TilliT to Ignition
        • Data From Ignition To TilliT
      • Scripting Using the TilliT Module
      • Network Security
  • INFRASTRUCTURE
    • FAQ
    • Architecture
    • Disaster Recovery
    • Software Quality Assurance
Powered by GitBook
On this page
  • Example docker-compose File Before 2025
  • Example docker-compose File Since 2025
  • Pre-Upgrading Before 2025
  • Using Docker Desktop (Not Recommended)
  1. Knowledge Base
  2. Edge
  3. Using Docker

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.

PreviousUsing DockerNextCommon Data Sources

Last updated 4 months ago