]> git.immae.eu Git - github/Chocobozzz/PeerTube.git/blame - config/production.yaml.example
Allow to specify transcoding and import jobs concurrency
[github/Chocobozzz/PeerTube.git] / config / production.yaml.example
CommitLineData
552cc9d6 1listen:
cff8b272 2 hostname: 'localhost'
552cc9d6
C
3 port: 9000
4
d8658f0f 5# Correspond to your reverse proxy server_name/listen configuration (i.e., your public PeerTube instance URL)
f1f4732f 6webserver:
d478d83d 7 https: true
3737bbaf 8 hostname: 'example.com'
d478d83d 9 port: 443
825a5d9c 10
c342726a 11rates_limit:
c1340a6a
C
12 api:
13 # 50 attempts in 10 seconds
14 window: 10 seconds
15 max: 50
c342726a
YB
16 login:
17 # 15 attempts in 5 min
18 window: 5 minutes
19 max: 15
c1340a6a
C
20 signup:
21 # 2 attempts in 5 min (only succeeded attempts are taken into account)
22 window: 5 minutes
23 max: 2
c342726a
YB
24 ask_send_email:
25 # 3 attempts in 5 min
26 window: 5 minutes
27 max: 3
28
490b595a
C
29# Proxies to trust to get real client IP
30# If you run PeerTube just behind a local proxy (nginx), keep 'loopback'
31# If you run PeerTube behind a remote proxy, add the proxy IP address (or subnet)
32trust_proxy:
33 - 'loopback'
34
6ee72211 35# Your database name will be database.name OR "peertube"+database.suffix
825a5d9c 36database:
552cc9d6
C
37 hostname: 'localhost'
38 port: 5432
b0ce7c39 39 ssl: false
feb4bdfd 40 suffix: '_prod'
6c05c149
C
41 username: 'peertube'
42 password: 'peertube'
1c3386e8
RK
43 pool:
44 max: 5
552cc9d6 45
95540ed2 46# Redis server for short time storage
19f7b248
RK
47# You can also specify a 'socket' path to a unix socket but first need to
48# comment out hostname and port
94a5ff8a
C
49redis:
50 hostname: 'localhost'
51 port: 6379
52 auth: null
30c82f0d 53 db: 0
94a5ff8a 54
95540ed2 55# SMTP server to send emails
ecb4e35f 56smtp:
ed3f089c
IB
57 # smtp or sendmail
58 transport: smtp
59 # Path to sendmail command. Required if you use sendmail transport
60 sendmail: null
ecb4e35f 61 hostname: null
6401417d 62 port: 465 # If you use StartTLS: 587
ecb4e35f
C
63 username: null
64 password: null
6401417d 65 tls: true # If you use StartTLS: false
bebf2d89 66 disable_starttls: false
ecb4e35f
C
67 ca_file: null # Used for self signed certificates
68 from_address: 'admin@example.com'
69
dd2c2a52
C
70email:
71 body:
72 signature: "PeerTube"
916937d7 73 subject:
dd2c2a52
C
74 prefix: "[PeerTube]"
75
552cc9d6
C
76# From the project root directory
77storage:
aafbc63a 78 tmp: '/var/www/peertube/storage/tmp/' # Use to download data (imports etc), store uploaded files before processing...
59c48d49
C
79 avatars: '/var/www/peertube/storage/avatars/'
80 videos: '/var/www/peertube/storage/videos/'
0b16f5f2 81 streaming_playlists: '/var/www/peertube/storage/streaming-playlists/'
aafbc63a 82 redundancy: '/var/www/peertube/storage/redundancy/'
59c48d49
C
83 logs: '/var/www/peertube/storage/logs/'
84 previews: '/var/www/peertube/storage/previews/'
85 thumbnails: '/var/www/peertube/storage/thumbnails/'
86 torrents: '/var/www/peertube/storage/torrents/'
40e87e9e 87 captions: '/var/www/peertube/storage/captions/'
59c48d49 88 cache: '/var/www/peertube/storage/cache/'
345da516 89 plugins: '/var/www/peertube/storage/plugins/'
caf2aaf4
K
90 # Overridable client files : logo.svg, favicon.png and icons/*.png (PWA) in client/dist/assets/images
91 # Could contain for example assets/images/favicon.png
92 # If the file exists, peertube will serve it
93 # If not, peertube will fallback to the default fil
94 client_overrides: '/var/www/peertube/storage/client-overrides/'
4793c343 95
23e27dd5 96log:
a0922eb9 97 level: 'info' # debug/info/warning/error
fcf4569f 98 rotation:
aafbc63a 99 enabled : true # Enabled by default, if disabled make sure that 'storage.logs' is pointing to a folder handled by logrotate
2f6b5e2d
C
100 maxFileSize: 12MB
101 maxFiles: 20
102 anonymizeIP: false
12c1e38d 103 log_ping_requests: true
1e743faa 104 prettify_sql: false
23e27dd5 105
9a629c6e
C
106trending:
107 videos:
108 interval_days: 7 # Compute trending videos for the last x days
ba5d4a84
RK
109 algorithms:
110 enabled:
3d4e112d
RK
111 - 'best' # adaptation of Reddit's 'Best' algorithm (Hot minus History)
112 - 'hot' # adaptation of Reddit's 'Hot' algorithm
ba5d4a84
RK
113 - 'most-viewed' # default, used initially by PeerTube as the trending page
114 - 'most-liked'
115 default: 'most-viewed'
9a629c6e 116
c48e82b5
C
117# Cache remote videos on your server, to help other instances to broadcast the video
118# You can define multiple caches using different sizes/strategies
119# Once you have defined your strategies, choose which instances you want to cache in admin -> manage follows -> following
120redundancy:
121 videos:
f9f899b9 122 check_interval: '1 hour' # How often you want to check new videos to cache
6040f87d 123 strategies: # Just uncomment strategies you want
d9bdd007
C
124# -
125# size: '10GB'
e5565833
C
126# # Minimum time the video must remain in the cache. Only accept values > 10 hours (to not overload remote instances)
127# min_lifetime: '48 hours'
d9bdd007
C
128# strategy: 'most-views' # Cache videos that have the most views
129# -
130# size: '10GB'
e5565833
C
131# # Minimum time the video must remain in the cache. Only accept values > 10 hours (to not overload remote instances)
132# min_lifetime: '48 hours'
d9bdd007
C
133# strategy: 'trending' # Cache trending videos
134# -
135# size: '10GB'
e5565833
C
136# # Minimum time the video must remain in the cache. Only accept values > 10 hours (to not overload remote instances)
137# min_lifetime: '48 hours'
d9bdd007 138# strategy: 'recently-added' # Cache recently added videos
e5565833 139# min_views: 10 # Having at least x views
c48e82b5 140
8c9e7875
C
141# Other instances that duplicate your content
142remote_redundancy:
143 videos:
144 # 'nobody': Do not accept remote redundancies
145 # 'anybody': Accept remote redundancies from anybody
146 # 'followings': Accept redundancies from instance followings
147 accept_from: 'anybody'
148
539d3f4f
C
149csp:
150 enabled: false
151 report_only: true # CSP directives are still being tested, so disable the report only mode at your own risk!
152 report_uri:
153
31b6ddf8
C
154tracker:
155 # If you disable the tracker, you disable the P2P aspect of PeerTube
156 enabled: true
157 # Only handle requests on your videos.
158 # If you set this to false it means you have a public tracker.
159 # Then, it is possible that clients overload your instance with external torrents
160 private: true
161 # Reject peers that do a lot of announces (could improve privacy of TCP/UDP peers)
162 reject_too_many_announces: false
163
8f0bc73d
C
164history:
165 videos:
166 # If you want to limit users videos history
167 # -1 means there is no limitations
168 # Other values could be '6 months' or '30 days' etc (PeerTube will periodically delete old entries from database)
169 max_age: -1
539d3f4f 170
cda03765
C
171views:
172 videos:
173 # PeerTube creates a database entry every hour for each video to track views over a period of time
174 # This is used in particular by the Trending page
175 # PeerTube could remove old remote video views if you want to reduce your database size (video view counter will not be altered)
176 # -1 means no cleanup
177 # Other values could be '6 months' or '30 days' etc (PeerTube will periodically delete old entries from database)
178 remote:
acfa2e30 179 max_age: '30 days'
cda03765 180
6702a1b2 181plugins:
aafbc63a
C
182 # The website PeerTube will ask for available PeerTube plugins and themes
183 # This is an unmoderated plugin index, so only install plugins/themes you trust
6702a1b2
C
184 index:
185 enabled: true
df9a1a13 186 check_latest_versions_interval: '12 hours' # How often you want to check new plugins/themes versions
6702a1b2
C
187 url: 'https://packages.joinpeertube.org'
188
3092e9bb
LB
189federation:
190 videos:
87568f93 191 federate_unlisted: false
3092e9bb 192
cda03765 193
509cd56a
C
194###############################################################################
195#
f209b32a 196# From this point, all the following keys can be overridden by the web interface
509cd56a
C
197# (local-production.json file). If you need to change some values, prefer to
198# use the web interface because the configuration will be automatically
199# reloaded without any need to restart PeerTube.
200#
201# /!\ If you already have a local-production.json file, the modification of the
202# following keys will have no effect /!\.
203#
204###############################################################################
205
62ccb24e
C
206cache:
207 previews:
f842e810
C
208 size: 500 # Max number of previews you want to cache
209 captions:
210 size: 500 # Max number of video captions/subtitles you want to cache
62ccb24e 211
4793c343 212admin:
a4101923
C
213 # Used to generate the root user at first startup
214 # And to receive emails from the contact form
4793c343 215 email: 'admin@example.com'
e22528ac 216
a4101923
C
217contact_form:
218 enabled: true
219
e22528ac
C
220signup:
221 enabled: false
62ccb24e 222 limit: 10 # When the limit is reached, registrations are disabled. -1 == unlimited
d9eaee39 223 requires_email_verification: false
6401417d 224 filters:
ff2c1fe8
RK
225 cidr: # You can specify CIDR ranges to whitelist (empty = no filtering) or blacklist
226 whitelist: []
227 blacklist: []
227d02fe 228
b0f9f39e
C
229user:
230 # Default value of maximum video BYTES the user can upload (does not take into account transcoded files).
231 # -1 == unlimited
232 video_quota: -1
bee0abff 233 video_quota_daily: -1
b0f9f39e 234
227d02fe 235# If enabled, the video will be transcoded to mp4 (x264) with "faststart" flag
09f35e2a
C
236# In addition, if some resolutions are enabled the mp4 video file will be transcoded to these new resolutions.
237# Please, do not disable transcoding since many uploaded videos will not work
227d02fe 238transcoding:
1125c40a 239 enabled: true
1896bca0 240
fccbbc1a 241 # Allow your users to upload .mkv, .mov, .avi, .wmv, .flv, .f4v, .3g2, .3gp, .mts, m2ts, .mxf, .nut videos
14e2014a 242 allow_additional_extensions: true
1896bca0 243
536598cf
C
244 # If a user uploads an audio file, PeerTube will create a video by merging the preview file and the audio file
245 allow_audio_files: true
1896bca0 246
9129b769 247 # Amount of threads used by ffmpeg for 1 transcoding job
98f535a5 248 threads: 1
9129b769
C
249 # Amount of transcoding jobs to execute in parallel
250 concurrency: 1
1896bca0
C
251
252 # Choose the transcoding profile
253 # New profiles can be added by plugins
254 # Available in core PeerTube: 'default'
255 profile: 'default'
256
09f35e2a 257 resolutions: # Only created if the original video has a higher resolution, uses more storage!
6ad88df8 258 0p: false # audio-only (creates mp4 without video stream, always created when enabled)
1125c40a
C
259 240p: false
260 360p: false
261 480p: false
262 720p: false
263 1080p: false
b7085c71 264 1440p: false
ad3405d0 265 2160p: false
d7a25329
C
266
267 # Generate videos in a WebTorrent format (what we do since the first PeerTube release)
268 # If you also enabled the hls format, it will multiply videos storage by 2
04cda1d7 269 # If disabled, breaks federation with PeerTube instances < 2.1
d7a25329
C
270 webtorrent:
271 enabled: true
272
5d9e4eaa 273 # /!\ Requires ffmpeg >= 4.1
7f8f8bdb 274 # Generate HLS playlists and fragmented MP4 files. Better playback than with WebTorrent:
09209296
C
275 # * Resolution change is smoother
276 # * Faster playback in particular with long videos
277 # * More stable playback (less bugs/infinite loading)
d7a25329 278 # If you also enabled the webtorrent format, it will multiply videos storage by 2
09209296
C
279 hls:
280 enabled: false
66b16caf 281
d2345ce9
C
282live:
283 enabled: false
284
285 # Limit lives duration
1896bca0 286 # -1 == unlimited
c9bc850e 287 max_duration: -1 # For example: '5 hours'
d2345ce9
C
288
289 # Limit max number of live videos created on your instance
290 # -1 == unlimited
291 max_instance_lives: 20
292
293 # Limit max number of live videos created by a user on your instance
294 # -1 == unlimited
295 max_user_lives: 3
296
297 # Allow your users to save a replay of their live
298 # PeerTube will transcode segments in a video file
299 # If the user daily/total quota is reached, PeerTube will stop the live
300 # /!\ transcoding.enabled (and not live.transcoding.enabled) has to be true to create a replay
301 allow_replay: true
302
4f20856e 303 # Your firewall should accept traffic from this port in TCP if you enable live
d2345ce9
C
304 rtmp:
305 port: 1935
306
307 # Allow to transcode the live streaming in multiple live resolutions
308 transcoding:
cf3e0d69 309 enabled: true
d2345ce9
C
310 threads: 2
311
1896bca0
C
312 # Choose the transcoding profile
313 # New profiles can be added by plugins
314 # Available in core PeerTube: 'default'
315 profile: 'default'
316
d2345ce9
C
317 resolutions:
318 240p: false
319 360p: false
320 480p: false
321 720p: false
322 1080p: false
b7085c71 323 1440p: false
d2345ce9
C
324 2160p: false
325
5d08a6a7
C
326import:
327 # Add ability for your users to import remote videos (from YouTube, torrent...)
328 videos:
9129b769
C
329 # Amount of import jobs to execute in parallel
330 concurrency: 1
331
5d08a6a7
C
332 http: # Classic HTTP or all sites supported by youtube-dl https://rg3.github.io/youtube-dl/supportedsites.html
333 enabled: false
e0409585 334
677012b4 335 # IPv6 is very strongly rate-limited on most sites supported by youtube-dl
e0409585
C
336 force_ipv4: false
337
be7ca0c6
C
338 # You can use an HTTP/HTTPS/SOCKS proxy with youtube-dl
339 proxy:
340 enabled: false
341 url: ""
a84b8fa5
C
342 torrent: # Magnet URI or torrent file (use classic TCP/UDP/WebSeed to download the file)
343 enabled: false
5d08a6a7 344
7ccddd7b
JM
345auto_blacklist:
346 # New videos automatically blacklisted so moderators can review before publishing
347 videos:
348 of_users:
5b9c965d
C
349 enabled: false
350
95540ed2 351# Instance settings
66b16caf
C
352instance:
353 name: 'PeerTube'
51de2c7f 354 short_description: 'PeerTube, an ActivityPub-federated video streaming platform using P2P directly in your web browser.'
8ae03c37
C
355 description: 'Welcome to this PeerTube instance!' # Support markdown
356 terms: 'No terms for now.' # Support markdown
357 code_of_conduct: '' # Supports markdown
358
359 # Who moderates the instance? What is the policy regarding NSFW videos? Political videos? etc
360 moderation_information: '' # Supports markdown
361
362 # Why did you create this instance?
d605328a 363 creation_reason: '' # Supports Markdown
8ae03c37
C
364
365 # Who is behind the instance? A single person? A non profit?
d605328a 366 administrator: '' # Supports Markdown
8ae03c37
C
367
368 # How long do you plan to maintain this instance?
d605328a 369 maintenance_lifetime: '' # Supports Markdown
8ae03c37 370
96a4a7c3 371 # How will you pay the PeerTube instance server? With your own funds? With users donations? Advertising?
d605328a 372 business_model: '' # Supports Markdown
8ae03c37 373
be04c6fd
C
374 # If you want to explain on what type of hardware your PeerTube instance runs
375 # Example: "2 vCore, 2GB RAM..."
376 hardware_information: '' # Supports Markdown
377
8ae03c37
C
378 # What are the main languages of your instance? To interact with your users for example
379 # Uncomment or add the languages you want
380 # List of supported languages: https://peertube.cpy.re/api/v1/videos/languages
381 languages:
382# - en
383# - es
384# - fr
385
386 # You can specify the main categories of your instance (dedicated to music, gaming or politics etc)
387 # Uncomment or add the category ids you want
388 # List of supported categories: https://peertube.cpy.re/api/v1/videos/categories
389 categories:
390# - 1 # Music
391# - 2 # Films
392# - 3 # Vehicles
393# - 4 # Art
394# - 5 # Sports
395# - 6 # Travels
396# - 7 # Gaming
397# - 8 # People
398# - 9 # Comedy
399# - 10 # Entertainment
400# - 11 # News & Politics
401# - 12 # How To
402# - 13 # Education
403# - 14 # Activism
404# - 15 # Science & Technology
405# - 16 # Animals
406# - 17 # Kids
407# - 18 # Food
408
901637bb 409 default_client_route: '/videos/trending'
8ae03c37 410
f8802489
C
411 # Whether or not the instance is dedicated to NSFW content
412 # Enabling it will allow other administrators to know that you are mainly federating sensitive content
413 # Moreover, the NSFW checkbox on video upload will be automatically checked by default
414 is_nsfw: false
0883b324
C
415 # By default, "do_not_list" or "blur" or "display" NSFW videos
416 # Could be overridden per user with a setting
417 default_nsfw_policy: 'do_not_list'
8ae03c37 418
00b5556c
C
419 customizations:
420 javascript: '' # Directly your JavaScript code (without <script> tags). Will be eval at runtime
421 css: '' # Directly your CSS code (without <style> tags). Will be injected at runtime
78881bc4 422 # Robot.txt rules. To disallow robots to crawl your instance and disallow indexation of your site, add '/' to "Disallow:'
ac235c37
RK
423 robots: |
424 User-agent: *
df182b37 425 Disallow:
5447516b
AH
426 # Security.txt rules. To discourage researchers from testing your instance and disable security.txt integration, set this to an empty string.
427 securitytxt:
1f4f1510 428 "# If you would like to report a security issue\n# you may report it to:\nContact: https://github.com/Chocobozzz/PeerTube/blob/develop/SECURITY.md\nContact: mailto:"
8be1afa1
C
429
430services:
431 # Cards configuration to format video in Twitter
432 twitter:
351d5225 433 username: '@Chocobozzz' # Indicates the Twitter account for the website or platform on which the content was published
8be1afa1
C
434 # If true, a video player will be embedded in the Twitter feed on PeerTube video share
435 # If false, we use an image link card that will redirect on your PeerTube instance
aafbc63a 436 # Change it to "true", and then test on https://cards-dev.twitter.com/validator to see if you are whitelisted
19f7b248 437 whitelisted: false
5b9c965d
C
438
439followers:
440 instance:
441 # Allow or not other instances to follow yours
442 enabled: true
14893eb7
C
443 # Whether or not an administrator must manually validate a new follower
444 manual_approval: false
7cd4d2ba 445
8424c402
C
446followings:
447 instance:
448 # If you want to automatically follow back new instance followers
449 # If this option is enabled, use the mute feature instead of deleting followings
450 # /!\ Don't enable this if you don't have a reactive moderation team /!\
451 auto_follow_back:
452 enabled: false
453
454 # If you want to automatically follow instances of the public index
455 # If this option is enabled, use the mute feature instead of deleting followings
456 # /!\ Don't enable this if you don't have a reactive moderation team /!\
457 auto_follow_index:
458 enabled: false
95cd31f1
C
459 # Host your own using https://framagit.org/framasoft/peertube/instances-peertube#peertube-auto-follow
460 index_url: ''
8424c402 461
7cd4d2ba
C
462theme:
463 default: 'default'
72c33e71
C
464
465broadcast_message:
466 enabled: false
467 message: '' # Support markdown
468 level: 'info' # 'info' | 'warning' | 'error'
469 dismissable: false
5fb2e288
C
470
471search:
472 # Add ability to fetch remote videos/actors by their URI, that may not be federated with your instance
473 # If enabled, the associated group will be able to "escape" from the instance follows
474 # That means they will be able to follow channels, watch videos, list videos of non followed instances
475 remote_uri:
476 users: true
477 anonymous: false
478
479 # Use a third party index instead of your local index, only for search results
480 # Useful to discover content outside of your instance
481 # If you enable search_index, you must enable remote_uri search for users
482 # If you do not enable remote_uri search for anonymous user, your instance will redirect the user on the origin instance
483 # instead of loading the video locally
484 search_index:
485 enabled: false
486 # URL of the search index, that should use the same search API and routes
487 # than PeerTube: https://docs.joinpeertube.org/api-rest-reference.html
488 # You should deploy your own with https://framagit.org/framasoft/peertube/search-index,
489 # and can use https://search.joinpeertube.org/ for tests, but keep in mind the latter is an unmoderated search index
490 url: ''
491 # You can disable local search, so users only use the search index
492 disable_local_search: false
493 # If you did not disable local search, you can decide to use the search index by default
494 is_default_search: false