Let’s create a installation directory in our servers home folder

Bash
mkdir ~/sys-api && cd ~/sys-api

Then let’s create the config/ and data/ directories

Bash
mkdir config && mkdir data

The server expects a configuration.yml in the configuration directory. Let’s download the latest one using wget

Bash
cd config
Bash
wget https://raw.githubusercontent.com/Krillsson/sys-API/refs/heads/master/config/configuration.yml

Use your favorite text editor to edit the user & password of the config

Bash
nano configuration.yml

Then press CTRL+X to exit nano (and press Y to save)

Now we can start the container

Bash
docker run -d \
    --net=host \
    --pid=host \
    --name sys-api \
    -v ~/sys-api/data:/data \
    -v ~/sys-api/config:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /run/udev:/run/udev:ro \
    -v /run/systemd:/run/systemd \
    -v /etc/machine-id:/etc/machine-id:ro \
    -v /run/systemd/journal/socket:/run/systemd/journal/socket:ro \
    -v /run/log/journal:/run/log/journal:ro \
    -v /dev:/dev:ro \
    -v /srv:/srv:ro \
    krillsson/sys-api

Let’s verify the server started correctly

Bash
docker logs --follow --tail 200 sys-api

When you see the following, we know that the server is up and running:

Bash
[...]: Tomcat started on ports 8443 (https), 8080 (http) with context path '/'
[...]: Started SysAPIApplicationKt in 6.352 seconds (process running for 7.234)

Now you are ready to proceed to next step

Connect App to Server