Installing

Steps for installing Protegrity Semantic Guardrails

Prerequisites

Docker Engine version 28.0.4 or higher must be installed on your system. For detailed installation instructions and post-installation configuration, visit the Docker official documentation. Complete the post-installation steps to ensure that the Docker runs properly.

The following are the minimum system requirements for deployments:

  • RAM: 16 GB
  • CPU: 4 core

For basic usage, the system is not expected to consume over 5 GB memory.

Installing

Perform the following steps to install:

  1. Obtain Protegrity’s GenAI Security - Semantic Guardrail solution installation artifact from My.Protegrity portal.
    The artifact is a tarball file with name
    SEMANTIC-GUARDRAILS_RHUBI-ALL-64_x86-64_Generic.K8S_1.1.1.36.tgz.

  2. Unzip the file using the following command.

    tar -xzvf SEMANTIC-GUARDRAILS_RHUBI-ALL-64_x86-64_Generic.K8S_1.1.1.36.tgz
    
  3. Change the directory using the following command.

    cd Protegrity-Semantic-Guardrails
    
  4. Load the Docker image using the following command.

    docker load < semantic-guardrails-1.1.1.tar
    
  5. Start the container using the following command.

    docker run -d --name semantic-guardrails -p 8001:8001 semantic-guardrails:1.1.1
    
  6. To access PII detection capabilities, ensure that Protegrity’s Data Discovery is also installed in the same network environment. A docker-compose.yaml file integrating Data Discovery is provided with the artifact. It is recommended to update it as needed and then launch the full application as:

    docker compose up -f docker-compose.yaml
    

The installation is completed successfully. The tarball files and installation directory can be removed.
For more information on container lifecycle management, refer to the Docker official documentation.


Last modified : March 18, 2026