Transcoding Orchestrator Quickstart

Run go-livepeer as a transcoding orchestrator: create your wallet, configure your node, register, and verify.

This is the canonical quickstart for running a transcoding orchestrator.

Step 1: Create and fund your ETH account

You need an Arbitrum One ETH account for on-chain Livepeer operation.

1. Create a keystore

   Use go-livepeer to initialize a keystore path:

   ./livepeer -network arbitrum-one-mainnet -ethKeystorePath ~/.lpData/keystore
   

   Store your keystore and passphrase securely.

   Never commit keystore files or passphrase files to version control.

2. Fund your account on Arbitrum One

   Add ETH to your account for gas and ticket payments.

   • Minimum recommended to start: 0.1 ETH
   • Bridge option: Arbitrum Bridge
   • Exchange options: Arbitrum exchanges

Step 2: Prerequisites

Requirement	Notes
Docker Engine installed	Install Docker
Docker Compose v2	Verify with docker compose version
ETH account funded	Complete Step 1
Open ports	8935 (orchestrator), 7935 (metrics optional)
NVIDIA drivers	Required only if enabling GPU transcoding

Step 3: Configure and run

Use this compose template as a baseline and replace placeholders.

If you are running CPU-only transcoding, remove GPU-specific runtime settings.

Start the node:

docker compose up -d docker compose logs --tail=100

Step 4: Register as an orchestrator

1. Open the Livepeer CLI

   livepeer_cli
2. Activate orchestrator settings

   Use Invoke multistep wizard in CLI, or run flags directly:

   ./livepeer \ -network arbitrum-one-mainnet \ -blockRewardCut 5.0 \ -feeShare 10.0 \ -pricePerUnit 1000 \ -pixelsPerUnit 1000000000000 \ -serviceURI https://your-orchestrator.example.com:8935

Step 5: Verify your node

curl http://localhost:7935/status livepeer_cli -cmd status

Your orchestrator should appear in the Livepeer Explorer.

Testing end-to-end with a Gateway

Once both services are running, verify an end-to-end transcoding session.

1. Point a gateway at your orchestrator

   Configure gateway routing to your orchestrator service URI:

   -orchAddr=https://your-orchestrator.example.com:8935
   
2. Send a test stream through the gateway

   Use the gateway quickstart ingest flow.

3. Confirm transcoding session logs

   Check orchestrator logs for active session creation and completion.

Gateway Quickstart

Use this to run gateway-side setup and stream validation.

Related pages

Orchestrator Job Types

Compare transcoding, realtime AI, and batch AI paths.

Install go-livepeer

Full install options and advanced flags.

Connect to Arbitrum

RPC selection and network connection guidance.

CLI flags reference

Full orchestrator flag reference.