# Versio.io Managed staging

## Setup

To support staging environments with test, acceptance and production environments, the monthly releases from the last 6 months are available in the Versio.io container image repository.

The environment variable `VERSIO_RELEASE` can be used to specify the release to be deployed (e.g. `VERSIO_RELEASE=2025.10`). You can find the exact release names in the [release notes](<https://docs.versio.io/release-notes/index.md>).

## Install or update

How to install and update a specific release:

```sh
// Shut down the Versio.io platform
cd /opt/versio.io/install
bash shutdown.sh 

// Set the environment variable with the release information. It is recommended to set the environment variable in /opt/versio.io/install/conf/versio-io.env
export VERSIO_RELEASE=2026.06 

// Update the Versio.io platform
bash update.sh

// That's it 😊
```

*Script: Installing and updating a specific Versio.io platform version*

## Limitation

The following restrictions apply:

- Staging is supported from release 2025.10 onwards.
- Monthly versions are available for a maximum of 6 months after their release.
- The Versio.io database can only be updated to the corresponding or newer releases via `update.sh`. Otherwise, the current database must be deleted (`rm -rf /home/versio.io/`) and initialised with `bash utils/set-environment-variables.sh`.
- The AI content is only provided in the current version and with the current data model.
- For Kubernetes OneImporter &amp; OneGate, only the current release is available in Docker Hub.
