Download and set up the Verdictan gateway

Choose your operating system. Install verdictan. Create policy-config.yaml. Validate it. Then start the gateway.

Download for Linux x64

CLI gateway

Download the gateway package for your operating system. Use it to apply configured policy in your development environment.

Download Debian package

Terminal

After you install verdictan, use a shell or script to complete each setup step.

curl -fsSLO https://dl.eu.verdictan.com/releases/latest/verdictan-linux-x86_64.deb

Choose a package for macOS, Windows or Linux.

0.1.0Latest release

Read the installation guide →

Setup steps

Set up the gateway

macOS (Universal)

Download the universal disk image for a Mac with Apple silicon or an Intel processor.

  1. 1

    Install the gateway

    Download the disk image. Mount it. Copy verdictan to /usr/local/bin. Then unmount the image.

    curl -fsSLO https://dl.eu.verdictan.com/releases/latest/verdictan-macos-universal.dmg
hdiutil attach verdictan-macos-universal.dmg
sudo cp /Volumes/Verdictan\ Gateway/verdictan /usr/local/bin/verdictan
hdiutil detach /Volumes/Verdictan\ Gateway
  2. 2

    Verify the installation

    Run verdictan --version. Then run verdictan doctor to check the workstation.

    verdictan --version
verdictan doctor
  3. 3

    Create a starter configuration

    Run verdictan init to create policy-config.yaml. Review the file before you route traffic.

    verdictan init
  4. 4

    Start the gateway

    Lint policy-config.yaml. Test the policy configuration. Export the runtime and upstream settings. Then start the gateway.

    verdictan policy lint --file policy-config.yaml
verdictan policy test --json
export VERDICTAN_API_TOKEN="vdt_your_gateway_runtime_token"
export VERDICTAN_UPSTREAM_URL="https://api.openai.com"
export VERDICTAN_UPSTREAM_API_KEY="sk-..."
verdictan gateway run --listen 0.0.0.0:41002 --agent local-evaluation --policy-config policy-config.yaml

Linux (x86_64)

Choose the Debian or RPM package that matches your Linux x64 system.

  1. 1

    Install the gateway

    Install the Debian or RPM package that matches your Linux distribution.

    # Debian / Ubuntu
curl -fsSLO https://dl.eu.verdictan.com/releases/latest/verdictan-linux-x86_64.deb
sudo dpkg -i verdictan-linux-x86_64.deb

# RHEL / Fedora
curl -fsSLO https://dl.eu.verdictan.com/releases/latest/verdictan-linux-x86_64.rpm
sudo rpm -i verdictan-linux-x86_64.rpm
  2. 2

    Verify the installation

    Run verdictan --version. Then run verdictan doctor to check the host.

    verdictan --version
verdictan doctor
  3. 3

    Create a starter configuration

    Run verdictan init to create policy-config.yaml. Review the file before you route traffic.

    verdictan init
  4. 4

    Start the gateway

    Lint policy-config.yaml. Test the policy configuration. Export the runtime and upstream settings. Then start the gateway.

    verdictan policy lint --file policy-config.yaml
verdictan policy test --json
export VERDICTAN_API_TOKEN="vdt_your_gateway_runtime_token"
export VERDICTAN_UPSTREAM_URL="https://api.openai.com"
export VERDICTAN_UPSTREAM_API_KEY="sk-..."
verdictan gateway run --listen 0.0.0.0:41002 --agent local-evaluation --policy-config policy-config.yaml

Linux (ARM64)

Download the archive for ARM64 Linux systems.

  1. 1

    Install the gateway

    Extract verdictan from the ARM64 archive into /usr/local/bin.

    curl -fsSL https://dl.eu.verdictan.com/releases/latest/verdictan-linux-aarch64.tar.gz \
  | sudo tar xz -C /usr/local/bin verdictan
  2. 2

    Verify the installation

    Run verdictan --version. Then run verdictan doctor to check the host.

    verdictan --version
verdictan doctor
  3. 3

    Create a starter configuration

    Run verdictan init to create policy-config.yaml. Review the file before you route traffic.

    verdictan init
  4. 4

    Start the gateway

    Lint policy-config.yaml. Test the policy configuration. Export the runtime and upstream settings. Then start the gateway.

    verdictan policy lint --file policy-config.yaml
verdictan policy test --json
export VERDICTAN_API_TOKEN="vdt_your_gateway_runtime_token"
export VERDICTAN_UPSTREAM_URL="https://api.openai.com"
export VERDICTAN_UPSTREAM_API_KEY="sk-..."
verdictan gateway run --listen 0.0.0.0:41002 --agent local-evaluation --policy-config policy-config.yaml

Windows (x86_64)

Download the Windows x64 ZIP package. Then expand it with PowerShell.

  1. 1

    Install the package

    Use PowerShell to download the ZIP package. Expand it into your local application-data directory.

    Invoke-WebRequest -Uri "https://dl.eu.verdictan.com/releases/latest/verdictan-windows-x86_64.zip" -OutFile verdictan-windows-x86_64.zip
Expand-Archive verdictan-windows-x86_64.zip -DestinationPath "$env:LOCALAPPDATA\verdictan"
  2. 2

    Verify the installation

    Add the installation directory to PATH for this session. Run verdictan --version. Then run verdictan doctor.

    $env:PATH += ";$env:LOCALAPPDATA\verdictan"
verdictan --version
verdictan doctor
  3. 3

    Create a starter configuration

    Run verdictan init to create policy-config.yaml. Review the file before you route traffic.

    verdictan init
  4. 4

    Start the gateway

    Lint policy-config.yaml. Test the policy configuration. Export the runtime and upstream settings. Then start the gateway.

    verdictan policy lint --file policy-config.yaml
verdictan policy test --json
$env:VERDICTAN_API_TOKEN = "vdt_your_gateway_runtime_token"
$env:VERDICTAN_UPSTREAM_URL = "https://api.openai.com"
$env:VERDICTAN_UPSTREAM_API_KEY = "sk-..."
verdictan gateway run --listen 0.0.0.0:41002 --agent local-evaluation --policy-config policy-config.yaml

After you install verdictan

Continue your setup

Quickstart

Validate a configuration. Then send your first governed request through the gateway.

Start the quickstart

Policy catalog

Review configurable controls for data protection, safety, compliance workflows, routing and human review.

Review policy controls

Install guide

Follow the complete installation and configuration instructions for each supported platform.

Read the installation guide

Go to the complete documentation at docs.verdictan.com.