Application Start

With all files and configurations from the previous sections ready, it's time to start the container based on the downloaded image. This chapter will guide you through the process of running aqilink within the Docker container runtime.

info

To start the container in any runtime other than Docker, the steps may vary and will need to be adapted accordingly.

Gathering Necessary Files

To make aqilink work with the desired configuration, the files and folders that have been adapted and created in the previous chapters should be mapped into their corresponding directories inside the container. Refer to the file mapping below to find the detailed mapping table.

tip

We suggest collecting all required files and folders in a newly created separate folder, mapping its contents to the related paths in the container, and using it as the single source of truth for any further configurations related to the container.

Create a new folder and copy the following elements into it:

• The /configs/ folder with all the configuration files that have been created and adapted.
  Refer to Configuration Files.
• The private key file of the generated key pair for password encryption/decryption.
  Refer to Password Encryption.

The structure of the folder should look like:

File Mapping

The required file and folder mapping to run the container.

Path on Local Machine	Path in Container	Description
/configs	/app/configs	Map the configuration files. Refer to Overview of File Structure.
privateKey.pem	/app/configs/privateKey.pem	Map the private key file for password encryption. Refer to chapter Password Encryption, also refer to setting privateKeyPath in the app.yaml.

Docker Compose

The following example demonstrates the mapping based on the table above using a Docker compose.yaml file.

Example

services:
  aqilink:
      image: ghcr.io/aqipro/aqilink:latest
      volumes:
        - ./configs:/app/configs
        - ./privateKey.pem:/app/configs/privateKey.pem
      restart: always

Start the container by running the following Docker command:

Windows PowerShell

docker compose -f compose.yaml up -d

Refer to the next chapter Configuration to learn how to setup a connection from SAP S/4HANA to a storage system with aqilink.