Guides

Preparations nad Compatibility Checks

Installation Instructions

Setting Up the Environment

Log into Docker Image Repo

To authenticate with Docker, run:

docker login -u visuallayer

When prompted for a password, copy and paste the Docker Hub access token provided by your Visual Layer representative.

Checking System Requirements

Download System Requirements Checker

curl -O https://vl-public-bucket.s3.us-east-2.amazonaws.com/installer/check_requirements.sh

Run System Requirements Checker

bash check_requirements.sh

Follow the instructions to ensure your system meets the requirements. For any issues, contact support@visual-layer.com.


Installing the Application

Download the Install Helper

curl -O https://vl-public-bucket.s3.us-east-2.amazonaws.com/installer/install_helper.sh

Run the Install Helper with Environment Variables

REPO=visuallayer VL_VERSION=2.27.0 IMAGE_PREFIX=onprem- INSTALL_DIR=. HARDWARE=cpu bash ./install_helper.sh
  • Look for the output: Installation Finished OK.
  • If there are installation issues, rerun the command with --debug for detailed logs.

Download Docker Images

docker compose -f compose.yaml --profile all pull

Note: This step may take a while as approximately 50GB of Docker images will be downloaded.

Download Models

GPU Deployment (Full Enrichment Enabled)

docker create --name tmp_model_pack visuallayer/onprem-model-pack:3.0
docker cp tmp_model_pack:/models .vl/
docker rm tmp_model_pack

Note: This step may take a while as around 30GB of model files will be downloaded.

CPU Deployment (No Enrichment)

docker create --name tmp_model_pack visuallayer/onprem-model-pack-cpu:3.0
docker cp tmp_model_pack:/models .vl/
docker rm tmp_model_pack

Setup the Docker Network

docker network create vl-net

For Airgapped Systems Only

  1. Perform the above steps on a machine connected to the Internet to download installation models.
  2. Copy the downloaded models into Docker.
  3. On an Internet-connected machine, models will be downloaded automatically.