Skip to content

Versio.io Managed installation

Note

If you operate a Versio.io Managed Instance, it is always a good idea to document all customer-specific aspects in an IT operating manual. To make it easier for you to create the IT operating manual, we provide you with a corresponding template.

Go to Template Versio.io operation handbook

Check system requirement

Before starting any installation, please run our system requirement check script to ensure that all requirements are met!

# Variant1: Before you install Versio.io Managed
wget https://raw.githubusercontent.com/versio-io/check-versio.io-system-requirements/main/check-versio.io-system-requirements.sh

# Variant2: Script is available after Versio.io Managed installation
cd /opt/versio.io/install/utils

# Execute system requirement check
sudo bash ./check-versio.io-system-requirements.sh

Command line: Download and execute the system requirements check before Versio.io Managed installation

Download & installation

Your Versio.io contact will provide you with a link to download the Versio.io Managed core installer. The installer can be downloaded and executed with the following commands. After the installation you will find the Versio.io application files in /opt/versio.io and the Versio.io data files in /home/versio.io.

# Download the Versio.io Managed installer
# Obtain the complete link from your Versio.io contact. 
wget -nv -N --no-check-certificate https://<my-link>/install-versio.io-managed.sh 

# Execute the installation as 'root' user
sudo ./install-versio.io-managed.sh

Command: Download and install Versio.io managed core

Attention

When installing the Versio.io platform, a user and a group called versio are created. All further operational activities will be carried out under the user versio!

su - versio

Command: Switch to the Versio.io platform user

Before starting or updating the Versio.io Managed instance for the first time, you must log in to the Versio.io Docker image registry once.

# Register to Versio.io container image reporistory
# The needed authentification you get from your Versio.io contact
docker login registry.versio.io

Command: Login to the Versio.io docker registry

With the update.sh script you can initialize the database, download Versio.io platform images, startup Versio.io Managed platform and import Versio.io Artificial Intelligence Content Repository:

# Update the container images and initialize the database schema
bash /opt/versio.io/install/update.sh

Command: Initialize and update the Versio.io platform

Initial setup

After successful installation and first startup, we recommend that you perform the following activities as soon as possible:

  1. Login with the default user and password. You will receive the username and password from your Versio.io contact person.
  2. Create a new server admin user:
    • Open the server environment ✪ Platform administration
    • Create a new user Access management - User with the user group right Server administration
  3. Deactivate the default admin user:
    • Open the server environment ✪ Platform administration
    • Remove the default user Access management - User
    • Goto Server settings -> Users
    • Change the password of the default user
  4. Create a new environment (see Server settings - Environment settings)
  5. Invite new user to the new environment (see Environment settings - User & rights)
  6. Define to which Versio.io environment the events of the Versio.io server platform should be added:
    • Open the server environment ✪ Platform administration
    • Goto Access management - General
    • Enter the ID of the environment in the Environment for server events field.
  7. Configure SMTP server for e-mail notification (necessary for initial password set/reset!)
  8. Install an OneImporter (see Environment settings - OneImporter - Install)
  9. Configure OneImporter configuration (see Environment settings - OneImporter - Configurations)