- Docs
- Updating Overview
-
InstallationUpdatingSettingsLogs
- Using ItemPath
-
APIReportsSnapshotsWorkflowsDashboardExplorerUsers
- Apps
-
Cycle CountsData PullData PushDisplaysLights (Philips Hue)Custom Fields
Updating Overview
ItemPath pushes out regular ItemPath Docker image updates, but the images do not update automatically. Here's how to perform an ItemPath software upgrade.
Pulling Docker Images
The following commands will need to be done from the folder where ItemPath is installed, usually the root folder of the Linux user.
First, the updated images can be pulled from the Docker registry.
Then, ItemPath will need to be brought down and back up to apply the update.
Here's how those commands look:
Docker V1:
docker-compose pull docker-compose down && docker-compose up -d
Docker V2:
docker compose pull docker compose down && docker compose up -d
Version Tagging
The version number can be controlled by tagging the 8 images (excluding an optional certbot image) in the docker-compose.yml file, like this:
version: "3.7" services: redis: image: ppgsupport/redis:2.11.0.0
Alternatively, the "latest" tag can be used to pull the most recent release:
image: ppgsupport/redis:latest
For subsequent tagging, you can use the "find and replace" command detailed here. Replace the version numbers in the command below to use. This will replace all instances of the old version number. You can then use :wq to save and exit the file.
:%s/OLDVERSIONNUMBER/NEWVERSIONNUMBER/g
If the docker-compose.yml file has no image tags, it will pull the latest images.
Release Notes
Software release notes can be found online here.
Pruning Images
After a successful upgrade, unused images can be pruned to free up space using the docker image prune -a command.
Backing Up
ItemPath performs weekly database backups, but you can also (carefully!) backup manually with the following commands:
Database backup:
cp ~/ItemPath/data/appdata.db ~/ItemPath/data/backups/appdata-backup-manual.db
Docker-compose.yml backup (replacing MM-YY with the current date):
cp docker-compose.yml ItemPath/data/backups/docker-compose-MM-YY.yml
To restore the files in case of a failed upgrade, the files can be copied in the opposite direction.
Be cautious when doing this! You don't want to overwrite anything by mistake.