How to Set up Security Server Sidecar?

Owned by Monika LiutkutÄ— (Deactivated)
Last updated: Aug 10, 2023 by Eneli Reimets
1 min read

How to install and configure a Security Server Sidecar?

The official Security Server Sidecar user guide is available at https://github.com/nordic-institute/X-Road/blob/develop/doc/Sidecar/security_server_sidecar_user_guide.md 

Beta Versions

Beta versions of Sidecar are installed following the official installation guide. The only difference compared to an official release version is that beta versions are located in a separate docker repository maintained by NIIS. Instead of using the official docker hub repository, a snapshot repository must be used.

Docker repository to be used: https://artifactory.niis.org/xroad-sidecar-snapshot-docker/xroad-security-server-sidecar

Example command of pulling from repository: docker pull artifactory.niis.org/xroad-sidecar-snapshot-docker/xroad-security-server-sidecar:beta-7.1.0-ee

Upgrading a Security Server Sidecar running a previous version to the new snapshot version can be done following the steps described in https://github.com/nordic-institute/X-Road/blob/develop/doc/Sidecar/security_server_sidecar_user_guide.md#4-upgrading user guide section.

The only difference in the instructions would be in the step of running a container with the newer image. When passing image that should be used we need to use Artifactory docker repository path (bolded):

docker run -d \
--volumes-from <container name prev> \
... published ports and other parameters, e.g network ...
--name <container name> \
artifactory.niis.org/xroad-sidecar-snapshot-docker/xroad-security-server-sidecar:beta-<new version[-type[-variant]>

Related articles