Server Install

In this section we descrive how to install the Deepserver on your machine.

To install the Deepserver in your machine, you must be running Ubuntu 20.04 or Ubuntu 22.04.

❗️

This page is under construction and incomplete

Installation package composition

Aivero's Deepserver installation package is composed of different components that can be used to install or update different parts of your server:

  • aivero_installation-linux-x86_64-x.x.x.tar.gz - which contains the basic installation and update scripts, used in both Airgapped and non-Airgapped installations

🚧

The packages below only apply to Airgapped installation, where internet connection is not possible

  • deepserver-images-linux-x86_64-x.x.x.tar.gz - which updates the docker images of the Deepserver in airgapped installations
  • open-balena-linux-x86_64-x.x.x.tar.gz - which contains updates for the Open-Balena instance that controls Deepcore devices connected to the Deepserver, in Airgapped systems
  • fleets-images-linux-x86_64-x.x.x.tar.gz - which contains updates for the Deepcore devices installed through Open-Balena in Airgapped systems

Setting up installation directory

There are a few steps which must be performed in order to setup the installation environment, depending on your installation type and which components you wish to update.

First, start by extracting the aivero_installation-linux-x86_64-x.x.x.tar.gz package. We suggest that you extract it to a new, empty folder. You can do this by running the following commands:

mkdir installation_dir
tar -xf aivero_installation-linux-x86_64-x.x.x.tar.gz -C installation_dir

🚧

If you're not running an Airgapped installation, skip the following steps and navigate to the next section

On first setup, you must also download the three component packages for Airgapped systems referenced above, and copy them into your installation_dir folder. If you are simply updating a machine that has had the Deepserver setup on it previously, you can choose which components you wish to update , by only copying the desired ones into the aforementioned folder.

cp (name-of-component)-x86_64-x.x.x.tar.gz

When done copying, you are ready to start your Deepserver installation or update!

Running the installer

To run the installation, open a terminal window in the previously setinstallation_dir folder then run the run-deepserver-installation.sh script. There are some execution settings, which can be set by using passing in flags to the script when invoking from the shell.

However, if the script is called without passing any flags, it will be executed in non-Airgapped mode, with a user interface to aid along with the installation:

/bin/bash run-deepserver-installation.sh --airgapped --no-ui --domain=aivero.lan

If you do not wish to run the default installation, please check the flags sub-section down below. If you're simply running a default installation as described above, skip down to the Navigating the User Interface section.

Flags list

  • --airgapped -> Passing this flag sets the system into airgapped installation mode
  • --no-ui -> Passing this flag sets the installation to be purely terminal based
    • --domain -> This flag is mandatory if --no-ui is passed in. Sets the domain the server can be accessed on
  • --help -> Prints help regarding the available script flags
  • --verbose -> Explains in depth the functionality of the different installation packages

For example, this launch string would cause the installation to run in Airgapped mode, using the terminal mode, and with the domain set to aivero.lan:

/bin/bash run-deepserver-installation.sh --airgapped --no-ui --domain=aivero.lan


Please reboot the machine after finishing the installation.

That's it! Your Deepserver can now be accessed after a few minutes on Firefox or Chrome, under the previously introduced domain. Happy recordings! 😄

Firewall configuration

In case the firewall is up and running or in case it will be in the future we can open the required ports:

sudo ufw allow 8554:8654/tcp
sudo ufw allow 8554:8654/udp
sudo ufw allow 60000:60100/udp
sudo ufw allow 61000:61100/udp