Lucius AI
Open navigation
DOCUMENTATION

Run and connect

Secure tunnels

Connect Lucius AI browser sessions to private networks and local environments using a Tunnel Provider.

When to use a tunnel#

Use a Tunnel Provider when the application under test only runs on a private network, a local environment, or somewhere else not publicly reachable. Once connected, a Tunnel Agent on your machine bridges that environment to the Lucius AI browser sandbox.

Create a tunnel provider#

  1. 01

    Open Tunnel Providers

    Go to Project Settings → Tunnel Providers and select Create Tunnel.

  2. 02

    Name it

    Give the tunnel a unique name.

  3. 03

    Choose the platform

    Select the OS (Linux, macOS, or Windows) and architecture (x86_64, or arm64 where available) of the machine that will run the agent.

  4. 04

    Set visibility

    Choose Private to keep the tunnel scoped to the current project, or Public to share it per your project's permissions.

  5. 05

    Create it

    Review the configuration and select Create. Lucius AI generates a provider token and prepares the agent for download.

Name the tunnel, choose the platform it runs on, and set who can see it.

Managing tunnels#

The Tunnel Providers page lists every configured tunnel with its name, OS, architecture, visibility, and token. Each tunnel offers a Setup Guide, Download Agent, Edit, and Delete.

Using a tunnel#

Once the agent is installed and connected, select the tunnel when previewing or running a test case that needs to reach a private or local application. Lucius AI performs a status check, then routes that execution traffic securely through the connected agent.