diff --git a/mkdocs/docs/advanced.md b/mkdocs/docs/advanced.md index 24d8fbc..a85f6f0 100644 --- a/mkdocs/docs/advanced.md +++ b/mkdocs/docs/advanced.md @@ -126,27 +126,7 @@ Then you can restart the container and the migration will run again. If your err This project strives for timely updates when yt-dlp makes a new release, but sometimes ideals meet reality. Also, sometimes yt-dlp has a fix published, but not yet released. -**Build your own image**: Update the version in `requirements.txt` and rebuild the image from `Dockerfile`. This will use your own image, even on container rebuild. - -**Update yt-dlp on its own**: You can also update the yt-dlp library alone in the container. - -- Restart your container for changes to take effect. -- These changes won't persist a container rebuild from image. - -Update to newest regular yt-dlp release: - -```bash -pip install --upgrade yt-dlp -``` - -To update to nightly you'll have to specify the correct `--target` folder: -```bash -pip install \ - --upgrade \ - --target=/root/.local/bin \ - https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz -``` -This is obviously particularly likely to create problems. Also note that the `--version` command will only show the latest regular release, not a nightly version mentioned. +To update, set the [TA_AUTO_UPDATE_YTDLP](installation/env-vars.md#ta_auto_update_ytdlp) environment variable and restart your container. If this makes things worse and you wish to undo the update, unset the variable and recreate your container. ## Erase errors from download queue Sometimes videos will fail to download. That can be because of expected errors: diff --git a/mkdocs/docs/installation/env-vars.md b/mkdocs/docs/installation/env-vars.md index ae58a0a..decb1af 100644 --- a/mkdocs/docs/installation/env-vars.md +++ b/mkdocs/docs/installation/env-vars.md @@ -81,6 +81,14 @@ Configure TA to authenticate with a auth proxy. See [configuration/forward-auth] Type: Boolean Configure TA to use LDAP for authentication. See [configuration/ldap](../configuration/ldap.md) for more details. +## TA_AUTO_UPDATE_YTDLP +Optional +Type: String +Configure TA to automatically install the latest yt-dlp on container start. Enable by setting to `release` or `nightly` depending on which version you would like to install. + +!!! warning "Potential Incompatibility" + Future versions of yt-dlp may not be compatible with your current Tube Archivist version. If you encounter errors while downloading, remove the value and recreate your container to restore the default version. + ## DISABLE_STATIC_AUTH Optional Type: Boolean