Skip to main content
You can install go-livepeer using a binary release, Docker, or by building from source. Docker is the most common choice for production.

Prerequisites

  • Dependencies (binary): curl, coreutils, gnupg2 (Linux) or gnupg (macOS).
  • Docker (Docker install): Install Docker and, for GPU support, NVIDIA Container Toolkit.
  • GPU (transcoding): NVIDIA driver; for Linux GPU binary or build from source, CUDA Toolkit (e.g. v12).

Binary release

Replace <RELEASE_VERSION> with a release tag (e.g. v0.5.35) and <ARCH> with amd64 or arm64.

Darwin (macOS)

Linux

Linux (GPU / NVIDIA)

Use the GPU build if you will run transcoding on NVIDIA GPUs. Requires CUDA 12.

Windows

Livepeer does not provide automatic updates. You can update manually or use a community script (e.g. Forum: Bash script to update Livepeer).

Docker

Images are published to Docker Hub. For the latest pre-release:
docker pull livepeer/go-livepeer:master
Run with your config flags; for GPU support use --gpus all: To use the CLI from the host:

Build from source

  1. System deps (Ubuntu 20.04+):
apt-get -y install protobuf-compiler-grpc golang-goprotobuf-dev yasm pkg-config
  1. Go: Install Go.
  2. Clone and build:
git clone https://github.com/livepeer/go-livepeer.git cd go-livepeer ./install_ffmpeg.sh export PKG_CONFIG_PATH=~/compiled/lib/pkgconfig export BUILD_TAGS=mainnet make cp livepeer* /usr/local/bin
For GPU support on Linux, install the CUDA Toolkit and set LIBRARY_PATH; install clang if required by the ffmpeg script.

Activate

After installation, run the node in orchestrator mode, fund your account with ETH and LPT, then activate:
  1. Run livepeer_cli and choose the multi-step “become an orchestrator” option.
  2. Set block reward cut and fee share (percent kept vs shared with delegators).
  3. Set pixels per unit and price per unit (wei).
  4. Set service address (must match -serviceAddr used when starting the node).
  5. Bond LPT (amount in LPTU, e.g. 5000000000000000000 for 5 LPT).
  6. Wait for transactions to confirm; your orchestrator joins the active set in the next round.
See Staking LPT and Rewards and fees for economics. Check the Explorer to confirm your node and the current minimum stake for the top 100.

See also

Last modified on February 18, 2026