Docker Upgrade

This guide explains how to upgrade AIV when it is running in a Docker-based deployment.

When a new version of AIV is available, you can upgrade by downloading the updated Docker package, updating the configuration, and redeploying the containers.

What you’ll learn

How to update your AIV Docker deployment to a newer version
How to align your local Docker .yml file with the latest image version from GitHub
How to update the AIV drivers used by your Docker deployment
How to restart containers and verify a successful upgrade

Prerequisites

Docker Desktop is installed and running.
An existing AIV Docker deployment is already set up.
A backup of any custom configuration files or persistent data has been created (recommended).

Upgrade steps

Complete Step 1: Download the AIV 6 Docker Package and Step 2: Download AIV 6.4.0 (Docker via Git) from the installation guide.
Continue the process until the GitHub repository page opens.

1. Check the Latest Version in GitHub

On the GitHub page opened in Step 2, locate the Docker .yml configuration file (for example, docker-compose.yml).
Open the file and identify the Docker image version (image tag) used for AIV.
In your local environment, open the corresponding Docker .yml file used for your deployment.
Update the image version in your local .yml file so that it matches the version specified in GitHub.

2. Update Drivers

In your extracted AIV Docker package, navigate to the following folder:
```
config/drivers
```
Download the latest drivers ZIP file by following Step 2.
Extract the ZIP file.
Replace all existing driver files inside the config/drivers folder with the updated drivers.

Recommendation: Keep a backup of the previous config/drivers folder before replacing the files.

3. Restart the Docker Containers

After updating the image version and drivers, restart the containers.

Open a terminal in the folder where your AIV Docker deployment is located.
Stop the running containers:
```
docker compose down
```
Start the containers again:
```
docker compose up
```
Wait for all containers to start and for the application to report that it is ready.

4. Verify the Upgrade

Open your browser and navigate to:

http://localhost:8080/aiv

Confirm that AIV loads correctly and that the version information (if displayed in the UI or logs) reflects the upgraded version.

Important notes

Always ensure that your custom configuration and persistent volumes are compatible with the new AIV version before upgrading.
If you encounter issues after the upgrade, you can roll back by restoring your previous Docker .yml file and config/drivers backup and redeploying the containers.