Configuración de video

Ugh I hate this page. I think its best to move everything to quickstart and have this be a comprehensive flag overview

TL;DR Configuración

Si solo quieres una pasarela de video funcional, usa el siguiente comando:

Off-Chain
On-Chain

Replace with your locally running orchestrator http address.

Off-Chain Video Gateway

livepeer -gateway \
  -network offchain \
  # Minimum required video flags
  -rtmpAddr=0.0.0.0:1935 \
  -httpAddr=0.0.0.0:8935 \
  -transcodingOptions=P240p30fps16x9,P360p30fps16x9 \
  # You will need to add your local orchestrator address if you are running off-chain
  -orchAddr=<ORCHESTRATOR_ADDRESSES> #comma separated list of orchestrator addresses
  # Example: -orchAddr=http://192.168.1.100:8935,http://192.168.1.101:8935
  # You can also use a JSON file: -orchAddr=/path/to/orchestrators/orchestrators-portal.json

Replace with publicly available orchestrator addresses.

On-Chain Video Gateway

livepeer -gateway \
  -network arbitrum-one-mainnet \
  # See the on-chain setup guide for more details on these flags
  -ethUrl=<YOUR_RPC_URL> \
  -ethAcctAddr=<YOUR_ETH_ADDRESS> \
  -ethPassword=<YOUR_PASSWORD> \
  -ethKeystorePath=<KEYSTORE_PATH> \
  # Minimum required video flags
  -rtmpAddr=0.0.0.0:1935 \
  -httpAddr=0.0.0.0:8935 \
  -transcodingOptions=P240p30fps16x9,P360p30fps16x9 \
  # Price per unit is required on-chain (see pricing guide)
  -maxPricePerUnit=1000 \
  # You will need to connect to a public orchestrator if you are running onchain
  -orchAddr=<ORCHESTRATOR_ADDRESSES> #comma separated list of orchestrators
  # Example:  -orchAddr=https://orch1.example.com:8935,https://orch2.example.com:8935
  # You can also use a JSON file: -orchAddr=/path/to/orchestrators/orchestrators-portal.json

Livepeer does not currently maintain a list of publicly available Orchestrators. You need to discover them through:

Livepeer CLI: Use livepeer_cli → Option 9: “List registered orchestrators”
Network discovery: The gateway discovers orchestrators from the on-chain registry
Community resources: Check Livepeer community channels or documentation

Jump to the Connect Guide for details on connecting to orchestrators.

OVERVIEW

Pasarelas para codificación de video En la codificación de video tradicional, la pasarela ingiere flujos de video a través deRTMP oHTTP, segmentos ellos y distribuye el trabajo de transcodificación a los Orchestrators

Code Reference

go-livepeer/core/livepeernode.go

Marcas de Configuración Esenciales

Marcas Necesarias

-gateway

boolean

predeterminado:"false"

requerido

Enable Gateway mode

-network

string

predeterminado:"offchain"

Set to the blockchain network for production gateways arbitrum-one-mainnet

-orchAddr

string

predeterminado:"none"

requerido

Set to http://<ORCHESTRATOR_IP>:<PORT> to connect to orchestrators

Configuración de la Red

-rtmpAddr

string

predeterminado:"127.0.0.1:1935"

Set to 0.0.0.0:1935 to allow external RTMP connections

-httpAddr

string

predeterminado:"127.0.0.1:8935"

Set to 0.0.0.0:8935 to allow external HLS/API access

Configuración de Transcodificación

-transcodingOptions

string

predeterminado:"P240p30fps16x9,P360p30fps16x9"

Set to path/to/transcodingOptions.json to use a custom transcoding configuration

Marcas Adicionales en la Cadena

Agregue estas banderas para la configuración en cadena. Vea On-Chain Setup Guide para más detalles.

-network

string

predeterminado:"offchain"

-maxPricePerUnit

int

predeterminado:"0"

-ethUrl

string

predeterminado:"none"

requerido

-ethAcctAddr

string

predeterminado:"leave empty to auto-create"

-ethPassword

string

predeterminado:"leave empty to auto-create"

