OpenCloud
/
PeerTube
mirror of https://github.com/Chocobozzz/PeerTube
1
0
Fork 0
Code Issues Releases Wiki Activity

Update dependencies.md to be consistent 

The current dependencies document syntax is broken on https://docs.joinpeertube.org/#/dependencies.
This update makes the page source consistent across distributions in the hopes of avoiding rendering issues.
pull/2293/head
Dirk Kelly 2019-11-27 02:14:24 +08:00 committed by Chocobozzz
parent 49c3bf6fa2
commit ab87af1155
1 changed files with 122 additions and 83 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

199
support/doc/dependencies.md
View File

@ -16,131 +16,154 @@
<!-- END doctoc generated TOC please keep comment here to allow auto update --> <!-- END doctoc generated TOC please keep comment here to allow auto update -->
## Debian / Ubuntu and derivatives ## Debian / Ubuntu and derivatives
1. On a fresh Debian/Ubuntu, as root user, install basic utility programs needed for the installation
1. On a fresh Debian/Ubuntu, as root user, install basic utility programs needed for the installation
``` ```
# apt-get install curl sudo unzip vim # apt-get install curl sudo unzip vim
``` ```
2. It would be wise to disable root access and to continue this tutorial with a user with sudoers group access 2. It would be wise to disable root access and to continue this tutorial with a user with sudoers group access
3. Install certbot (choose instructions for nginx and your distribution) : 3. Install certbot (choose instructions for nginx and your distribution) :
[https://certbot.eff.org/all-instructions](https://certbot.eff.org/all-instructions) [https://certbot.eff.org/all-instructions](https://certbot.eff.org/all-instructions)
4. Install NodeJS 10.x: 4. Install NodeJS 10.x:
[https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions) [https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions)
5. Install yarn, and be sure to have [a recent version](https://github.com/yarnpkg/yarn/releases/latest): 5. Install yarn, and be sure to have [a recent version](https://github.com/yarnpkg/yarn/releases/latest):
[https://yarnpkg.com/en/docs/install#linux-tab](https://yarnpkg.com/en/docs/install#linux-tab) [https://yarnpkg.com/en/docs/install#linux-tab](https://yarnpkg.com/en/docs/install#linux-tab)
6. Run:
6. Run:
``` ```
$ sudo apt update sudo apt update
$ sudo apt install nginx ffmpeg postgresql postgresql-contrib openssl g++ make redis-server git python-dev sudo apt install nginx ffmpeg postgresql postgresql-contrib openssl g++ make redis-server git python-dev
$ ffmpeg -version # Should be >= 3.x ffmpeg -version # Should be >= 3.x
$ g++ -v # Should be >= 5.x g++ -v # Should be >= 5.x
``` ```
If you still have a 2.x version of FFmpeg on Ubuntu: If you still have a 2.x version of FFmpeg on Ubuntu:
``` ```
$ sudo add-apt-repository ppa:jonathonf/ffmpeg-3 sudo add-apt-repository ppa:jonathonf/ffmpeg-3
$ sudo apt-get update sudo apt-get update
$ sudo apt install ffmpeg sudo apt install ffmpeg
``` ```
Now that dependencies are installed, before running PeerTube you should start PostgreSQL and Redis: Now that dependencies are installed, before running PeerTube you should start PostgreSQL and Redis:
``` ```
$ sudo systemctl start redis postgresql sudo systemctl start redis postgresql
``` ```
## Arch Linux ## Arch Linux
1. Run: 1. Run:
``` ```
$ sudo pacman -S nodejs-lts-dubnium yarn ffmpeg postgresql openssl redis git wget unzip python2 base-devel npm nginx sudo pacman -S nodejs-lts-dubnium yarn ffmpeg postgresql openssl redis git wget unzip python2 base-devel npm nginx
``` ```
Now that dependencies are installed, before running PeerTube you should start PostgreSQL and Redis: Now that dependencies are installed, before running PeerTube you should start PostgreSQL and Redis:
``` ```
$ sudo systemctl start redis postgresql sudo systemctl start redis postgresql
``` ```
## CentOS 7 ## CentOS 7
1. Install NodeJS 10.x: 1. Install NodeJS 10.x:
[https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora](https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora) [https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora](https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora)
2. Install yarn:
[https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install) 2. Install yarn:
3. Install or compile ffmpeg: [https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install)
* Install - [https://linoxide.com/linux-how-to/install-ffmpeg-centos-7/](https://linoxide.com/linux-how-to/install-ffmpeg-centos-7/)
* Compile - [https://gist.github.com/mustafaturan/7053900#file-latest-ffmpeg-centos6-sh](https://gist.github.com/mustafaturan/7053900#file-latest-ffmpeg-centos6-sh) 3. Install or compile ffmpeg:
4. Run:
* Install - [https://linoxide.com/linux-how-to/install-ffmpeg-centos-7/](https://linoxide.com/linux-how-to/install-ffmpeg-centos-7/)
* Compile - [https://gist.github.com/mustafaturan/7053900#file-latest-ffmpeg-centos6-sh](https://gist.github.com/mustafaturan/7053900#file-latest-ffmpeg-centos6-sh)
4. Run:
``` ```
$ sudo yum update sudo yum update
$ sudo yum install epel-release centos-release-scl sudo yum install epel-release centos-release-scl
$ sudo yum update sudo yum update
$ sudo yum install nginx postgresql postgresql-server postgresql-contrib openssl gcc-c++ make wget redis git devtoolset-7 sudo yum install nginx postgresql postgresql-server postgresql-contrib openssl gcc-c++ make wget redis git devtoolset-7
``` ```
5. You need to use a more up to date version of G++ in order to run the yarn install command, hence the installation of devtoolset-7. 5. You need to use a more up to date version of G++ in order to run the yarn install command, hence the installation of devtoolset-7.
``` ```
$ sudo scl enable devtoolset-7 bash sudo scl enable devtoolset-7 bash
``` ```
Later 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: Later 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++ yarn install --production --pure-lockfile sudo -H -u peertube CC=/opt/rh/devtoolset-7/root/usr/bin/gcc CXX=/opt/rh/devtoolset-7/root/usr/bin/g++ yarn install --production --pure-lockfile
``` ```
Initialize the PostgreSQL database: Initialize the PostgreSQL database:
``` ```
$ sudo postgresql-setup initdb sudo postgresql-setup initdb
``` ```
Now that dependencies are installed, before running PeerTube you should enable and start PostgreSQL and Redis: Now that dependencies are installed, before running PeerTube you should enable and start PostgreSQL and Redis:
``` ```
$ sudo systemctl enable redis sudo systemctl enable redis
$ sudo systemctl enable postgresql sudo systemctl enable postgresql
$ sudo systemctl start redis sudo systemctl start redis
$ sudo systemctl start postgresql sudo systemctl start postgresql
``` ```
## Fedora ## Fedora
0. Upgrade your packages: 1. Upgrade your packages:
``` ```
dnf upgrade dnf upgrade
``` ```
1. Add a user with sudoers group access:
2. Add a user with sudoers group access:
``` ```
useradd my-peertube-user useradd my-peertube-user
passwd my-peertube-user passwd my-peertube-user
usermod my-peertube-user -a -G wheel # Add my-peertube-user to sudoers usermod my-peertube-user -a -G wheel # Add my-peertube-user to sudoers
su my-peertube-user su my-peertube-user
``` ```
2. (Optional) Install certbot (choose instructions for nginx and your distribution) :
3. (Optional) Install certbot (choose instructions for nginx and your distribution):
[https://certbot.eff.org/all-instructions](https://certbot.eff.org/all-instructions) [https://certbot.eff.org/all-instructions](https://certbot.eff.org/all-instructions)
3. Install NodeJS 10.x:
4. Install NodeJS 10.x:
[https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora](https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora) [https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora](https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora)
4. Install yarn:
5. Install yarn:
[https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install) [https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install)
5. Enable [RPM Fusion](https://rpmfusion.org) for Fedora (available for x86, x86_64, armhfp)
6. Enable [RPM Fusion](https://rpmfusion.org) for Fedora (available for x86, x86_64, armhfp)
``` ```
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
``` ```
This is necessary because `ffmpeg` is not in the Fedora repos. This is necessary because `ffmpeg` is not in the Fedora repos.
6. Run: 7. Run:
``` ```
sudo dnf install nginx ffmpeg postgresql-server postgresql-contrib openssl gcc-c++ make redis git sudo dnf install nginx ffmpeg postgresql-server postgresql-contrib openssl gcc-c++ make redis git
ffmpeg -version # Should be >= 3.x ffmpeg -version # Should be >= 3.x
g++ -v # Should be >= 5.x g++ -v # Should be >= 5.x
``` ```
7. Post-installation
8. Post-installation
_from [PostgreSQL documentation](https://www.postgresql.org/download/linux/redhat/):_ _from [PostgreSQL documentation](https://www.postgresql.org/download/linux/redhat/):_
> Due to policies for Red Hat family distributions, the PostgreSQL installation will not be enabled for automatic start or have the database initialized automatically. > 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 # PostgreSQL
sudo postgresql-setup initdb sudo postgresql-setup initdb
@ -153,9 +176,11 @@ sudo systemctl start nginx.service
sudo systemctl enable redis.service sudo systemctl enable redis.service
sudo systemctl start redis.service sudo systemctl start redis.service
``` ```
8. Firewall
9. Firewall
By default, you cannot access your server via public IP. To do so, you must configure firewall: By default, you cannot access your server via public IP. To do so, you must configure firewall:
``` ```
# Ports used by peertube dev setup # Ports used by peertube dev setup
sudo firewall-cmd --permanent --zone=public --add-port=3000/tcp sudo firewall-cmd --permanent --zone=public --add-port=3000/tcp
@ -166,67 +191,77 @@ sudo firewall-cmd --permanent --zone=public --add-service=https
# Reload firewall # Reload firewall
sudo firewall-cmd --reload sudo firewall-cmd --reload
``` ```
9. Configure max ports
10. Configure max ports
This is necessary if you are running dev setup, otherwise you will have errors with `nodemon` This is necessary if you are running dev setup, otherwise you will have errors with `nodemon`
``` ```
echo fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p echo fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
``` ```
[More info](https://stackoverflow.com/questions/34662574/node-js-getting-error-nodemon-internal-watch-failed-watch-enospc#34664097) [More info](https://stackoverflow.com/questions/34662574/node-js-getting-error-nodemon-internal-watch-failed-watch-enospc#34664097)
## FreeBSD ## FreeBSD
On a fresh install of [FreeBSD](https://www.freebsd.org), new system or new jail: On a fresh install of [FreeBSD](https://www.freebsd.org), new system or new jail:
1. bootstrap pkg, initialize db and install peertube's dependencies, always as root (sudo not yet installed): 1. bootstrap pkg, initialize db and install peertube's dependencies, always as root (sudo not yet installed):
``` ```
# pkg pkg
# pkg update pkg update
# pkg install -y sudo bash wget git python nginx pkgconf vips postgresql96-server postgresql96-contrib redis openssl node npm yarn ffmpeg unzip pkg install -y sudo bash wget git python nginx pkgconf vips postgresql96-server postgresql96-contrib redis openssl node npm yarn ffmpeg unzip
``` ```
2. Allow users in the wheel group (hope you don't forgot to add your user on wheel group!) to use sudo 2. Allow users in the wheel group (hope you don't forgot to add your user on wheel group!) to use sudo.
``` ```
# visudo # visudo
``` ```
Uncomment the line 90 Uncomment the line 90
``` ```
%wheel ALL=(ALL) ALL %wheel ALL=(ALL) ALL
``` ```
3. Enable nginx, redis, postgresql services and initialize database 3. Enable nginx, redis, postgresql services and initialize database.
``` ```
# sysrc postgresql_enable="YES" sysrc postgresql_enable="YES"
# sysrc redis_enable="YES" sysrc redis_enable="YES"
# sysrc nginx_enable="YES" sysrc nginx_enable="YES"
``` ```
Initialize database and start services Initialize database and start services
``` ```
# service postgresql initdb service postgresql initdb
# service postgresql start service postgresql start
# service redis start service redis start
# service nginx start service nginx start
``` ```
## macOS ## macOS
* Add the packages:
``` 1. Add the packages:
brew install ffmpeg nginx postgresql openssl gcc make redis git yarn
```
* Run the services:
``` ```
brew services run postgresql brew install ffmpeg nginx postgresql openssl gcc make redis git yarn
brew services run redis ```
```
2. Run the services:
```
brew services run postgresql
brew services run redis
```
## Gentoo ## Gentoo
* Add this to ``/etc/portage/sets/peertube``: 1. Add this to ``/etc/portage/sets/peertube``:
``` ```
net-libs/nodejs net-libs/nodejs
sys-apps/yarn sys-apps/yarn
@ -238,12 +273,13 @@ app-arch/unzip
dev-lang/python:2.7 dev-lang/python:2.7
www-servers/nginx www-servers/nginx
# Optionnal, client for Let’s Encrypt: # Optional, client for Let’s Encrypt:
# app-crypt/certbot # app-crypt/certbot
# app-crypt/certbot-nginx # app-crypt/certbot-nginx
``` ```
* If you are on a "stable" Gentoo you need to accept the testing keyword ~amd64 yarn: 2. If you are on a "stable" Gentoo you need to accept the testing keyword ~amd64 yarn:
``` ```
mkdir -p /etc/portage/package.keywords mkdir -p /etc/portage/package.keywords
cat << EOF >> /etc/portage/package.keywords/peertube cat << EOF >> /etc/portage/package.keywords/peertube
@ -252,17 +288,20 @@ sys-apps/yarn ~amd64
EOF EOF
``` ```
* Compile the peertube set: 3. Compile the peertube set:
``` ```
emerge -a @peertube emerge -a @peertube
``` ```
* Initialize the PostgreSQL database if you just merged it: 4. Initialize the PostgreSQL database if you just merged it:
``` ```
emerge --config postgresql emerge --config postgresql
``` ```
* (For OpenRC) Enable and then start the services (replace with the correct PostgreSQL slot): 5. (For OpenRC) Enable and then start the services (replace with the correct PostgreSQL slot):
``` ```
rc-update add redis rc-update add redis
rc-update add postgresql-11 rc-update add postgresql-11