Livepeer Guides Index

Curated index of every guide across the Livepeer documentation – community walkthroughs, gateway operator guides, and orchestrator pool tutorials. Aggregated from each audience tab into a single browsable HUB index.

Livepeer Guides Index

This page is the canonical index of every guide across the documentation. Each section below mirrors a guide collection maintained in an audience-specific tab; the source page remains available there with full audience context.

Source collections

Collection	Source page	Audience
Community guides	/v2/community/resources/guides	community
Gateway guides	/v2/Gateways/resources/knowledge-hub/guides	Gateway
Orchestrator guides	/v2/Orchestrators/resources/knowledge-hub/community-guides	Orchestrator

Community guides

Source: /v2/community/resources/guides

Community-produced and Foundation-supported tutorials for all Livepeer participants. Content is organised by role.

---

Delegators & LPT Holders

Delegation guide

Step-by-step: how to acquire LPT, choose an Orchestrator, and stake. Covers the Livepeer Explorer, unbonding period, and reward mechanics.

Staking in 10 Minutes

YouTube walkthrough by Titan Node - quick intro to staking for new Delegators. Listed in awesome-Livepeer.

Livepeer Primer

Visual protocol overview - useful for understanding how Delegators, Orchestrators, and Gateways fit together before staking.

Live Pioneers resources

Ecosystem recaps, Know Your Orchestrator interviews, and educational content in 8+ languages. The go-to resource for the Delegator community. (Reference: livepioneers.app)

---

Gateway Operators

Gateway setup

Full Gateway configuration - running a Livepeer broadcaster node, connecting to Orchestrators, managing costs, and handling AI workloads.

Orchestrator Pricing Visibility

Per-Orchestrator price-per-pixel data over time. Helps Gateways understand transcoding cost dynamics and select cost-efficient routing.

GWID SPE tooling

The GWID SPE (May 2025, 6,600 LPT) produced tooling to simplify Gateway operation. Check the Treasury forum for latest deliverables and status.

Propose a gateway improvement

Use the SPE process to propose and fund Gateway-relevant improvements. GovWorks provides mentorship for new proposers.

---

Orchestrators & Node Operators

Orchestrator setup

Run a Livepeer GPU node - node configuration, AI subnet setup, staking, and earnings management.

Linux setup manual

Comprehensive bare-metal Linux Orchestrator setup from Captain Stronk - the most complete community-written deployment guide available.

Video setup guide

YouTube setup walkthrough by Titan Node - covers node installation and initial configuration.

Production log monitoring

Forum guide for production-grade log monitoring and alerting. Highly recommended for operators running nodes at scale.

---

Developers

Livepeer API reference

Full API reference for the Livepeer Gateway API - endpoints, authentication, and request/response schemas.

Building a web3 video app

Community tutorials in awesome-Livepeer: full-stack TikTok clone (React Native + Lens), YouTube clone (Next.js + IPFS + The Graph), Arweave video streaming, and IPFS video upload.

Custom AI pipelines

How to build and deploy custom real-time AI pipelines using ai-runner and the BYOC (Bring Your Own Container) framework. Uses ComfyUI as a reference implementation.

Bubble plugin (no-code)

Community-supported Bubble.io plugin for adding Livepeer video to no-code apps and prototypes without writing code.

---

Governance Participation

SPE proposal guide

The complete 5-phase process from idea to on-chain vote - pre-proposal, community engagement, submission, voting, and implementation.

Livepeer Governance Process

The definitive GovWorks guide (February 2025) - covers the full governance process and community treasury mechanics in detail.

Using the Community Treasury

Livepeer Inc’s guide on how to build community support and raise awareness for treasury proposals - essential reading before submitting on-chain.

Livepeer LIPs

The Livepeer Improvement Proposals repository - protocol-level change proposals, including the LIP-89/90/91/92 treasury bundle that defines the current governance framework.

Gateway guides

Source: /v2/Gateways/resources/knowledge-hub/guides

A curated index of every how-to guide, walkthrough, and tutorial for running a Livepeer Gateway. Covers off-chain AI Gateways, remote signers, BYOC pipelines, video transcoding, payment mechanics, and production operations.

This index covers operator-side setup. If you are a developer looking to use a Gateway via the API or SDK, see the Developers tab.

Getting started

Official Gateway Setup Guide

The canonical operator quickstart in these docs. Binary or Docker, Gateway flags, verify the node is running. Start here.

Livepeer Gateway Path

Decision matrix: video vs AI Gateway, on-chain vs off-chain, hosted service vs self-hosted. Choose your entry point before touching any config.

go-livepeer Releases (GitHub)

Official binary releases for Linux (amd64 and arm64). Always download a tagged release for production use.

Why Run a Gateway

Business case for self-hosting: cost savings at scale, full Orchestrator control, lower latency, and inference fee capture.

Off-chain AI Gateway setup

These guides cover the recommended path for AI workloads: the off-chain Gateway with a remote signer, introduced in Q4 2025 via PRs #3791 and #3822.

Off-chain mode removes all Ethereum dependencies from the Gateway. No ETH, no Arbitrum RPC, no local signing key - all of that is handled by the remote signer. This is the correct starting point for all new AI Gateway deployments.