-ethKeystorePath

string

predeterminado:"leave empty to auto-create"

FULL CONFIGURATION GUIDE

Guía completa de configuración

Métodos de configuración

Tiene tres formas de configurar su puerta de enlace Livepeer después de la instalación:

Banderas de línea de comandos (más común)
Variables de entorno (prefijadas con LP_)
Archivo de configuración (formato clave-valor de texto plano)

Ejemplos de configuración

Los siguientes ejemplos muestran los métodos de configuración más comunes.

CLI
Config File
Env Variables
Docker
Binary

Create docker-compose.yml

# 1. Create a basic docker-compose.yml
cat > docker-compose.yml << EOF
version: '3.9'
services:
  gateway:
    image: livepeer/go-livepeer:master
    ports:
      - 1935:1935  # RTMP ingest
      - 8935:8935  # HLS/API
    volumes:
      - gateway-data:/root/.lpData
    command: |
      -gateway
      -network offchain
      -rtmpAddr=0.0.0.0:1935
      -httpAddr=0.0.0.0:8935
      -orchAddr=https://orchestrator.example.com:8935
      -transcodingOptions=P240p30fps16x9,P360p30fps16x9,P720p30fps16x9

volumes:
  gateway-data:
EOF

Start the Gateway

Start the gateway

# 2. Start the gateway
docker-compose up -d

livepeer -gateway \
  -network offchain \
  -transcodingOptions=${env:HOME}/.lpData/offchain/transcodingOptions.json \
  -orchAddr=0.0.0.0:8935 \
  -httpAddr=0.0.0.0:9935 \
  -v=6

Docker
Binary

Create docker-compose.yml

# 1. Create a basic docker-compose.yml
cat > docker-compose.yml << EOF
version: '3.9'
services:
  gateway:
    image: livepeer/go-livepeer:master
    ports:
      - 1935:1935  # RTMP ingest
      - 8935:8935  # HLS/API
    volumes:
      - gateway-data:/root/.lpData
    command: |
      -gateway
      -network arbitrum-one-mainnet
      -rtmpAddr=0.0.0.0:1935
      -httpAddr=0.0.0.0:8935
      -orchAddr=https://orchestrator.example.com:8935
      -transcodingOptions=P240p30fps16x9,P360p30fps16x9,P720p30fps16x9
      -ethUrl <YOUR_RPC_URL> \
      -ethAcctAddr <YOUR_ETH_ADDRESS> \
      -ethPassword <YOUR_PASSWORD> \
      -ethKeystorePath <KEYSTORE_PATH> \
      -maxPricePerUnit 1000

volumes:
  gateway-data:
EOF

Start the Gateway

Start the gateway

# 2. Start the gateway
docker-compose up -d

livepeer -gateway \
  -network arbitrum-one-mainnet \
  -ethUrl=<YOUR_RPC_URL> \
  -ethAcctAddr=<YOUR_ETH_ADDRESS> \
  -ethPassword=<YOUR_PASSWORD> \
  -ethKeystorePath=<KEYSTORE_PATH> \
  -maxPricePerUnit=1000 \
  -orchAddr=<ORCHESTRATOR_ADDRESSES> \
  -monitor=true

Opciones de transcodificación JSON

Livepeer admite archivos de configuración JSON para opciones de transcodificación a través de la -transcodingOptions bandera. El archivo transcodingOptions.json le permite controlar con precisión la escalera de codificación. Este archivo es un archivo de configuración personalizado que contiene una matriz de objetos de reproducción que define qué reproducciones (resoluciones + tasas de bits) su Gateway producirá para cada transmisión entrante. Sustituye la escalera integrada predeterminada (por ejemplo, P240p30fps16x9, etc.).

transcodingOptions.json example

