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

  1. Download the SafeLinx Docker kit: Download HCL-SafeLinx-1450-docker-package.tar.gz from the My HCL Software Portal.
  2. Extract the installation package Extract the contents of the archive to your local directory: tar -xf HCL-SafeLinx-1450-docker-package.tar.gz

    This package contains the hcl-safelinx-1450.tar image, docker-compose.yaml, and the necessary data and cert-mount directories.

  3. 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

  1. 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.
  2. 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

What to do next
  1. If you pulled the image via Harbor (Method 2), ensure you have the docker-compose.yaml and directory structure (data/certs) set up manually or extracted from the kit.
  2. Configure your environment variables.
  3. Start the SafeLinx container: docker-compose up -d