# Helmut4 Single Server

### Installation

The installation of Helmut4 on s single server host which follows the [system requirements](/helmut4-releases/v4.7.0/getting-started/tech-specs/helmut4-server.md#system-requirements) which are listed below is straight forward. As Helmut4 is running within a docker environment the installation of these components are required - if the host is in a restricted network it may be needed to install those in advance or allow temporary access to the accordingly repositories. By default all necessary applications are installed automatically by executing the bash install script:

* docker-ce
* docker-ce-cli
* containerd.io
* docker-compose
* httpie
* jq

Helmut4 is storage agnostic which means that the system needs at least one share to be used properly, but it can be used with multiple shares as well. Any share needs to be mounted on the linux host system as well as within specific docker containers.\
At least one storage should be mounted via fstab before starting the installation as this one is needed.\
\
To start the installation executed the following command as sudo:

{% hint style="info" %}
**Full installation** *(downloading all dependencies)*\
curl -s <https://repo.moovit24.de/install/setup.sh> | bash
{% endhint %}

By default the script will install the current Helmut4 version on the server, we recommend to [update](#updating-helmut4) the version manually to the latest/same version after the installation.

### Portainer / Helmut4-Docker configuration

After the successful installation of Helmut4 the volumes of the host machine need to be handed over to the Docker environment. To do so navigate to Portainer, which runs on port 9000:

{% hint style="info" %}
**Portainer web GUI**\
<http://ip-helmutserver:9000>
{% endhint %}

The default user/password to log in is admin/admin\
Please consider to *change this password as soon as possible*!

#### Mount network shares into Docker

Every drive that is to be added to the system must be mapped into the container. To do this, the drive must first be mounted at the operating system level. The drive mounted at the operating system level is now mapped into the Docker container in the following way:<br>

{% hint style="info" %}
Drive on operating system level: **/mnt/helmut**

Drive on Docker container level: **/Volumes/helmut**

Drive mapped between operation system level and Docker container: **/mnt/helmut\_1:/Volumes/helmut\_1**
{% endhint %}

This mnt to Volumes mapping is set up, to allow setting up easy workflows on Mac OS X, as every network share is mounted to /Volumes\
\
There are 5 different containers that always have to have access to specific volumes to run specific tasks.\
For example: If the server should create projects on a specific volume, this volume needs to be mapped into the FX Container, as this container is responsible for creating projects.\
To add volume to a container follow these steps:

* click on “primary”
* click on “stacks”
* click on “helmut4”
* click on the tab “Editor"

Navigate to the following services (fx, io, co, streams, users) and adjust the volumes entry\
![](/files/viuZS8RnamU2Ov5MNoCD)

Add or change the volumes and click **update the stack** once finished with this task.

{% hint style="info" %}
Example: adding share "testing" which is mapped on the host into /mnt/testing\
\
volumes:&#x20;

&#x20;   \- /etc/localtime:/etc/localtime:ro

&#x20;   \- /mnt/helmut:/Volumes/helmut

&#x20;   **- /mnt/testing:/Volumes/testing**
{% endhint %}

### Updating Helmut4

There are two update channels available for Helmut 4 - main & development\
An update can be accessed with sudo rights on the command line of the host

#### Main update channel | helmut-snapshot

Stable releases will be published every three months, the latest release can be found in the [release notes](/helmut4-releases/v4.7.0/release-notes/whats-new.md). This version is covered by the support contract and the software maintenance agreement is valid for this version.\
Critical bugs will be fixed in stable release.\
Please consider checking the [supported Adobe versions](/helmut4-releases/v4.7.0/getting-started/supported-adobe-versions.md) before updating

```bash
helmut-snapshot <snapshot version number>

sudo helmut-snapshot 4.7.0
```

After executing the update command the Portainer password is required

#### Development update channel | helmut-update

```bash
sudo helmut-update
```

The development channel is only for internal use and requires an additional password, this one can be requested by contacting <support@moovit.de>

{% hint style="info" %}
**Be aware that those builds are MAINLY UNTESTED and can cause problems!**
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helmut.de/helmut4-releases/v4.7.0/getting-started/installation-guide/helmut4-server/helmut4-single-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.