Version 1.0 migration notes

These notes apply when updating an existing deployment to TruSpace version 1.0.

Open WebUI persistent data

For version 1.0, we updated some default versions of the Docker images. Especially for Open WebUI, this may fail to start or behave incorrectly with data created by an older image. If this happens, remove the Open WebUI data volume before restarting the application:

This deletes Open WebUI data

volumes/open-webui contains Open WebUI's persistent data. Back it up first if it contains settings, users, or other data that must be preserved.

cd /opt/TruSpace

# Stop the deployment and back up the volume before removing it.
docker compose down
tar -czf "open-webui-pre-v1.0-$(date +%Y%m%d%H%M%S).tar.gz" volumes/open-webui

# Remove the incompatible Open WebUI data volume.
rm -rf volumes/open-webui

# Pull the default version 1.0 images and restart.
docker compose -f docker-compose.pull.yml pull
./start.sh

If Open WebUI starts normally after the upgrade, do not remove volumes/open-webui; deleting it is only a recovery step for the compatibility issue described above.

After restarting, verify the health endpoint, log in, and confirm that AI processing works as expected. Make sure that the volumes/open-webui is deleted before pulling the new images, otherwise Open WebUI may fail as it doesn't build the new assets.