ActivityPub-federated video streaming platform using P2P directly in your web browser
Dependencies
:warning: Warning: dependencies guide is maintained by the community. Some parts may be outdated! :warning:
Main dependencies supported by PeerTube:
nodeLTS (>= 22.12 and <25)pnpm>= 10.xpostgres>=14.xredis-server>=6.2ffmpeg>=4.3 (using a ffmpeg static build is not recommended)python>=3.8pip
note: only LTS versions of external dependencies are supported. If no LTS version matching the version constraint is available, only release versions are supported.
note: some distributions still ship a PostgreSQL older than 14 in their default repositories. Check with psql --version after
installing, and if it is too old, install a supported release from the
PostgreSQL official repositories instead of the distribution package.
[[toc]]
Debian / Ubuntu and derivatives
On a fresh Debian/Ubuntu, as root user, install basic utility programs needed for the installation
sudo apt-get install curl sudo unzip vimIt would be wise to disable root access and to continue this tutorial with a user with sudoers group access. You can see a guide for how to do this in Debian/Ubuntu here.
Install NodeJS 22.x: https://nodesource.com/products/distributions
Install PNPM:
sudo npm install -g pnpmInstall Python:
sudo apt update sudo apt install python3-dev python3-pip python-is-python3 python --version # Should be >= 3.8Install common dependencies:
sudo apt update sudo apt install certbot nginx ffmpeg postgresql postgresql-contrib openssl g++ make redis-server git cron wget ffmpeg -version # Should be >= 4.1 g++ -v # Should be >= 5.x redis-server --version # Should be >= 6.x psql --version # Should be >= 14Debian 11 (bullseye) and Ubuntu 20.04 ship PostgreSQL 13 or older: on these releases install PostgreSQL from the PostgreSQL APT repository instead.
Now that dependencies are installed, before running PeerTube you should start PostgreSQL and Redis:
sudo systemctl start redis postgresql
Arch Linux
Run:
sudo pacman -S nodejs-lts-iron ffmpeg postgresql openssl redis git wget unzip python python-pip base-devel npm nginx pnpm
Now that dependencies are installed, before running PeerTube you should start PostgreSQL and Redis:
sudo systemctl start redis postgresql
CentOS 7
Install NodeJS 22.x: https://nodesource.com/products/distributions
Install PNPM:
sudo npm install -g pnpmInstall or compile ffmpeg:
Install Packages:
sudo yum update sudo yum install epel-release centos-release-scl sudo yum update sudo yum install nginx postgresql postgresql-server postgresql-contrib openssl gcc-c++ make wget redis git devtoolset-7:warning: The CentOS 7 base repository provides PostgreSQL 9.2, which is too old for PeerTube. Install PostgreSQL >= 14 from the PostgreSQL Yum repository instead of the
postgresql*packages above.You need to use a more up to date version of G++ in order to run the
npm run install-node-dependenciescommand, hence the installation of devtoolset-7.sudo scl enable devtoolset-7 bashLater when you invoke any node command, please prefix them with
CC=/opt/rh/devtoolset-7/root/usr/bin/gcc CXX=/opt/rh/devtoolset-7/root/usr/bin/g++, such as with:sudo -H -u peertube CC=/opt/rh/devtoolset-7/root/usr/bin/gcc CXX=/opt/rh/devtoolset-7/root/usr/bin/g++ npm run install-node-dependencies -- --productionInitialize the PostgreSQL database:
sudo PGSETUP_INITDB_OPTIONS='--auth-host=md5' postgresql-setup --initdb --unit postgresql
Now that dependencies are installed, before running PeerTube you should enable and start PostgreSQL and Redis:
sudo systemctl enable --now redis
sudo systemctl enable --now postgresql
Centos 8
Install NodeJS 22.x: https://nodesource.com/products/distributions
Install PNPM:
sudo npm install -g pnpmInstall or compile ffmpeg:
sudo dnf install epel-release dnf-utils sudo yum-config-manager --set-enabled powertools sudo yum-config-manager --add-repo=https://negativo17.org/repos/epel-multimedia.repo sudo dnf install ffmpegInstall packages:
sudo dnf update sudo dnf install epel-release sudo dnf update sudo dnf module enable postgresql:16 # Default stream is PostgreSQL 10, too old for PeerTube sudo dnf install nginx postgresql postgresql-server postgresql-contrib openssl gcc-c++ make wget redis git unzip psql --version # Should be >= 14Use
sudo dnf module list postgresqlto see the streams available on your release, and pick the most recent one >= 14.You'll need a symlink for python3 to python for youtube-dl to work
sudo ln -s /usr/bin/python3 /usr/bin/pythonInitialize the PostgreSQL database:
sudo PGSETUP_INITDB_OPTIONS='--auth-host=md5' postgresql-setup --initdb --unit postgresql
Now that dependencies are installed, before running PeerTube you should enable and start PostgreSQL and Redis:
sudo systemctl enable --now redis
sudo systemctl enable --now postgresql
Rocky Linux 8.4
Pull the latest updates:
sudo dnf update -yInstall NodeJS 22.x:
sudo dnf module install -y nodejs:22Install PNPM:
sudo npm install --global pnpmInstall or compile ffmpeg (if you want to compile... enjoy):
sudo dnf install -y epel-release sudo dnf --enablerepo=powertools install -y SDL2 SDL2-devel sudo dnf install -y --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-8.noarch.rpm https://download1.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-8.noarch.rpm sudo dnf install -y ffmpeg sudo dnf update -yInstall PostgreSQL and Python3 and other stuff:
sudo dnf module enable -y postgresql:16 # Default stream is PostgreSQL 10, too old for PeerTube sudo dnf install -y nginx postgresql postgresql-server postgresql-contrib openssl gcc-c++ make wget redis git python3 python3-pip psql --version # Should be >= 14 sudo ln -s /usr/bin/python3 /usr/bin/python sudo PGSETUP_INITDB_OPTIONS='--auth-host=md5' postgresql-setup --initdb --unit postgresql sudo systemctl enable --now redis sudo systemctl enable --now postgresqlUnknown missing steps:
- Steps missing here... these were adapted from the CentOS 8 steps which abruptly ended.
- /var/www/peertube does not exist yet (expected? done in future steps? documentation?).
- Nothing about Certbot, NGINX, Firewall settings, and etc.
- Hopefully someone can suggest what is missing here with some hints so I can add it?
Fedora
Upgrade your packages:
dnf upgrade(Optional) Install certbot (choose instructions for your distribution): https://certbot.eff.org/all-instructions
Install NodeJS 22.x: https://nodesource.com/products/distributions
Install PNPM:
sudo npm install --global pnpmEnable RPM Fusion for Fedora (available for x86, x86_64, armhfp)
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpmThis is necessary because
ffmpegis not in the Fedora repos.Run:
sudo dnf install nginx ffmpeg postgresql-server postgresql-contrib openssl gcc-c++ make redis git vim ffmpeg -version # Should be >= 4.1 g++ -v # Should be >= 5.x redis-server --version # Should be >= 6.xConfigure nginx
sudo mkdir /etc/nginx/sites-available sudo mkdir /etc/nginx/sites-enabled sudo ln -s /etc/nginx/sites-enabled/peertube /etc/nginx/conf.d/peertube.confPost-installation
from PostgreSQL documentation:
Due to policies for Red Hat family distributions, the PostgreSQL installation will not be enabled for automatic start or have the database initialized automatically.
# PostgreSQL sudo PGSETUP_INITDB_OPTIONS='--auth-host=md5' postgresql-setup --initdb --unit postgresql sudo systemctl enable postgresql.service sudo systemctl start postgresql.service # Nginx sudo systemctl enable nginx.service sudo systemctl start nginx.service # Redis sudo systemctl enable redis.service sudo systemctl start redis.serviceFirewall
By default, you cannot access your server via public IP. To do so, you must configure the firewall.
Ports used by peertube dev setup:
sudo firewall-cmd --permanent --zone=public --add-port=3000/tcp sudo firewall-cmd --permanent --zone=public --add-port=9000/tcp- Optional
sudo firewall-cmd --permanent --zone=public --add-service=http sudo firewall-cmd --permanent --zone=public --add-service=https- Reload firewall
sudo firewall-cmd --reloadConfigure max ports
This is necessary if you are running dev setup, otherwise you will have errors with
nodemonecho fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
Red Hat Enterprise Linux 8
Register system as root user to Red Hat Subscription Management (create a free Red Hat account if you don't have one yet).
subscription-manager register --username <username> --password <password> --auto-attach dnf upgrade rebootInstall NodeJS
sudo dnf module install nodejs:22Install PNPM:
sudo npm install --global pnpmInstall FFmpeg
sudo subscription-manager repos --enable "codeready-builder-for-rhel-8-$(arch)-rpms" sudo dnf install --nogpgcheck https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm sudo dnf install --nogpgcheck https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-8.noarch.rpm sudo dnf upgrade sudo dnf install ffmpegRun:
sudo dnf module enable postgresql:16 # Default stream is PostgreSQL 10, too old for PeerTube sudo dnf install nginx postgresql postgresql-server postgresql-contrib openssl gcc-c++ make wget redis git psql --version # Should be >= 14You'll need a symlink for python3 to python for youtube-dl to work
sudo alternatives --set python3 /usr/bin/pythonInitialize the PostgreSQL database:
sudo PGSETUP_INITDB_OPTIONS='--auth-host=md5' postgresql-setup --initdb --unit postgresqlNow that dependencies are installed, before running PeerTube you should enable and start PostgreSQL and Redis:
sudo systemctl enable --now redis sudo systemctl enable --now postgresqlIf you are running the production guide, you also need to slightly pre-configure nginx, because nginx is packaged differently in the Red Hat family distributions:
Configure nginx
sudo mkdir /etc/nginx/sites-available sudo mkdir /etc/nginx/sites-enabled sudo ln -s /etc/nginx/sites-enabled/peertube /etc/nginx/conf.d/peertube.conf sudo systemctl enable --now nginxFirewall
By default, you cannot access your server via public IP. To do so, you must configure firewall:
- Ports used by peertube dev setup:
sudo firewall-cmd --permanent --zone=public --add-port=3000/tcp sudo firewall-cmd --permanent --zone=public --add-port=9000/tcp- Optional
sudo firewall-cmd --permanent --zone=public --add-service=http sudo firewall-cmd --permanent --zone=public --add-service=https- Reload firewall
sudo firewall-cmd --reloadConfigure max ports
This is necessary if you are running dev setup, otherwise you will have errors with
nodemonecho fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
FreeBSD
On a fresh install of FreeBSD, new system or new jail:
bootstrap pkg, initialize db and install peertube's dependencies, always as root (sudo not yet installed):
pkg pkg update pkg install -y sudo bash wget git python nginx pkgconf postgresql16-server postgresql16-contrib redis openssl node npm ffmpeg unzipinstall
sharpbuild dependencies: https://sharp.pixelplumbing.com/install/#building-from-sourceInstall PNPM:
sudo npm install --global pnpmAllow users in the wheel group (hope you don't forgot to add your user on wheel group!) to use sudo.
visudoUncomment the line 90
%wheel ALL=(ALL) ALLEnable nginx, redis, postgresql services and initialize database.
sysrc postgresql_enable="YES" sysrc redis_enable="YES" sysrc nginx_enable="YES"Initialize database and start services
service postgresql initdb service postgresql start service redis start service nginx start
macOS
Add the packages:
brew install ffmpeg nginx postgresql@16 openssl gcc make redis git brew install pnpmRun the services:
brew services run postgresql@16 brew services run redisOn macOS, the
postgresqluser can be_postgresinstead ofpostgres. Ifsudo -u postgres createuser -P peertubegives you anunknown user: postgreserror, you can trysudo -u _postgres createuser -U peertube.
Gentoo
Add this to
/etc/portage/sets/peertube:net-libs/nodejs sys-apps/pnpm media-video/ffmpeg[x264] # Optionally add vorbis,vpx dev-db/postgresql:16 # Any slot >= 14 works dev-db/redis dev-vcs/git app-arch/unzip dev-lang/python dev-lang/python-exec www-servers/nginx # Optional, client for Let’s Encrypt: # app-crypt/certbotIf you are on a "stable" Gentoo you need to accept the testing keyword ~amd64 pnpm:
mkdir -p /etc/portage/package.keywords cat << EOF >> /etc/portage/package.keywords/peertube # required by pnpm (argument) for PeerTube sys-apps/pnpm ~amd64 EOFCompile the peertube set:
emerge -a @peertubeInitialize the PostgreSQL database if you just merged it:
emerge --config postgresql(For OpenRC) Enable and then start the services (replace with the correct PostgreSQL slot):
rc-update add redis rc-update add postgresql-16 rc-service redis start rc-service postgresql-16 startCreate Python version symlink for youtube-dl:
emerge -1 python-exec
OpenBSD
Install Packages:
pkg_add sudo bash wget git python nginx pkgconf postgresql-server postgresql-contrib redis opensslInstall PNPM:
sudo npm install --global pnpmAllow users in the wheel group to use sudo
visudoUncomment line #43:
%wheel ALL=(ALL) ALLEnable services:
rcctl enable postgresql redis nginx
Other distributions
Feel free to update this file in a pull request!