Connect a Livepeer Gateway on Docker, Linux, or Windows

Connect your Livepeer Gateway to the network. Orchestrator discovery, selection tuning, and service publication for Docker, Linux, and Windows.

Connect Your Gateway

Connect your Livepeer Gateway to Orchestrators and the network for , Pipelines, or service routing.

This guide covers:

• manual connection via -orchAddr (pin specific Orchestrators)
• automatic discovery via the Livepeer network on Arbitrum
• Verification that Orchestrators are discovered and reachable
• Service publication to make the Gateway accessible to clients
• Selection tuning for price caps, performance scoring, and blocklists

Complete the Install and Configure steps before connecting. Once connected, proceed to Verify to confirm end-to-end operation.

Orchestrator Discovery Overview

Gateways discover Orchestrators through two mechanisms, depending on the operational mode.

Off-chain (manual)

Off-chain Gateways use a static list of known Orchestrators passed via -orchAddr. The Gateway round-robins across this list and does not discover others.

This is the recommended approach for:

• Production AI workloads where you need control over which Orchestrators handle inference
• Private deployments that do not interact with the public network
• Testing environments with a known Orchestrator

To update the list, restart the Gateway with a modified -orchAddr value. For dynamic updates without restarts, use -orchWebhookUrl instead.

On-chain (automatic)

On-chain Gateways discover Orchestrators automatically by querying the BondingManager smart contract on Arbitrum. The Gateway:

1. Queries all registered Orchestrators from the contract
2. Fetches capabilities, pricing, and performance metrics from each
3. Filters by price limits (-maxPricePerUnit, -maxPricePerCapability)
4. Scores candidates using stake, price, and randomness weights
5. Updates the pool every 25 minutes

This requires an Arbitrum RPC connection (-ethUrl) and ETH in the Gateway account for transactions.

For AI workloads, add -aiServiceRegistry to register with the on-chain AI service registry and enable automatic AI Orchestrator discovery.

Related Pages

Orchestrator Selection

Scoring weights, tiering strategies, failover, and blocklists.

Gateway Discoverability

DNS, HTTPS, capability advertising, and on-chain registration.

Marketplace Overview

How Orchestrators publish offerings and Gateways discover them.

Configuration Flags

Full reference for all Gateway configuration flags.