mirrors/invidious
1
0
Fork 0
mirror of https://github.com/iv-org/invidious.git synced 2025-09-15 00:08:30 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Better documentation for the specific case public_url with companion

Browse Source
This commit is contained in:
Émilien (perso) 2025-09-10 21:30:18 +02:00
parent 9e160d45d3
commit 14a629a4e8
1 changed files with 14 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
config/config.example.yml
View File

@ -61,39 +61,32 @@ db:
## When this setting is commented out, Invidious companion is not used. ## When this setting is commented out, Invidious companion is not used.
## Otherwise, Invidious will proxy the requests to Invidious companion. ## Otherwise, Invidious will proxy the requests to Invidious companion.
## ##
## Note: multiple URL can be configured. In this case, invidious will ## Note: multiple URL can be configured. In this case, Invidious will
## randomly pick one every time video data needs to be retrieved. This ## randomly pick one every time video data needs to be retrieved. This
## URL is then kept in the video metadata cache to allow video playback ## URL is then kept in the video metadata cache to allow video playback
## to work. Once said cache has expired, requesting that video's data ## to work. Once said cache has expired, requesting that video's data
## again will cause a new companion URL to be picked. ## again will cause a new companion URL to be picked.
## ##
## The parameter private_url needs to be configured for the internal ## The parameter private_url is required for the internal communication
## communication between the companion and Invidious. ## between Invidious companion and Invidious.
## And public_url is the public URL from which companion is listening
## to the requests from the user(s).
## ##
## If you are using a reverse proxy then you will probably need to ## The optional parameter public_url is the public URL from which
## configure the public_url to be the same as the domain used for Invidious. ## Invidious companion is listening to the requests from the user(s).
## Also apply when used from an external IP address (without a domain). ## When this setting is commented out, Invidious proxy all requests to
## Examples: https://MYINVIDIOUSDOMAIN/companion or http://192.168.1.100:8282/companion ## Invidious companion. Useful for simple setups.
## ## Otherwise, requests from the user(s) will reach Invidious companion directly.
## Both parameter can have identical URL when Invidious is hosted in ## And you will need to configure a reverse proxy with separate routes
## an internal network or at home or locally (localhost). ## for Invidious and Invidious companion.
## ## Read the post-install documentation for advanced reverse proxy
## NOTE: If public_url is omitted, Invidious will use its built-in proxy ## documentation: https://docs.invidious.io/installation/#post-install-configuration
## to route companion requests through /companion, which is useful for
## simple setups where companion runs on the same network. When using
## the built-in proxy, CSP headers are not modified since requests
## stay within the same domain.
## ##
## Accepted values: "http(s)://<IP-HOSTNAME>:<Port>" ## Accepted values: "http(s)://<IP-HOSTNAME>:<Port>"
## Default: <none> ## Default: <none>
## ##
#invidious_companion: #invidious_companion:
# - private_url: "http://localhost:8282/companion" # - private_url: "http://localhost:8282/companion"
# public_url: "http://localhost:8282/companion" # # Uncomment for advanced reverse proxy configuration (see above).
# # Example with built-in proxy (omit public_url): # # public_url: "http://localhost:8282/companion"
# # - private_url: "http://localhost:8282/companion"
## ##
## API key for Invidious companion, used for securing the communication ## API key for Invidious companion, used for securing the communication