AI Gateway Quickstart (Off-chain)

Minimal command to run an off-chain AI Gateway with Docker, pointed at a community remote signer and a local or public Orchestrator.

Remote Signers: Design and Setup

Technical explanation of what a remote signer does, the signing protocol (getOrchInfoSig → signTicket), stateless design, and how to point your Gateway at one.

Elite Encoder Remote Signer (Community-hosted)

Community-hosted remote signer with free ETH for testing. Confirmed operational by Elite Encoder in #local-Gateways Discord.

Orchestrator Discovery for Off-chain Gateways

Three discovery methods: explicit orchAddr list, discovery webhook URL, or the remote signer GetOrchestrators endpoint. Python Gateway SDK examples included.

Remote Signers Design Doc (PR #3822)

Canonical technical specification for remote signing by j0sh. PM bookkeeping, state design, alternatives considered, and security implications.

AI Configuration Reference

AI-specific flags: -aiWorker, -orchAddr, -remoteSignerAddr, ports, and startup log verification.

BYOC - Bring Your Own Container

BYOC lets you attach any Docker container as a compute pipeline on the Livepeer Network. It is the primary path for running custom AI workloads - including CPU-only pipelines - without a GPU.

BYOC Smoke-Test Tutorial: CPU Gateway + Orchestrator (Off-chain)

Step-by-step: run a Gateway and Orchestrator on one machine using a CPU Docker container, test end-to-end with off-chain payments via the community remote signer, then take it to production on-chain.

Creating a Custom Live Pipeline (ai-runner)

Official guide: implement the Pipeline interface, define custom params, build a Docker image extending livepeer/ai-runner:live-base. Uses scope-runner as a reference.

Scope Runner (Reference BYOC Implementation)

Production reference implementation of a custom BYOC pipeline. Use as a template when building your own container.

BYOC Payments (PR #3866)

BYOC remote signer payments PR by Elite Encoder. Token refresh, remote signer changes for external capabilities, and how BYOC discovery differs from LV2V (no gRPC for OrchestratorInfo).

Python Gateway SDK with BYOC

livepeer-python-Gateway supports BYOC session management, Orchestrator discovery, and remote signer payments. The examples/ folder is the best starting point.

ComfyUI BYOC Integration (Elite Encoder)

BYOC implementation using livepeer-python-Gateway as a ComfyUI node backend. Tested stable for multi-minute streams with LV2V payments and remote signer from main.

Video Gateway (on-chain transcoding)

Run a Video Gateway

Full setup for a video transcoding Gateway: RTMP input on port 1935, on-chain ETH key, Arbitrum RPC, and Orchestrator connection.

On-chain Requirements

ETH deposit and reserve requirements, Arbitrum RPC setup, wallet management, and the livepeer_cli commands to deposit and activate.

Video Configuration

Video-specific flags: -broadcaster, RTMP port, transcode profiles, segment size, and webhook auth config.

Advanced Transcoding Config

Output profiles, per-capability pricing, and setbroadcastconfig CLI commands for production transcoding setups.

Bridge LPT to Arbitrum

How to move LPT from Ethereum mainnet to Arbitrum One for on-chain registration and staking.

Livepeer Explorer

Monitor your Gateway’s activity, connected Orchestrators, and payment ticket activity on-chain.

Dual Gateway (video and AI on the same node)

Dual Configuration Guide

Run video transcoding and AI inference from the same go-livepeer instance. Port assignments, flag combinations, and pitfalls to avoid.

Gateway Architecture Overview

System diagram covering on-chain Gateway, off-chain Gateway, and dual-mode operation. Updated for remote signers and the clearinghouse model.

Payments and economics

How Payments Work

PM mechanics: ticket face value, per-pixel pricing for AI inference, per-segment pricing for video, deposit/reserve lifecycle.

Pricing Configuration

Set -maxPricePerUnit and -maxPricePerCapability, format the AI pricing JSON, and understand price negotiation between Gateway and Orchestrators.

Payment Clearinghouse

What a clearinghouse is: remote signer + user management + auth + accounting. Current status (active development) and NaaP dashboard as the reference implementation.

NaaP Dashboard (JWT Auth Demo)

Network as a Platform dashboard. Implements JWT issuer service (SIWE → user-scoped JWT) and Developer API Keys. Reference for building user auth on top of a remote signer.

Arbitrum Exchanges Reference

Exchanges where you can acquire ETH on Arbitrum One for Gateway PM deposits.

Orchestrator discovery

Connect with Orchestrator Offerings

How an on-chain Gateway discovers and selects Orchestrators: stake-weighted for video, capability-based for AI.

Discover Orchestrator Offerings

Browsing available Orchestrators by capability, model support, and pricing via the Livepeer Marketplace.

select_orchestrator.py Example (SDK)

Code example: discovery via the remote signer’s GetOrchestrators endpoint, filtered by model ID and capability. First-response-wins selection strategy.

Elite Encoder: Orch List Endpoint Proposal

A simple HTTP endpoint for off-chain Gateways to retrieve a list of on-chain Orchestrators without a full Ethereum dependency. Proposed by Elite Encoder in #local-Gateways.

Monitoring and operations

Monitor and Optimise

Key metrics, ETH balance monitoring, ticket redemption rates, and log patterns indicating payment or session failures.

Gateway Introspection with Loki

Query Gateway logs via the Loki API at loki.livepeer.report. Pre-built queries for session starts, payment failures, and Orchestrator errors.

Gateway Middleware

Add auth, rate limiting, and request routing in front of your Gateway. Patterns for the Gateway-as-a-Service provider persona using go-livepeer webhook auth hooks.

Production Log Monitoring Guide (Forum)

Forum guide on structured logging, alerting, and pattern matching for production Gateway nodes. Search “Production Log Monitoring” on the forum.

tools.livepeer.cloud - Gateway Tools

Community tool suite for network operators: stream tester, Orchestrator explorer, performance dashboards. Run by the Livepeer.Cloud SPE.

Community SDKs and alternative Gateway implementations

livepeer-python-gateway (j0sh)

Reference Python Gateway SDK. Implements LV2V payments, remote signer integration, BYOC support, Orchestrator discovery, and session management. Actively maintained by j0sh (Livepeer).

OrchestratorSession Class (Elite Encoder PR)

Combines discovery, selection, payment refresh, and stream management in a single SDK entry point. Spec documented in Elite Encoder’s gist.

j0sh Ecosystem Notes Gist

j0sh’s working notes on the Gateway ecosystem: SDK design, clearinghouse thinking, discovery architecture, and open problems. Updated periodically.

Elite Encoder OrchestratorSession Spec

Spec for the OrchestratorSession class tying payment refresh, publish, and subscription together as one managed session. The foundation of the BYOC SDK work.

Gateway-as-a-Service (Provider persona)

Operator Support & Programmes

Revenue models: inference fees, SPE grants, Foundation programmes, and the NaaP approach to building a Gateway business on top of the Livepeer Network.

Livepeer.Cloud - How to Run a Gateway Node

Livepeer.Cloud SPE’s own operator guide. Real-world operational detail from an active multi-region Gateway provider.

NaaP: Network as a Platform

Dashboard and tooling for Gateway-as-a-Service operators. API key management, JWT auth, Developer API Keys, and remote signer plugin integration.

SPE Grants and Treasury Proposals

Foundation grants for Gateway operators. Existing examples include the Cloud SPE and LLM SPE. Apply via the grants programme or governance forum.

Blog posts and deep dives

A Real-Time Update to the Livepeer Network Vision (Nov 2025)

Clearest statement of the Gateway’s role: routing AI inference, 72% of fees from AI, the path to a diverse Gateway ecosystem.

Introducing Livepeer Cascade (Feb 2025)

Strategic vision. Gateways are the distribution layer for real-time AI video. Contextualises the off-chain and remote signer investment.

Building Real-Time AI Video Effects with ComfyStream (Feb 2025)

ComfyStream as a backend inference engine via a Livepeer Gateway → Orchestrator pipeline. Architecture, frame rates, and live demo.

ComfyUI and Real-Time Video AI Processing (Jan 2025)

DAG architecture, pipeline design, and real-time use cases - from the Gateway operator’s perspective.

Builder Story: StreamDiffusionTD + Daydream API (Sep 2025)

Gateway + BYOC-style pipeline powering a live generative video performance using TouchDesigner + StreamDiffusion.

Introducing Daydream Beta (Sep 2025)

Daydream is a hosted Gateway and API layer on top of the Livepeer Network. Useful reading to understand what a hosted Gateway provides before deciding whether to self-host.

Video walkthroughs

Livepeer Gateway Node Setup (YouTube - Titan Node)

Community video walkthrough of the full Gateway setup process. Covers binary install, flags, and on-chain registration.

ComfyStream Live AI Demo

Video demo of ComfyStream processing live video via a Gateway → Orchestrator pipeline with real-time AI effects.

Livepeer Dev Office Hours (bi-weekly)

Bi-weekly video calls hosted by the Foundation. ComfyUI demos, coordinated Gateway development, ecosystem priority updates. Calendar link in the Dev Hub.

Missing a guide? Open an issue at github.com/Livepeer/docs/issues or post in #lounge on Discord.

Orchestrator guides

Source: /v2/Orchestrators/resources/knowledge-hub/community-guides

Community-maintained guides, tutorials, and resources for Livepeer Orchestrators. These are not maintained by the Livepeer Foundation – verify currency before following instructions.

Have a guide to add? Open a PR or post in the Livepeer Forum.

Setup & Installation

AI Workloads

Monitoring & Operations

Economics & Strategy

Pool Operators & Workers

Video & Educational Content

Developer & Research Resources

Discord & Forum

The primary community support channel for Orchestrators is Discord. Most active troubleshooting, pricing discussion, and operational knowledge lives there.

• Discord – discord.gg/Livepeer – join #orchestrating for operator discussion
• Forum – forum.livepeer.org/c/transcoders – archived threads and longer-form operator knowledge

For troubleshooting, check the FAQ first.

See Also

FAQ & Troubleshooting

Community Pools

CLI Flags Reference