diff options
author | Chocobozzz <me@florianbigard.com> | 2021-02-11 15:56:54 +0100 |
---|---|---|
committer | Chocobozzz <me@florianbigard.com> | 2021-02-11 15:56:54 +0100 |
commit | c83af8f94a3c9732c3ea02c80fa96441e5d99c0f (patch) | |
tree | a984398ddd8b39e170ccb9a70082959a27a7dcbe /support/doc | |
parent | 241609f1943effb731e71f11026898e63384b6e4 (diff) | |
download | PeerTube-c83af8f94a3c9732c3ea02c80fa96441e5d99c0f.tar.gz PeerTube-c83af8f94a3c9732c3ea02c80fa96441e5d99c0f.tar.zst PeerTube-c83af8f94a3c9732c3ea02c80fa96441e5d99c0f.zip |
Update tools doc
Diffstat (limited to 'support/doc')
-rw-r--r-- | support/doc/tools.md | 41 |
1 files changed, 21 insertions, 20 deletions
diff --git a/support/doc/tools.md b/support/doc/tools.md index e6c4c2010..452b3d039 100644 --- a/support/doc/tools.md +++ b/support/doc/tools.md | |||
@@ -44,7 +44,7 @@ Install the [PeerTube dependencies](dependencies.md) except PostgreSQL and Redis | |||
44 | 44 | ||
45 | Clone the PeerTube repo to get the latest version (even if you are on your PeerTube server): | 45 | Clone the PeerTube repo to get the latest version (even if you are on your PeerTube server): |
46 | 46 | ||
47 | ``` | 47 | ```bash |
48 | $ git clone https://github.com/Chocobozzz/PeerTube.git | 48 | $ git clone https://github.com/Chocobozzz/PeerTube.git |
49 | $ CLONE="$(pwd)/PeerTube" | 49 | $ CLONE="$(pwd)/PeerTube" |
50 | $ cd ${CLONE} | 50 | $ cd ${CLONE} |
@@ -52,7 +52,7 @@ $ cd ${CLONE} | |||
52 | 52 | ||
53 | Install dependencies and build CLI tools: | 53 | Install dependencies and build CLI tools: |
54 | 54 | ||
55 | ``` | 55 | ```bash |
56 | $ NOCLIENT=1 yarn install --pure-lockfile | 56 | $ NOCLIENT=1 yarn install --pure-lockfile |
57 | $ npm run setup:cli | 57 | $ npm run setup:cli |
58 | ``` | 58 | ``` |
@@ -164,7 +164,7 @@ You can use this script to import videos directly from the CLI. | |||
164 | 164 | ||
165 | Videos will be publicly available after transcoding (you can see them before that in your account on the web interface). | 165 | Videos will be publicly available after transcoding (you can see them before that in your account on the web interface). |
166 | 166 | ||
167 | ``` | 167 | ```bash |
168 | $ cd ${CLONE} | 168 | $ cd ${CLONE} |
169 | $ node dist/server/tools/peertube-upload.js --help | 169 | $ node dist/server/tools/peertube-upload.js --help |
170 | ``` | 170 | ``` |
@@ -189,7 +189,7 @@ It provides support for different players: | |||
189 | 189 | ||
190 | Install/update/uninstall or list local or NPM PeerTube plugins: | 190 | Install/update/uninstall or list local or NPM PeerTube plugins: |
191 | 191 | ||
192 | ``` | 192 | ```bash |
193 | $ cd ${CLONE} | 193 | $ cd ${CLONE} |
194 | $ node dist/server/tools/peertube-plugins.js --help | 194 | $ node dist/server/tools/peertube-plugins.js --help |
195 | $ node dist/server/tools/peertube-plugins.js list --help | 195 | $ node dist/server/tools/peertube-plugins.js list --help |
@@ -207,25 +207,25 @@ Manage (list/add/remove) video redundancies: | |||
207 | 207 | ||
208 | To list your videos that are duplicated by remote instances: | 208 | To list your videos that are duplicated by remote instances: |
209 | 209 | ||
210 | ``` | 210 | ```bash |
211 | $ node dist/server/tools/peertube.js redundancy list-remote-redundancies | 211 | $ node dist/server/tools/peertube.js redundancy list-remote-redundancies |
212 | ``` | 212 | ``` |
213 | 213 | ||
214 | To list remote videos that your instance duplicated: | 214 | To list remote videos that your instance duplicated: |
215 | 215 | ||
216 | ``` | 216 | ```bash |
217 | $ node dist/server/tools/peertube.js redundancy list-my-redundancies | 217 | $ node dist/server/tools/peertube.js redundancy list-my-redundancies |
218 | ``` | 218 | ``` |
219 | 219 | ||
220 | To duplicate a specific video in your redundancy system: | 220 | To duplicate a specific video in your redundancy system: |
221 | 221 | ||
222 | ``` | 222 | ```bash |
223 | $ node dist/server/tools/peertube.js redundancy add --video 823 | 223 | $ node dist/server/tools/peertube.js redundancy add --video 823 |
224 | ``` | 224 | ``` |
225 | 225 | ||
226 | To remove a video redundancy: | 226 | To remove a video redundancy: |
227 | 227 | ||
228 | ``` | 228 | ```bash |
229 | $ node dist/server/tools/peertube.js redundancy remove --video 823 | 229 | $ node dist/server/tools/peertube.js redundancy remove --video 823 |
230 | ``` | 230 | ``` |
231 | 231 | ||
@@ -237,7 +237,7 @@ These scripts should be run on the server, in `peertube-latest` directory. | |||
237 | 237 | ||
238 | To parse PeerTube last log file: | 238 | To parse PeerTube last log file: |
239 | 239 | ||
240 | ``` | 240 | ```bash |
241 | $ cd /var/www/peertube/peertube-latest | 241 | $ cd /var/www/peertube/peertube-latest |
242 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run parse-log -- --level info | 242 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run parse-log -- --level info |
243 | ``` | 243 | ``` |
@@ -248,13 +248,14 @@ $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production | |||
248 | 248 | ||
249 | You can use this script to force transcoding of an existing video. PeerTube needs to be running. | 249 | You can use this script to force transcoding of an existing video. PeerTube needs to be running. |
250 | 250 | ||
251 | ``` | 251 | To generate transcoding jobs depending on the instance configuration: |
252 | ```bash | ||
252 | $ cd /var/www/peertube/peertube-latest | 253 | $ cd /var/www/peertube/peertube-latest |
253 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- -v [videoUUID] | 254 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- -v [videoUUID] |
254 | ``` | 255 | ``` |
255 | 256 | ||
256 | Or to transcode to a specific resolution: | 257 | Or to transcode to a specific resolution: |
257 | ``` | 258 | ```bash |
258 | $ cd /var/www/peertube/peertube-latest | 259 | $ cd /var/www/peertube/peertube-latest |
259 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- -v [videoUUID] -r [resolution] | 260 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- -v [videoUUID] -r [resolution] |
260 | ``` | 261 | ``` |
@@ -262,7 +263,7 @@ The resolution should be an integer (`1080`, `720`, `480`, etc.) | |||
262 | 263 | ||
263 | To generate an HLS playlist for a video: | 264 | To generate an HLS playlist for a video: |
264 | 265 | ||
265 | ``` | 266 | ```bash |
266 | $ cd /var/www/peertube/peertube-latest | 267 | $ cd /var/www/peertube/peertube-latest |
267 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- --generate-hls -v [videoUUID] | 268 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-transcoding-job -- --generate-hls -v [videoUUID] |
268 | ``` | 269 | ``` |
@@ -271,7 +272,7 @@ $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production | |||
271 | 272 | ||
272 | You can use this script to import a video file to replace an already uploaded file or to add a new resolution to a video. PeerTube needs to be running. | 273 | You can use this script to import a video file to replace an already uploaded file or to add a new resolution to a video. PeerTube needs to be running. |
273 | 274 | ||
274 | ``` | 275 | ```bash |
275 | $ cd /var/www/peertube/peertube-latest | 276 | $ cd /var/www/peertube/peertube-latest |
276 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-import-video-file-job -- -v [videoUUID] -i [videoFile] | 277 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run create-import-video-file-job -- -v [videoUUID] -i [videoFile] |
277 | ``` | 278 | ``` |
@@ -281,7 +282,7 @@ $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production | |||
281 | Some transcoded videos or shutdown at a bad time can leave some unused files on your storage. | 282 | Some transcoded videos or shutdown at a bad time can leave some unused files on your storage. |
282 | Stop PeerTube and delete these files (a confirmation will be demanded first): | 283 | Stop PeerTube and delete these files (a confirmation will be demanded first): |
283 | 284 | ||
284 | ``` | 285 | ```bash |
285 | $ cd /var/www/peertube/peertube-latest | 286 | $ cd /var/www/peertube/peertube-latest |
286 | $ sudo systemctl stop peertube && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run prune-storage | 287 | $ sudo systemctl stop peertube && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run prune-storage |
287 | ``` | 288 | ``` |
@@ -293,7 +294,7 @@ transcoding of uploaded videos. This means that videos might be encoded into | |||
293 | very large files that are too large for streaming. This script re-transcodes | 294 | very large files that are too large for streaming. This script re-transcodes |
294 | these videos so that they can be watched properly, even on slow connections. | 295 | these videos so that they can be watched properly, even on slow connections. |
295 | 296 | ||
296 | ``` | 297 | ```bash |
297 | $ cd /var/www/peertube/peertube-latest | 298 | $ cd /var/www/peertube/peertube-latest |
298 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run optimize-old-videos | 299 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run optimize-old-videos |
299 | ``` | 300 | ``` |
@@ -306,7 +307,7 @@ If you started PeerTube with a domain, and then changed it you will have | |||
306 | invalid torrent files and invalid URLs in your database. To fix this, you have | 307 | invalid torrent files and invalid URLs in your database. To fix this, you have |
307 | to run the command below (keep in mind your follower instances will NOT update their URLs). | 308 | to run the command below (keep in mind your follower instances will NOT update their URLs). |
308 | 309 | ||
309 | ``` | 310 | ```bash |
310 | $ cd /var/www/peertube/peertube-latest | 311 | $ cd /var/www/peertube/peertube-latest |
311 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run update-host | 312 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run update-host |
312 | ``` | 313 | ``` |
@@ -315,7 +316,7 @@ $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production | |||
315 | 316 | ||
316 | To reset a user password from CLI, run: | 317 | To reset a user password from CLI, run: |
317 | 318 | ||
318 | ``` | 319 | ```bash |
319 | $ cd /var/www/peertube/peertube-latest | 320 | $ cd /var/www/peertube/peertube-latest |
320 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run reset-password -- -u target_username | 321 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run reset-password -- -u target_username |
321 | ``` | 322 | ``` |
@@ -328,21 +329,21 @@ If PeerTube is running, you need to restart it for the changes to take effect (w | |||
328 | 329 | ||
329 | To install/update a plugin or a theme from the disk: | 330 | To install/update a plugin or a theme from the disk: |
330 | 331 | ||
331 | ``` | 332 | ```bash |
332 | $ cd /var/www/peertube/peertube-latest | 333 | $ cd /var/www/peertube/peertube-latest |
333 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run plugin:install -- --plugin-path /local/plugin/path | 334 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run plugin:install -- --plugin-path /local/plugin/path |
334 | ``` | 335 | ``` |
335 | 336 | ||
336 | From NPM: | 337 | From NPM: |
337 | 338 | ||
338 | ``` | 339 | ```bash |
339 | $ cd /var/www/peertube/peertube-latest | 340 | $ cd /var/www/peertube/peertube-latest |
340 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run plugin:install -- --npm-name peertube-plugin-myplugin | 341 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run plugin:install -- --npm-name peertube-plugin-myplugin |
341 | ``` | 342 | ``` |
342 | 343 | ||
343 | To uninstall a plugin or a theme: | 344 | To uninstall a plugin or a theme: |
344 | 345 | ||
345 | ``` | 346 | ```bash |
346 | $ cd /var/www/peertube/peertube-latest | 347 | $ cd /var/www/peertube/peertube-latest |
347 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run plugin:uninstall -- --npm-name peertube-plugin-myplugin | 348 | $ sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production npm run plugin:uninstall -- --npm-name peertube-plugin-myplugin |
348 | ``` | 349 | ``` |