This article will guide you through the installation process of SIA Connect with a Docker composer project file. A Docker composer project provides the necessary orchestration and managing of the Docker container. In addition to using Docker compose to orchestrate the Docker commands you can also execute the Docker commands manully in the terminal or use our Windows executables  to simplify the management if you are on a Windows based PC.

To get started make sure you have Docker installed and download the Docker composer project from below link:

Download SIA Connect as Docker composer project

The installation consist of the below steps which is documented in the article:

1.  Download and install the Docker composer project. Unpack it.
2.  Set the system password in the .env file in the composer project
3.  Start SIA Connect by running docker compose up from a terminal inside the directory you unpacked it to

Using the Docker composer

After downloaded the composer project you need to carry out the below instructions which we will walk through in details:

• Modify system password
• Executing the Docker composer project
• Updating images

Instant setup commands

Windows

Invoke-WebRequest -Uri "https://link.sia-connect.com/docker-compose" -OutFile "sia_connect.zip"; Expand-Archive -Path "sia_connect.zip" -DestinationPath "sia_connect"; Set-Location "sia_connect"; docker compose up

Linux

wget -O sia_connect.zip https://link.sia-connect.com/docker-compose && unzip sia_connect.zip -d sia_connect && cd sia_connect && docker compose up 

Setting system password

The system password must be set as the first thing, before running the Docker composer project. 

•  🗎 Open .env, which is the Docker composer environment file
• ✍🏻 Content looks something as below. Edit the parameter SIA_CONNECT_PASSWORD to a suitable password.
   

SIA_CONNECT_PASSWORD=SIACONNECT_ADMIN_PASSWORD

Starting the composer

To start the Docker composer with the project run the below command in the terminal while being in the same directory as the docker-compose.yml and .env file:

docker compose up

if you are on a Linux OS you can also execute the helper script included in the package:

./start_siaconnect.sh

If you need to run with a web database viewer, phpMyAdmin, you can start it in debug mode by added --profile debug to the command.

Stopping the composer

To stop the container run the following command:

docker compose stop

or if you are on Linux you can run the included helper script:

./stop_siaconnect.sh

Updating the composer images

When the image gets updated you will be noticed in the GUI portal, but in order to update the Docker images and afterwards recreate the container you will need to execute a few some Docker compose commands.

Stop the containers in the composer

docker compose down

and pull the latest images. The composer project points to latest tag of the images. If you need a specific version this should be specified in the docker-compose.yml file

docker compose pull

or if you are on Linux you can run the included helper script to update the images:

./update_siaconnect.sh

Now you can start the Docker composer project again and the containers are updated with the latest images.