Skip to content

One Touch Installation

Last updated on Nov 14 2025.

Overview

OVD One Touch is an interactive shell script that provides an easy way to install and upgrade different OVD roles and utilities needed for deployment of a fully functional OVD farm.

As an alternative to manual installation, OVD One Touch can install not just individual OVD roles, but also a quick "all-in-one" solution (where Session Manager, Web Access, File and Application Servers are installed within the same environment) and additional utilities that simplify additional configuration of the farm.

Requirements

Please make sure that all servers meet minimal system and hardware criteria for their corresponding OVD roles as listed in requirements.

Important Notes

  • Internet access is required to install with the OVD One Touch installer, and if you are using URL filtering, please allow access to https://ovd.one and https://archive.inuvika.com alongside the standard operating system repositories required.

  • All commands need to be run with root privileges.

  • Where multiple roles are required on the same server, the installer can be re-run multiple times.

  • If you make a mistake during installation, you can abort the script at any point by pressing CTRL + C.

  • OVD Enterprise Secure Gateway (optional) must be installed on a separate server.

  • For RHEL: OVD is compatible with SELinux. If SELinux is enabled, the installation process will configure SELinux rules accordingly. If SELinux is disabled, it will remain so, and no SELinux rules will be applied.

Installation Walkthrough

  1. Connect to the server you want the role/utility to install. For Windows Application Server role installation, use any other role server.

  2. Elevate your shell to the superuser if you are not already root: 

    $
    sudo -s

  3. Update your system

    • Ubuntu 

      #
      apt update && apt upgrade

    • RHEL 

      #
      yum update

  4. Download and launch installation script, replacing the <version> with the specific version code you wish to install: 

    #
    curl -s https://ovd.one | OVD_VERSION=<version> bash

    Info

    You will find the version code on the Inuvika OVD supported versions page. You may also contact Inuvika to request the code.

  5. After a short period, you will be presented with the welcome screen. Press ENTER to proceed with a preparation of the installation environment.

Installation Options

After the successful preparation of the installation environment, the following options will appear in the menu: One Touch Menu

All of the above (all in one installation) installs following roles on the same server:

  • Session Manager
  • File Server
  • Linux Application Server
  • Web-Access

Windows Application Server remotely installs Windows Application Server on any supported Windows server. Please refer to Windows OVD Application Server installation for more information.

Provisioning Server installs the OVD Provisioning Server. Enables OVD to provision and manage virtual machines for users and groups.

Demo Appliance Installation installs the OVD Demo Appliance. Provides an all-in-one installation with basic farm configuration, including users, groups, and applications.

Warning

Valid subscription is required to start a session.

Utilities displays selection of following options:

  • Setup ESG for Let's Encrypt

  • Install Grafana Server

  • Install Speed Test on the OWA

  • Install Monitoring Stack

  • Upgrade this server (3.4 and newer)

Please choose the required option and press ENTER. Depending on the role selected, the Installer will then ask you for additional information such as IP address, passwords etc.

The installer will then begin and automatically install the requested roles and/or features you have requested

Windows OVD Application Server Installation

The Installer allows you to install OVD Windows Application Server remotely from any supported Linux server.

Important

If you plan to integrate application server with Active Directory domain, do not join the server to the domain before finishing OVD installation.

Before running the Installer, you need to configure Windows server as follows:

Important

You must use the local administrator account.

iex ((new-object net.webclient).DownloadString('https://ovd.one'))

If you encounter an SSL/TLS error, please run this command first:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12,[Net.ServicePointManager]::SecurityProtocol

Each option will ask a series of questions for information such as IP address, passwords etc. Please answer these in sequence. Remember that all inputs are case-sensitive.

Additionally, you can choose to install FabulaTech server components during the setup. If selected, the installer will prompt you to select specific components and optionally enter the Licensing Server IP and port. If left blank, the installation proceeds in testing mode, allowing you to configure the Licensing Server or add a license key manually later.

Upgrade Walkthrough

The OVD One Touch Installer can be used to upgrade your OVD installation to the latest version.

Warning

Please ensure you have familiarised yourself with the release notes for the version you are upgrading to, that you have no users logged in (in any form), and that your Session Manager is in maintenance mode.

  1. Connect to the Linux server you want to upgrade.

  2. Elevate your shell to the superuser if you are not already root:

    $
    sudo -s

  3. Download and launch installation script, replacing the <version> with the specific version code you wish to install:

    #
    curl -s https://ovd.one | OVD_VERSION=<version> bash

    Info

    You will find the version code on the Inuvika OVD supported versions page. You may also contact Inuvika to request the code.

  4. After a short period, you will be presented with the welcome screen. Press ENTER to proceed with a preparation of the installation environment.

  5. Select "Utilities"

  6. Select "Update this server"

  7. The OVD One Touch Installer will now automatically upgrade your system to the version of OVD specified in the previous step. This will also update any out-of-date system packages beyond OVD to the latest available version.

Monitoring Stack Installation

The OVD One Touch Installer allows you to deploy the Monitoring Stack on a dedicated server. During installation, the following components are set up:

  • InfluxDB 2
  • Grafana

The installer automatically configures both the OVD Session Manager and InfluxDB, ensuring that monitoring data is collected and available for visualization in Grafana.

Once installation is complete, access Grafana using the default credentials (admin / admin). You will be prompted to change the password upon first login for security purposes.

Error Messages

If installation process fails, error is displayed as standard error in the output of the shell. The complete installation standard output is stored at /var/log/ovd-install.log.

These are the most common errors:

  • Invalid version number
  • Connection issues related to DNS, Proxy servers
  • Configuration input mistakes (invalid version number, incorrect IP address, incorrect password...)

After resolving the issues, run the script again and selected. If you are not able resolve issues yourself, please contact Inuvika Support and include a copy of the log file from /var/log/ovd-install.log of the affected server.

Cleanup and Next Steps

Remove the playbooks containing sensitive information:

rm playbook.yml playbook-win.yml

Remove the folder with installation credentials:

rm -rf credentials

Remove Ansible installation files and directories:

rm -rf /opt/ovd

To finalize your installation, please follow Initial Configuration.

Advanced Options

You can add specific overrides that allow you disable or enable functionality that the OVD One Touch Installer can perform.

These are added after the |, for example OVD_VERSION is an override here curl -s https://ovd.one | OVD_VERSION=<version> bash

List of Overrides

Flag Effect
BEST_PRACTICES=false Prevents the process isolation changes
EXTRACT_ONLY=true Installs only Ansible and makes the OVD role playbooks available
INSTALL_BGINFO=true Installs BgInfo
INSTALL_MSRA=false Prevents the installation of Microsoft Remote Assistance
INSTALL_RDS=false Prevents the installation of Microsoft Remote Desktop Services
OVD_REPO=<location> Sets the repository for installing OVD (e.g., a pre-release beta version)
OVD_VERSION=<version code> Sets the OVD version (skips the version selection during installation)
REMOVE_PRINTERS=false Prevents the removal of existing printers