Upgrade Guide

VideoCMS is designed to be easily upgradable using Docker. We currently recommend tracking the :beta tag for the latest features and fixes.

Migrating from v0.0.9

If you are still running v0.0.9 (Alpha), which used separate api and panel containers, please follow our v0.0.9 to v0.1.0 Migration Guide before proceeding with standard upgrades.

Standard Upgrade Process

The upgrade process involves pulling the new image and restarting the containers.

1. Check for Updates

You can see if a new version is available directly in your Admin Dashboard under the System Analytics section. A notification will appear if your current version is outdated.

2. Backup

Before performing any update, it is highly recommended to backup your database.

# Example: simple copy of the database folder
cp -r database database_backup_$(date +%F)

See our Backup & Restore Guide for more details.

3. Pull and Restart

Download the newest version of the software and restart the service.

docker compose pull
docker compose up -d

Note: docker compose up -d will automatically recreate the container only if a new image was pulled.

Database Migrations

Do I need to run manual migrations?No.

VideoCMS automatically checks and updates the database schema every time it starts up using GORM's AutoMigrate feature.

The persistent download-jobs release automatically creates download_jobs and adds a traffic source column. Existing traffic is classified as player traffic because historical attachment downloads cannot be separated retroactively.

The old synchronous /:UUID/:QUALITY/download/:FILE attachment endpoint has been removed. Integrations must use the create/status/file download-job flow documented in the API reference. The progressive MP4 player endpoint is unchanged.

Storage mounts and pools

The storage-pools release is also automatic. On first start, VideoCMS creates the new storage tables, registers the existing media directory as the built-in local mount, creates a local upload pool, and assigns legacy file records to local storage. Existing media stays in place and does not need to be moved or re-uploaded.

The only operator setup is for optional remote storage: configure StorageEncryptionKey before saving an S3-compatible or SFTP mount. Instances that continue using only local storage need no new environment variable. See Storage Pools for setup and migration details.

If a major breaking change ever requires manual intervention, it will be prominently listed in the Changelog.