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-lts-carbon 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. bootstrap pkg, initialize db and install peertube's dependencies, always as root (sudo not yet installed):
  70 ```
  71 # pkg
  72 # pkg update
  73 # pkg install -y sudo bash wget git python nginx pkgconf vips postgresql96-server redis openssl node npm yarn ffmpeg unzip
  74 ```
  75
  76   2. Allow users in the wheel group (hope you don't forgot to add your user on wheel group!) to use sudo
  77 ```
  78 # visudo
  79 ```
  80
  81      Uncomment the line 90
  82 ```
  83 %wheel ALL=(ALL) ALL
  84 ```
  85
  86   3. Enable nginx, redis, postgresql services and initialize database
  87 ```
  88 # ee /etc/rc.conf
  89 ```
  90
  91      Add the following lines
  92 ```
  93 postgresql_enable="YES"
  94 redis_enable="YES"
  95 nginx_enable="YES"
  96 ```
  97
  98          Initialize database and start services
  99 ```
 100 # service postgresql initdb
 101 # service postgresql start
 102 # service redis start
 103 # service nginx start
 104 ```
 105
 106 ## macOS
 107 * Add the packages:
 108
 109         ```
 110         brew install ffmpeg nginx postgresql openssl gcc make redis git yarn
 111         ```
 112 * Run the services:
 113
 114    ```
 115    brew services run postgresql
 116    brew services run redis
 117    ```
 118
 119 ## Other distributions
 120
 121 Feel free to update this file in a pull request!