support/doc/dependencies.md

   1 # Dependencies
   2
   3 ## Debian / Ubuntu and derivatives
   4   1. On a fresh Debian/Ubuntu, as root user, install basic utility programs needed for the installation
   5
   6 ```
   7 # apt-get install curl sudo unzip vim
   8 ```
   9
  10   2. It would be wise to disable root access and to continue this tutorial with a user with sudoers group access
  11
  12   3. Install certbot (choose instructions for nginx and your distribution) :
  13      [https://certbot.eff.org/all-instructions](https://certbot.eff.org/all-instructions)
  14   4. Install NodeJS 8.x (current LTS):
  15      [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)
  16   5. Install yarn, and be sure to have a recent version (>= 1.5.1, the latest release):
  17      [https://yarnpkg.com/en/docs/install#linux-tab](https://yarnpkg.com/en/docs/install#linux-tab)
  18   6. Run:
  19
  20 ```
  21 $ sudo apt update
  22 $ sudo apt install nginx ffmpeg postgresql openssl g++ make redis-server git
  23 $ ffmpeg -version # Should be >= 3.x
  24 $ g++ -v # Should be >= 5.x
  25 ```
  26
  27 If you still have a 2.x version of FFmpeg on Ubuntu:
  28 ```
  29 $ sudo add-apt-repository ppa:jonathonf/ffmpeg-3
  30 $ sudo apt-get update
  31 $ sudo apt install ffmpeg
  32 ```
  33
  34 ## Arch Linux
  35
  36   1. Run:
  37
  38 ```
  39 $ sudo pacman -S nodejs yarn ffmpeg postgresql openssl redis git wget unzip python2 base-devel npm nginx
  40 ```
  41
  42 ## CentOS 7
  43
  44   1. Install NodeJS 8.x (current LTS):
  45      [https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora](https://nodejs.org/en/download/package-manager/#enterprise-linux-and-fedora)
  46   2. Install yarn:
  47      [https://yarnpkg.com/en/docs/install](https://yarnpkg.com/en/docs/install)
  48   3. Install or compile ffmpeg:
  49      * Install - [https://linoxide.com/linux-how-to/install-ffmpeg-centos-7/](https://linoxide.com/linux-how-to/install-ffmpeg-centos-7/)
  50      * Compile - [https://gist.github.com/mustafaturan/7053900#file-latest-ffmpeg-centos6-sh](https://gist.github.com/mustafaturan/7053900#file-latest-ffmpeg-centos6-sh)
  51   4. Run:
  52
  53 ```
  54 $ sudo yum update
  55 $ sudo yum install epel-release centos-release-scl
  56 $ sudo yum update
  57 $ sudo yum install nginx postgresql postgresql-server openssl gcc-c++ make redis git devtoolset-6
  58 ```
  59
  60   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-6.
  61 ```
  62 $ sudo scl devtoolset-6 bash
  63 ```
  64
  65 ## FreeBSD
  66
  67 On a fresh install of [FreeBSD](https://www.freebsd.org), new system or new jail:
  68
  69   1. edit `/etc/pkg/FreeBSD.conf` to use latest instead quaterly (installation was tested with the latest repository), as root:
  70 ```
  71 # ee /etc/pkg/FreeBSD.conf
  72 ```
  73
  74      change this line (11):
  75 ```
  76   url: "pkg+http://pkg.FreeBSD.org/${ABI}/quaterly",
  77 ```
  78
  79      to:
  80 ```
  81   url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest",
  82 ```
  83
  84   2. bootstrap pkg, initialize db and install peertube's dependencies, always as root (sudo not yet installed):
  85 ```
  86 # pkg
  87 # pkg update
  88 # pkg install -y sudo bash wget git python nginx pkgconf vips postgresql96-server redis openssl node npm yarn ffmpeg unzip
  89 ```
  90
  91   3. Allow users in the wheel group (hope you don't forgot to add your user on wheel group!) to use sudo
  92 ```
  93 # visudo
  94 ```
  95
  96      Uncomment the line 90
  97 ```
  98 %wheel ALL=(ALL) ALL
  99 ```
 100
 101   4. Enable nginx, redis, postgresql services and initialize database
 102 ```
 103 # ee /etc/rc.conf
 104 ```
 105
 106      Add the following lines
 107 ```
 108 postgresql_enable="YES"
 109 redis_enable="YES"
 110 nginx_enable="YES"
 111 ```
 112
 113          Initialize database and start services
 114 ```
 115 # service postgresql initdb
 116 # service postgresql start
 117 # service redis start
 118 # service nginx start
 119 ```
 120
 121 ## macOS
 122 * Add the packages:
 123
 124         ```
 125         brew install ffmpeg nginx postgresql openssl gcc make redis git yarn
 126         ```
 127 * Run the services:
 128
 129    ```
 130    brew services run postgresql
 131    brew services run redis
 132    ```
 133
 134 ## Other distributions
 135
 136 Feel free to update this file in a pull request!