Installing SafeLinx using a Docker container
There are two ways to obtain the SafeLinx Docker image: downloading a tar archive
from the HCL Software Portal or pulling the image directly from the HCL Container Registry
(hclcr.io).
Method 1: Loading the SafeLinx-docker tar archive file
Use this method if you have downloaded the full package as a compressed file.
Procedure
- Download the SafeLinx Docker kit: Download HCL-SafeLinx-1450-docker-package.tar.gz from the My HCL Software Portal.
-
Extract the installation package Extract the contents of the archive to your
local directory:
tar -xf HCL-SafeLinx-1450-docker-package.tar.gzThis package contains the
hcl-safelinx-1450.tarimage,docker-compose.yaml, and the necessary data and cert-mount directories. -
Load the image to Docker Load the image archive into your local Docker
registry:
docker load --input hcl-safelinx-1450.tar
Method 2: Pulling the SafeLinx image from the HCL Container Registry
Use this method to pull the image directly from the HCL Harbor registry. This requires an authorized HCL account.
Procedure
- Login to the HCL Container Registry Log in to the registry using your HCL
Software Portal credentials:
docker login hclcr.io -u <yourEmailAddress>Note: When prompted, enter your portal password or your generated CLI API key. - Pull the SafeLinx image Use the docker pull command to download the specific
version of SafeLinx:
docker pull hclcr.io/hcl-safelinx/safelinx-server:<imageTag>(Example tag: 14.5.0)
Results
Once the image is loaded or pulled, you can verify its presence by running:
docker images
- If you pulled the image via Harbor (Method 2), ensure you have the
docker-compose.yamland directory structure (data/certs) set up manually or extracted from the kit. - Configure your environment variables.
- Start the SafeLinx container:
docker-compose up -d