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