openZro

Upgrade Your Self-Hosted openZro Installation

Check for Updates

The openZro Dashboard displays an update indicator at the bottom of the left navigation menu when a new version is available:

update-available

You can also check the current version programmatically via the API (requires authentication):

curl 'https://your-openzro-domain/api/instance/version' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer <your-access-token>'

Example response:

{
    "dashboard_available_version": "2.28.0",
    "management_available_version": "0.64.1",
    "management_current_version": "0.64.0",
    "management_update_available": true
}

Check Release Notes

Before upgrading, review the release notes for any breaking changes or migration steps:

Management, Signal, and Relay are all part of the same repository and share the same version numbers.

Upgrade Steps

To upgrade openZro to the latest version:

  1. Run the backup steps described in the backup section.
  2. Review the release notes (see above) for any breaking changes.
  3. Pull the latest openZro docker images: 
    docker compose pull openzro-server dashboard
    If you have the Reverse Proxy enabled, also pull the proxy image: 
    docker compose pull proxy
  4. Restart the openZro containers with the new images: 
    docker compose up -d --force-recreate openzro-server dashboard
    If you pulled the proxy image above, include it in the restart: 
    docker compose up -d --force-recreate openzro-server dashboard proxy

For upgrades from older versions (pre-v0.26.0), see the Legacy upgrade notes below.

Legacy Setup (Separate Containers)

If your deployment uses the older setup with separate containers (management, signal, relay, coturn), pull and recreate those containers instead:

docker compose pull management dashboard signal relay

docker compose up -d --force-recreate management dashboard signal relay

If you have the Reverse Proxy enabled, also pull and recreate the proxy:

docker compose pull proxy && docker compose up -d --force-recreate proxy

Get In Touch

Feel free to ping us on Slack if you have any questions.