[
  {
    // required
    "bitrate": 1600000,
    "width": 854,
    "height": 480,
    // optional
    "name": "480p0",
    "fps": 0,
    "profile": "h264constrainedhigh",
    "gop": "1"
  },
  {
    // required
    "bitrate": 3000000,
    "width": 1280,
    "height": 720,
    // optional
    "name": "720p0",
    "fps": 0,
    "profile": "h264constrainedhigh",
    "gop": "1"
  },
  {
    // required
    "bitrate": 6500000,
    "width": 1920,
    "height": 1080,
    // optional
    "name": "1080p0",
    "fps": 0,
    "profile": "h264constrainedhigh",
    "gop": "1"
  }
]

Notas

La configuración JSON solo se aplica a las opciones de codificación, no a otras banderas de gateway
El archivo debe contener JSON válido con la estructura especificada
Todos los campos son opcionales excepto width, height y bitrate
Puedes combinar la configuración JSON con otras banderas de línea de comandos

Next Step: Pricing Configuration

Configure pricing for your gateway.

Referencia de banderas de configuración completa

Cambios esenciales

Option	Recommended Change	Why

Configuración de red

Option	Default	Recommended	Description

Configuración de transcodificación

Option	Default	When to Change	Description

Consideraciones de producción

Option	Recommended Setting	Use Case

Mostrar >_ Configuration Options

Category	Flag	Default	Description

Mostrar old docs

Modify Config Files

Docker Config (Recommended)
Linux Config
Windows Config

Create the transcodingOptions.json file using the above template.

nano -p /var/lib/docker/volumes/gateway-lpData/_data/transcodingOptions.json

Modify the docker-compose.yml file from the root user’s home directory /root/ and add the following below -pixelsPerUnit=1

-transcodingOptions=/root/.lpData/transcodingOptions.json

Create the transcodingOptions.json file using the above template.

sudo nano /usr/local/bin/lptConfig/transcodingOptions.json

Modify the Linux Service file /etc/systemd/system/livepeer.service and add the following below -pixelsPerUnit=1

-transcodingOptions=/usr/local/bin/lptConfig/transcodingOptions.json \

Create the transcodingOptions.json file using the above template.Open notepad (or your text editor of choice) paste the template above and save the transcodingOptions.json file in the following location.In Windows, %USERNAME% is already a built-in environment variable -> You can use it directly.

C:\Users\%USERNAME%\.lpData\transcodingOptions.json

Modify Windows bat file to include the following command after -pixelsPerUnit=1

-transcodingOptions=C:\Users\%USERNAME%\.lpData\transcodingOptions.json

Gateway Knowledge Hub

Quickstart ⚡

Gateway Services & Providers

Run A Gateway

Gateway Tools & Resources

Technical References

TL;DR Configuración

Code Reference

Marcas de Configuración Esenciales

Marcas Necesarias

Configuración de la Red

Configuración de Transcodificación

Marcas Adicionales en la Cadena

Guía completa de configuración

Métodos de configuración

Ejemplos de configuración

Opciones de transcodificación JSON

Notas

Next Step: Pricing Configuration

Referencia de banderas de configuración completa

Cambios esenciales

Configuración de red

Configuración de transcodificación

Consideraciones de producción

Modify Config Files

Gateway Knowledge Hub

Quickstart ⚡

Gateway Services & Providers

Run A Gateway

Gateway Tools & Resources

Technical References

​TL;DR Configuración

Code Reference

​Marcas de Configuración Esenciales

​Marcas Necesarias

​Configuración de la Red

​Configuración de Transcodificación

​Marcas Adicionales en la Cadena

​Guía completa de configuración

​Métodos de configuración

​Ejemplos de configuración

​Opciones de transcodificación JSON

​Notas

Next Step: Pricing Configuration

​Referencia de banderas de configuración completa

​Cambios esenciales

​Configuración de red

​Configuración de transcodificación

​Consideraciones de producción

​Modify Config Files

TL;DR Configuración

Marcas de Configuración Esenciales

Marcas Necesarias

Configuración de la Red

Configuración de Transcodificación

Marcas Adicionales en la Cadena

Guía completa de configuración

Métodos de configuración

Ejemplos de configuración

Opciones de transcodificación JSON

Notas

Referencia de banderas de configuración completa

Cambios esenciales

Configuración de red

Configuración de transcodificación

Consideraciones de producción

Modify Config Files