Page is under construction.
Check the github issues for ways to contribute! Or provide your feedback in this quick form
Check the github issues for ways to contribute! Or provide your feedback in this quick form
Gateway Modes
You can run a gateway- Off-chain -> dev or local mode
- On-chain -> production mode connected to the blockchain-based Livepeer network.
Gateway Capabilities
You can run a Gateway for:- Video Only -> traditional transcoding services
- AI Only -> AI inference services
- Dual: AI & Video -> both video transcoding and AI inference services
Quick OS Table
| OS | Install Method | Gateway | Orchestrator / AI Worker | Notes |
|---|---|---|---|---|
| macOS (Intel / Apple) | Build from source (Go) | ✅ Yes | ❌ No | Best for local dev & routing. Docker often fails on macOS. |
| Windows (Native) | Not supported | ❌ No | ❌ No | No native Windows binaries intended for production. |
| Windows (WSL2 + Docker) | Docker (Linux via WSL2) | ✅ Yes | ⚠️ Limited / fragile | Effectively Linux-in-WSL. GPU needs NVIDIA + CUDA for WSL. |
| Linux (Ubuntu recommended) | Docker or source build | ✅ Yes | ✅ Yes (NVIDIA GPU) | Only OS suitable for production Orchestrators & AI workers. |
Gateway Set Up Requirements
Technical Knowledge
Dual AI & Video A basic understanding of system administration and CLI tooling… or know how to ask AI for help :)
Hardware Requirements
Dual AI & Video Gateways do not require GPU resources, but must be able to handle high network throughput.
This is necessary to route requests between applications and Orchestrators.
A typical setup includes
- 4–8 CPU cores
- 16–32 GB RAM
- High-speed NVMe (optional, recommended)
- Stable multi-region networking
- Linux or containerised deployment environment
Network Requirements
Dual AI & Video Your Gateway must be reachable and responsive.
- Public HTTPs endpoint
- Low-latency connectivity to Orchestrators
- Ability to handle high request throughput
- Multi-region deployment or failover
- Static IP or domain name (required for production)
OS & Software Requirements
Gateways install the Go-Livepeer Gateway Software.Installation requires the following OS with root or sudo access:
Installation is covered in detail in theInstallation Guide
Video Only Gateway:
- Linux, Windows or Docker containerised deployment environment
AI or Dual Gateway:
- Linux OS (Windows and macOS support coming soon)
Installation is covered in detail in theInstallation Guide
Additional Requirements
Dual AI & Video You can run a gateway
- Off-chain -> dev or local mode
- On-chain -> production mode connected to the blockchain-based Livepeer network.
- Off-Chain Gateways
- On-Chain Gateways
Additional requirements apply when running a Gateway in off-chain mode:You will need to run an Orchestrator Node locally to test Gateway functionality.
This requires that you
Off-chain mode is ideal for: Have a GPU available (locally or cloud) with root or sudo access
Setup the GPU as an Orchestrator per the Orchestrator Setup Guide
- Local development and testing
- Learning the gateway functionality
- Prototyping without financial commitments
- Running private transcoding infrastructure