2019-01-24 17:35:02 +00:00
### What can be configured and what are these configuration options?
The configuration file is located at [invidious/config/config.yml ](https://github.com/omarroth/invidious/blob/master/config/config.yml ).
2019-05-18 22:21:46 +00:00
- `channel_threads` (default `1` ) Number of threads to use for crawling videos from channels
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `feed_threads` (default `1` ) Number of threads to use for refreshing subscription feeds
2019-01-24 17:35:02 +00:00
```
db:
user: kemal # your database user
password: kemal # your database password
host: localhost # database host
port: 5432 # postgres port
```
2019-05-18 22:21:46 +00:00
- `full_refresh` (default `false` ) When crawling channel videos, threads should refresh *all* videos uploaded by a channel
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `https_only` (default `false` ) Used to tell Invidious it is accessed via https, set to `true` if you have for example a reverse proxy with a ssl certificate
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `domain` (default `nil` ) Domain to use for providing `self` links in RSS feeds, issuing cookies, etc.
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `hmac_key` (default `nil` ) Signing key for CSRF tokens (when `nil` is randomly generated on startup, can be any random string)
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `use_pubsub_feeds` (default `false` ) Use server-side notifications provided by [YouTube ](https://developers.google.com/youtube/v3/guides/push_notifications ). Requires `domain` and `hmac_key` to be set
2019-03-08 17:48:16 +00:00
2019-10-21 00:48:59 +00:00
- `default_home` (default `"Top"` ) Default home page **Moved into `default_user_preferences`**
2019-03-08 17:48:16 +00:00
2019-10-21 00:48:59 +00:00
- `feed_menu` (default `["Popular", "Top", "Trending", "Subscriptions"]` ) Order of tabs on feed menu **Moved into `default_user_preferences`**
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `top_enabled` (default `true` ) Whether top endpoints should be enabled (better privacy for smaller instances)
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `captcha_enabled` (default `true` ) Determine if CAPTCHA should be required for login/registration
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `login_enabled` (default `true` ) Whether users should be able to login
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `registration_enabled` (default `true` ) Whether new users should be able to register
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `statistics_enabled` (default `false` ) Whether statistics should be available from `/api/v1/stats`
2019-03-08 17:48:16 +00:00
2019-05-18 22:21:46 +00:00
- `admins` (default `[]` ) List of user IDs that have access to administrator preferences
2019-03-08 17:48:16 +00:00
2019-06-20 01:03:41 +00:00
- `external_port` (default `nil` ) Invidious should supply links to a different port (if running behind a proxy, for example). PubSub notifications (if enabled) will also be sent to this port
2019-05-06 02:18:15 +00:00
2019-10-21 00:48:59 +00:00
- `default_user_preferences` (default [`ConfigPreferences` ](https://github.com/omarroth/invidious/blob/master/src/invidious/helpers/helpers.cr#L127 )) Default preferences to use for new and unregistered users, see [#415 ](https://github.com/omarroth/invidious/issues/415 )
2019-05-06 02:18:15 +00:00
2019-05-18 22:21:46 +00:00
- `dmca_content` (default `[]` ) For compliance with DMCA requests, disables download widget for list of video IDs
2019-05-06 02:18:15 +00:00
2019-05-18 22:21:46 +00:00
- `check_tables` (default `false` ) Check table integrity, automatically try to add any missing columns, create columns, etc.
2019-05-06 02:18:15 +00:00
2019-05-18 22:21:46 +00:00
- `cache_annotations` (default `false` ) Cache annotations requested from IA, will not cache empty annotations or annotations that only contain cards
2019-05-06 02:18:15 +00:00
2019-05-18 22:21:46 +00:00
- `banner` (default `nil` ) Optional banner to be displayed along top of page for announcements, etc.
2019-07-08 17:25:26 +00:00
- `hsts` (default `true` ) For HTTP Strict Transport Security
2019-10-30 17:31:23 +00:00
- `disable_proxy` (default `false` ) Disable proxy option serverwide (options: 'dash', 'livestreams', 'downloads', 'local')
2019-10-30 17:35:06 +00:00
- `force_resolve` (default `nil` ) Force IPv4 or IPv6 connection to Google (options: 'ipv4', 'ipv6') see #811
- `pool_size` (default `100` ) Pool size for HTTP connections for youtube.com and ytimg.com (each domain has a separate pool of `pool_size` )
- `admin_email` (default `omarroth@protonmail.com` ) Email provided to users for bug reports