Learn how to install go-livepeer and become an orchestrator
Depending on your workflow, you may prefer to install go-livepeer
using a
binary release, a Docker image, or from source.
There is a separate binary which supports transcoding on the NVIDIA GPU. The requirement for this binary is to have version 12 of the CUDA Toolkit installed on your machine.
At this time Livepeer does not provide automatic updates. You can perform a manual update or use a script. A community-created Bash script to update Livepeer is available on the livepeer Forum.
Packages for different Linux distributions are maintained by Livepeer community members. Before using these packages, please verify that they have been updated to use the latest builds of go-livepeer. This list will be updated as a best-effort, but we cannot guarantee if individual packages are up to date or verify their integrity.
In the future, Livepeer core contributors may publish official packages for the distributions below.
Platform | Installation | Source |
---|---|---|
Arch Linux | paru go-livepeer-bin | https://aur.archlinux.org/packages/go-livepeer-bin/ |
If you do not have Docker installed, you will need to install it using the guide here before running the commands below.
With every release, Docker images are pushed to DockerHub.
Once you’ve pulled the image, retrieve the image id and start the container.
Any flags you provide will be passed to the binary, so you can pass your configuration flags here.
Once you’ve started the container, retrieve the name and start the CLI
To pull the latest pre-release version:
Building livepeer
requires some system dependencies.
To enable transcoding using Nvidia GPUs on Linux systems
LIBRARY_PATH
clang
must be installed as well. The script that will install ffmpeg
dependencies uses which clang
command to determine whether clang
is installed or not. Please check this on your system. If the path is empty, please install clang
. For example on the Ubuntu machine one can doBuilding livepeer
requires Go. Follow the
official Go installation instructions.
ffmpeg
dependencies:Set the PKG_CONFIG_PATH
variable so that pkg-config
can find the ffmpeg
dependency files installed in step 2:
Set the BUILD_TAGS
variable to enable mainnet support:
livepeer
:You may encounter the following issue when running the livepeer
binary.
This means that you have installed the Livepeer GPU binary but it is unable to access your CUDA Toolkit libraries. If you do not intend to use GPU transcoding, please download livepeer
instead of livepeer-gpu
. However, if you wish to use GPU transcoding, please ensure that the CUDA Toolkit is installed and add its path to the shared libraries path.
Learn how to install go-livepeer and become an orchestrator
Depending on your workflow, you may prefer to install go-livepeer
using a
binary release, a Docker image, or from source.
There is a separate binary which supports transcoding on the NVIDIA GPU. The requirement for this binary is to have version 12 of the CUDA Toolkit installed on your machine.
At this time Livepeer does not provide automatic updates. You can perform a manual update or use a script. A community-created Bash script to update Livepeer is available on the livepeer Forum.
Packages for different Linux distributions are maintained by Livepeer community members. Before using these packages, please verify that they have been updated to use the latest builds of go-livepeer. This list will be updated as a best-effort, but we cannot guarantee if individual packages are up to date or verify their integrity.
In the future, Livepeer core contributors may publish official packages for the distributions below.
Platform | Installation | Source |
---|---|---|
Arch Linux | paru go-livepeer-bin | https://aur.archlinux.org/packages/go-livepeer-bin/ |
If you do not have Docker installed, you will need to install it using the guide here before running the commands below.
With every release, Docker images are pushed to DockerHub.
Once you’ve pulled the image, retrieve the image id and start the container.
Any flags you provide will be passed to the binary, so you can pass your configuration flags here.
Once you’ve started the container, retrieve the name and start the CLI
To pull the latest pre-release version:
Building livepeer
requires some system dependencies.
To enable transcoding using Nvidia GPUs on Linux systems
LIBRARY_PATH
clang
must be installed as well. The script that will install ffmpeg
dependencies uses which clang
command to determine whether clang
is installed or not. Please check this on your system. If the path is empty, please install clang
. For example on the Ubuntu machine one can doBuilding livepeer
requires Go. Follow the
official Go installation instructions.
ffmpeg
dependencies:Set the PKG_CONFIG_PATH
variable so that pkg-config
can find the ffmpeg
dependency files installed in step 2:
Set the BUILD_TAGS
variable to enable mainnet support:
livepeer
:You may encounter the following issue when running the livepeer
binary.
This means that you have installed the Livepeer GPU binary but it is unable to access your CUDA Toolkit libraries. If you do not intend to use GPU transcoding, please download livepeer
instead of livepeer-gpu
. However, if you wish to use GPU transcoding, please ensure that the CUDA Toolkit is installed and add its path to the shared libraries path.