Skip to content

Updates (OTA)

An active subscription (and the Free plan) includes over-the-air updates.

Checking for updates

  • In the UI: vConfig checks vconfig.ai daily and shows a banner in Settings → About when a new version is available, with release notes.
  • From the shell: vconfigctl update --check

Updating

vconfigctl update

This will:

  1. Download the new release image and verify its SHA-256 checksum.
  2. Back up your database and data volume automatically.
  3. Swap the container to the new version (typically < 30 seconds of downtime).
  4. Keep the previous image locally for rollback.

Database schema migrations run automatically on first start of the new version.

Rolling back

cd /opt/vconfig
# set VCONFIG_VERSION back to the previous version in .env, then:
docker compose up -d

Warning

Roll back only to the version you upgraded from, and restore the matching database backup from /opt/vconfig/backups if the newer version already migrated the schema.

Release channels

All customers receive the stable channel. Release notes for every version are published on the changelog.