diff options
author | Chocobozzz <chocobozzz@framasoft.org> | 2018-03-27 19:27:03 +0200 |
---|---|---|
committer | Chocobozzz <chocobozzz@framasoft.org> | 2018-03-27 19:27:03 +0200 |
commit | fb0e959dba088b7414926f7d11c53b1611a4ea7b (patch) | |
tree | 9d11c7893b616d1105af2977c8a6a0a7856d2db5 | |
parent | e700d33b19d7314759ef9685408017f77df30525 (diff) | |
parent | 4c86a254a5d315ebcfdbc88927b42c2d06e8f1c7 (diff) | |
download | PeerTube-fb0e959dba088b7414926f7d11c53b1611a4ea7b.tar.gz PeerTube-fb0e959dba088b7414926f7d11c53b1611a4ea7b.tar.zst PeerTube-fb0e959dba088b7414926f7d11c53b1611a4ea7b.zip |
Documentation update for FreeBSD
-rw-r--r-- | support/doc/dependencies.md | 66 | ||||
-rw-r--r-- | support/doc/production.md | 19 |
2 files changed, 83 insertions, 2 deletions
diff --git a/support/doc/dependencies.md b/support/doc/dependencies.md index ab7fb2e4e..66b9190eb 100644 --- a/support/doc/dependencies.md +++ b/support/doc/dependencies.md | |||
@@ -58,9 +58,75 @@ $ sudo yum install nginx postgresql postgresql-server openssl gcc-c++ make redis | |||
58 | ``` | 58 | ``` |
59 | 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. | 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 | ``` | ||
61 | $ sudo scl devtoolset-6 bash | 62 | $ sudo scl devtoolset-6 bash |
62 | ``` | 63 | ``` |
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 | ``` | ||
72 | # ee /etc/pkg/FreeBSD.conf | ||
73 | ``` | ||
74 | |||
75 | change this line (11): | ||
76 | |||
77 | ``` | ||
78 | url: "pkg+http://pkg.FreeBSD.org/${ABI}/quaterly", | ||
79 | ``` | ||
80 | |||
81 | to: | ||
82 | |||
83 | ``` | ||
84 | url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest", | ||
85 | ``` | ||
86 | |||
87 | 2. bootsrap pkg, initialize db and install peertube's dependencies, always as root (sudo not yet installed): | ||
88 | |||
89 | ``` | ||
90 | # pkg | ||
91 | # pkg update | ||
92 | # pkg install -y sudo bash wget git python nginx pkgconf vips postgresql96-server redis openssl node npm yarn ffmpeg unzip | ||
93 | ``` | ||
94 | |||
95 | 3. Allow users in the wheel group (hope you don't forgot to add your user on wheel group!) to use sudo | ||
96 | |||
97 | ``` | ||
98 | # visudo | ||
99 | ``` | ||
100 | |||
101 | Uncomment the line 90 | ||
102 | |||
103 | ``` | ||
104 | %wheel ALL=(ALL) ALL | ||
105 | ``` | ||
106 | |||
107 | 4. Enable nginx, redis, postgresql services and initialize database | ||
108 | |||
109 | ``` | ||
110 | # ee /etc/rc.conf | ||
111 | ``` | ||
112 | |||
113 | Add the following lines | ||
114 | |||
115 | ``` | ||
116 | postgresql_enable="YES" | ||
117 | redis_enable="YES" | ||
118 | nginx_enable="YES" | ||
119 | ``` | ||
120 | |||
121 | Initialize database and start services | ||
122 | |||
123 | ``` | ||
124 | # service postgresql initdb | ||
125 | # service postgresql start | ||
126 | # service redis start | ||
127 | # service nginx start | ||
128 | ``` | ||
129 | |||
64 | ## Other distributions | 130 | ## Other distributions |
65 | 131 | ||
66 | Feel free to update this file in a pull request! | 132 | Feel free to update this file in a pull request! |
diff --git a/support/doc/production.md b/support/doc/production.md index 313b57889..34d213ec6 100644 --- a/support/doc/production.md +++ b/support/doc/production.md | |||
@@ -1,7 +1,7 @@ | |||
1 | # Production guide | 1 | # Production guide |
2 | 2 | ||
3 | * [Installation](#installation) | 3 | * [Installation](#installation) |
4 | * [Upgrade](#upgrade) | 4 | * [Upgrade](#upgrade) |
5 | 5 | ||
6 | ## Installation | 6 | ## Installation |
7 | 7 | ||
@@ -24,6 +24,14 @@ Set its password: | |||
24 | $ sudo passwd peertube | 24 | $ sudo passwd peertube |
25 | ``` | 25 | ``` |
26 | 26 | ||
27 | **On FreeBSD** | ||
28 | |||
29 | ``` | ||
30 | $ sudo pw useradd -n peertube -d /var/www/peertube -s /usr/local/bin/bash -m | ||
31 | $ sudo passwd peertube | ||
32 | ``` | ||
33 | or use `adduser` to create it interactively. | ||
34 | |||
27 | ### Database | 35 | ### Database |
28 | 36 | ||
29 | Create the production database and a peertube user inside PostgreSQL: | 37 | Create the production database and a peertube user inside PostgreSQL: |
@@ -115,6 +123,13 @@ Now you have the certificates you can reload nginx: | |||
115 | $ sudo systemctl reload nginx | 123 | $ sudo systemctl reload nginx |
116 | ``` | 124 | ``` |
117 | 125 | ||
126 | **FreeBSD** | ||
127 | On FreeBSD you can use [Dehydrated](https://dehydrated.io/) `security/dehydrated` for [Let's Encrypt](https://letsencrypt.org/) | ||
128 | |||
129 | ``` | ||
130 | $ sudo pkg install dehydrated | ||
131 | ``` | ||
132 | |||
118 | ### systemd | 133 | ### systemd |
119 | 134 | ||
120 | If your OS uses systemd, copy the configuration template: | 135 | If your OS uses systemd, copy the configuration template: |
@@ -238,7 +253,7 @@ Restart PeerTube: | |||
238 | $ sudo systemctl restart peertube | 253 | $ sudo systemctl restart peertube |
239 | ``` | 254 | ``` |
240 | 255 | ||
241 | ### Things went wrong? | 256 | ### Things went wrong? |
242 | 257 | ||
243 | Change `peertube-latest` destination to the previous version and restore your SQL backup: | 258 | Change `peertube-latest` destination to the previous version and restore your SQL backup: |
244 | 259 | ||