]> git.immae.eu Git - github/Chocobozzz/PeerTube.git/blobdiff - CHANGELOG.md
Bumped to version v5.2.1
[github/Chocobozzz/PeerTube.git] / CHANGELOG.md
index 0513356e347cef50a157d1d4047861624d0adac3..e2be0f5e2fcf417a11c7bd88673d69c938ffc0af 100644 (file)
@@ -1,5 +1,201 @@
 # Changelog
 
+## v5.2.1
+
+### Bug fixes
+
+ * Fix loading spinner displayed forever on Chrome
+ * Fix broken replay with long live name
+ * Fix fps transcoding on remote runners
+ * Fix terms/code of conduct link toggle
+
+
+## v5.2.0
+
+### IMPORTANT NOTES
+
+  * **Important** Remove NodeJS 14 support
+  * **Important** You must update your nginx configuration to support remote runners: https://github.com/Chocobozzz/PeerTube/blob/develop/support/nginx/peertube#L101
+  * Add `storage.tmp_persistent` directory in configuration file. **You must configure it in your production.yaml**: https://github.com/Chocobozzz/PeerTube/blob/develop/config/production.yaml.example#L128
+  * PeerTube requires **Docker Compose >= v2** for Docker compose installation
+
+### Maintenance
+
+  * Remove `npm run create-transcoding-job` and `npm run print-transcode-command` unmaintained scripts
+  * Add Redis sentinel support [#5593](https://github.com/Chocobozzz/PeerTube/pull/5593)
+  * Improve upgrade script (used when you will upgrade from PeerTube 5.2 to its next version) for classic installation:
+    * Automatically generate a `config/production.yaml.new` file after the upgrade, which is the fusion between the new PeerTube configuration keys and your current `production.yaml`. After a review you can replace your old `config/production.yaml` with this new file so you don't have to add new keys manually
+    * Add `ls` option compatibility with FreeBSD [#5785](https://github.com/Chocobozzz/PeerTube/pull/5785)
+
+### Docker
+
+  * Make database name configurable using env variable [#5734](https://github.com/Chocobozzz/PeerTube/pull/5734)
+
+### Plugins/Themes/Embed API
+
+  * Add `filter:html.client.json-ld.result` hook
+
+### Features
+
+  * :tada: Implement remote transcoding for VOD videos, Live streams and Studio editions :tada: [#5769](https://github.com/Chocobozzz/PeerTube/pull/5769)
+    * If enabled, remote PeerTube runners can process these high CPU jobs
+    * Admin documentation: https://docs.joinpeertube.org/admin/remote-runners
+    * PeerTube runner CLI documentation: https://docs.joinpeertube.org/maintain/tools#peertube-runner
+    * Demonstration video: https://peertube2.cpy.re/w/oJwHHYwt4oKjKhLNh2diAY
+    * Architecture documentation: https://docs.joinpeertube.org/contribute/architecture#remote-vod-live-transcoding
+  * Add Podcast RSS feed support: [#5487](https://github.com/Chocobozzz/PeerTube/pull/5487)
+  * Add ability to set custom privacy for live replays [#5692](https://github.com/Chocobozzz/PeerTube/pull/5692)
+  * Render images of markdown fields in *About* page [#5732](https://github.com/Chocobozzz/PeerTube/pull/5732)
+  * Admin can disable user video history by default [#5728](https://github.com/Chocobozzz/PeerTube/pull/5728)
+  * Improve global accessibility
+
+### Bug fixes
+
+  * Fix live stream object storage sync resulting in broken playback on iOS after a few minutes
+  * Correctly proxify HTTP 206 content-range header from object storage [#5703](https://github.com/Chocobozzz/PeerTube/pull/5703)
+  * Filter out already watched videos from recommended videos [#5739](https://github.com/Chocobozzz/PeerTube/pull/5739)
+  * Prevent exception when HTTP headers are already sent
+  * Fix remote instance following/followers links in about page
+  * Prevent error when updating a running live stream if the privacy hasn't changed
+  * Prevent crash on plugin websocket error
+  * Don't call `register`/`unregister` plugin API when installing/uninstalling plugins using `script/plugin` scripts (offline mode)
+  * Fix error on missing plugin CSS file at PeerTube startup [#5746](https://github.com/Chocobozzz/PeerTube/pull/5746)
+  * Prevent "invalid end watch section" server log warnings
+  * Support remote subscribe with a handle starting with a `@` character
+  * Actor preferred username (account/channel handle) is now case insensitive
+  * Fix RTL layout inconsistencies
+  * Prevent user video notification when the subscription is still in *Pending* state
+  * Correctly remove *Pending* subscription
+  * Fix PeerTube subtitles import
+  * Fix languages alphabetical order
+  * Fix registration notification error
+  * Correctly unload plugin paths
+  * Fix custom default route in instance logo link
+  * Fix video channels quick filter overflow
+
+
+## v5.1.0
+
+### IMPORTANT NOTES
+
+ * If your instance has signup enabled, user registration approval is automatically enabled by the default configuration of this release. You can change this setting in your `production.yaml` or in the configuration page in the web admin
+ * Update [web browsers support list](https://joinpeertube.org/faq#what-web-browsers-are-supported-by-peertube):
+   * Drop support of Safari 11 on iOS
+   * Drop support of Safari 11 on desktop
+   * Drop support of Firefox 68 on desktop
+ * Minimum recommended Redis version is 6.2. Version 6.0 should still work: see [this comment](https://github.com/Chocobozzz/PeerTube/issues/5659#issuecomment-1449607001) for more information
+ * Deprecate NodeJS 14: support will be removed in the next release (PeerTube 5.2)
+
+### Maintenance
+
+ * [PeerTube OpenTelemetry](https://docs.joinpeertube.org/maintain/observability)
+   * Add BitTorrent tracker metrics
+   * Add ability to disable HTTP request duration metrics (can have a high tag cardinality)
+ * Add `x-powered-by` HTTP header in PeerTube response. Can be disabled in PeerTube configuration
+
+### Docker
+
+ * Add env variables to configure object storage
+
+### Documentation
+
+  * PeerTube documentation website now uses VitePress: https://docs.joinpeertube.org
+  * Add *Server code* documentation explaining the database model typing and how to add a new feature in PeerTube server: https://docs.joinpeertube.org/support/doc/development/server
+
+### Plugins/Themes/Embed API
+
+ * Add ability to set `playbackRate` in URL (watch page and embed) [#5486](https://github.com/Chocobozzz/PeerTube/pull/5486)
+ * Auth plugins:
+   * Can set default `adminFlags`, `videoQuota` and `videoQuotaDaily` user attributes
+   * Introduce `userUpdater` hook function so external auth plugins can update the user on user login: https://docs.joinpeertube.org/contribute/plugins#add-external-auth-methods
+   * Automatically redirect to the default external auth on PeerTube refresh token expiration
+ * Server plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * Add `filter:api.user.me.subscription-videos.list.params` & `filter:api.user.me.subscription-videos.list.result` [#5648](https://github.com/Chocobozzz/PeerTube/pull/5648)
+    * Add `filter:activity-pub.activity.context.build.result` to update ActivityPub JSON-LD context
+    * Add `filter:activity-pub.video.json-ld.build.result` to update `Video` ActivityPub JSON-LD object
+    * Add `action:activity-pub.remote-video.created` & `action:activity-pub.remote-video.updated` to react on remote video creation/update
+  * Client plugin hooks (https://docs.joinpeertube.org/api/plugins):
+    * Add `action:video-edit.form.updated` fired every time the video upload/import/live/update form values change
+    * Add `filter:video-watch.video-plugin-metadata.result` to add custom video metadata in watch page
+    * Existing `action:video-edit.init` hook now contains a `updateForm` attribute in options that you can use to update video upload/import/live/update form values
+ * Add server plugin helpers:
+   * `getServerListeningConfig` to get PeerTube listening configuration
+ * Convert some colors to PeerTube CSS variables to improve theme compatibility
+
+### Features
+
+ * :tada: Implement user registration approval (https://docs.joinpeertube.org/admin/managing-users#registration-approval) [#5544](https://github.com/Chocobozzz/PeerTube/pull/5544)
+   * If enabled, the user has to fill a *Registration reason* input
+   * Moderators have to to accept/reject the registration with a *Moderation response* that will be sent by email to the user
+   * If the registration is accepted, the user and its channel are automatically created
+ * Add "back to live" button in player
+   * The *Live* button is red when the player is synced with the live
+   * It becomes grey when behind the live edge
+   * Clicking on the grey button re-sync the player with the live edge
+ * Add Icelandic & Ukrainian locales
+ * Add *Global views* default trending algorithm option in admin configuration [#5471](https://github.com/Chocobozzz/PeerTube/pull/5471)
+ * Performance:
+   * Blocked IPs by the tracker are now stored in NodeJS memory instead of Redis, reducing PeerTube load
+   * Optimize video comments SQL requests
+   * Optimize custom markup live rendering in admin
+  * UI/UX:
+    * Add option in video/playlist share modal to create a responsive embed [#5690](https://github.com/Chocobozzz/PeerTube/pull/5690)
+    * Use `99+` instead of `99` when having more than `99` notifications
+    * Use channel display name instead of channel handle in *My videos* input filter [#5575](https://github.com/Chocobozzz/PeerTube/pull/5575)
+    * Display channel name in playlist element instead of account name
+    * Display channel as author in RSS feeds
+    * Improve/fix main pages keyboard navigation
+  * Custom markup:
+    * Support `mailto` links
+    * Support short UUID to fetch a video
+  * Admins can customize access and refresh tokens lifetime
+
+
+### Bug fixes
+
+ * Fix object storage incompatibility with some S3 providers that don't support ACL
+ * Fix signup limit
+ * Prevent `500` on invalid short UUID parameter
+ * Player:
+   * Fix live buffering with small latency setting
+   * More robust player "stats for nerds" popup if there is not stream available
+   * Don't display playback rate setting for lives
+   * Don't handle playback rate hotkeys for lives
+   * Fix clicking on PeerTube instance button
+   * Fix always resuming the end of the video
+   * Fix saving last video current time for anonymous users
+   * Fix player keyboard shortcuts for non latin keyboards [#5684](https://github.com/Chocobozzz/PeerTube/pull/5684)
+ * Process videos list requests in correct order
+ * Correctly fill the *Support* field when updating a video
+ * Fix *Auto play video* setting for anonymous users
+ * UI:
+   * Fix table columns max width
+   * Use *Unknown* instead of *Misc* when the video category is not set
+   * Prevent layout shift when listing videos
+   * Fix instance stats anchor link
+   * Fix menu content overlay on tablets
+   * Fix button overflows
+   * Handle `502` HTTP errors in client notifier
+   * Fix resetting chart zoom in video stats page
+   * Fix search page not loading all available results
+   * Fix confirmation modal that contains 2 text inputs
+ * Display the update button when the stable release of beta/alpha plugin is available
+ * Always list NSFW videos in playlists (the frontend is in charge to blur the video element if the NSFW setting is *Hide* or *Blur*)
+ * Always list NSFW videos in admin
+ * Improve client log report:
+   * Don't send client error on 404
+   * Prevent sending invalid error/warn logs coming from HLS player [#5484](https://github.com/Chocobozzz/PeerTube/pull/5484)
+ * Fix out of sync audio when cutting a video in Studio
+ * Fix "unique viewers" inconsistency with countries
+ * Fix mention detection in comments
+ * Fix listing all my channels in *My library*
+ * Fix displaying remote avatars
+ * Fix 404 HTTP code in watch page when having `;threadId` param in URL
+ * Correctly re-inject video file token in `.m3u8` resolution playlists to fetch private mp4 video file [#5677](https://github.com/Chocobozzz/PeerTube/pull/5677)
+ * Don't process live when moving videos to external storage
+ * Handle Redis disconnection gracefully [#5599](https://github.com/Chocobozzz/PeerTube/pull/5599)
+
+
 ## v5.0.1
 
 ### IMPORTANT NOTES
    * Classic installation: `cd /var/www/peertube/peertube-latest && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production node dist/scripts/migrations/peertube-5.0.js`
    * Docker installation: `cd /var/www/peertube-docker && docker-compose exec -u peertube peertube node dist/scripts/migrations/peertube-5.0.js`
  * Configuration changes (`config/production.yaml`):
-   * There is a new `secrets.peertube` configuration. You must fill it before running PeerTube v5: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/config/production.yaml.example#L14
+   * There is a new `secrets.peertube` configuration:
+     * Classic install: fill it before running PeerTube v5: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/config/production.yaml.example#L14
+     * Docker install: fill it using an env variable before running the containers: https://github.com/Chocobozzz/PeerTube/blob/develop/support/docker/production/.env#L27
    * `object_storage.upload_acl` is now a parent key that you must update: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/config/production.yaml.example#L153
  * You must update your nginx configuration:
    * We introduced a new `location` for plugin websocket routes: https://github.com/Chocobozzz/PeerTube/blob/v5.0.0/support/nginx/peertube#L135
 
 ### Documentation
 
- * Add [Monitoring/Observability documentation](https://docs.joinpeertube.org/maintain-observability) using PeerTube OpenTelemetry feature
+ * Add [Monitoring/Observability documentation](https://docs.joinpeertube.org/maintain/observability) using PeerTube OpenTelemetry feature
 
 ### Maintenance
 
 
 ### Plugins/Themes/Embed API
 
-  * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+  * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
     * `filter:activity-pub.remote-video-comment.create.accept.result`
   * Add server plugin helpers
     * `socket.sendNotification` and `socket.sendVideoLiveNewState` [#5239](https://github.com/Chocobozzz/PeerTube/pull/5239)
   * Add ability for plugins to register a websocket route using `registerWebSocketRoute`
-  * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+  * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
     * `filter:internal.player.p2p-media-loader.options.result` [#5318](https://github.com/Chocobozzz/PeerTube/pull/5318)
 
 ### CLI tools
 
   * Theme:
     * Removed unused `--secondaryColor` CSS variable
-  * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+  * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
     * `filter:api.my-library.video-playlist-elements.list.params` & `filter:api.my-library.video-playlist-elements.list.result` [#5098](https://github.com/Chocobozzz/PeerTube/pull/5098)
     * `action:video-channel-create.init`
     * `action:video-channel-update.init` & `action:video-channel-update.video-channel.loaded`
     * `filter:share.video-embed-url.build.params` & `filter:share.video-embed-url.build.result` & `filter:share.video-playlist-embed-url.build.params` & `filter:share.video-playlist-embed-url.build.result`
     * `filter:share.video-url.build.params` & `filter:share.video-url.build.result` & `filter:share.video-playlist-url.build.params` & `filter:share.video-playlist-url.build.result`
     * `action:modal.share.shown`
-  * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+  * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
     * `filter:job-queue.process.params` & `filter:job-queue.process.result`
     * `filter:transcoding.manual.resolutions-to-transcode.result` & `filter:transcoding.auto.resolutions-to-transcode.result`
     * `action:api.video-channel.created` & `action:api.video-channel.updated` & `action:api.video-channel.deleted`
     * `action:notifier.notification.created`
-  * Add HTML placeholder (https://docs.joinpeertube.org/contribute-plugins?id=html-placeholder-elements):
+  * Add HTML placeholder (https://docs.joinpeertube.org/contribute/plugins#html-placeholder-elements):
     * `share-modal-playlist-settings` & `share-modal-video-settings`
 
 ### Features
    * Classic installation: `cd /var/www/peertube/peertube-latest && sudo -u peertube NODE_CONFIG_DIR=/var/www/peertube/config NODE_ENV=production node dist/scripts/migrations/peertube-4.2.js`
    * Docker installation: `cd /var/www/peertube-docker && docker-compose exec -u peertube peertube node dist/scripts/migrations/peertube-4.2.js`
  * **Important** SQL migrations (in particular `0685-multiple-actor-images`) can take several minutes to complete
- * **Important** You must update your nginx configuration to support video web editor: https://docs.joinpeertube.org/install-any-os?id=nginx
+ * **Important** You must update your nginx configuration to support video web editor: https://docs.joinpeertube.org/install/any-os#nginx
  * REST API:
    * `PUT /api/v1/videos/{id}/watching` is deprecated, use `POST /api/v1/videos/videos/{id}/views` instead: https://docs.joinpeertube.org/api-rest-reference.html#operation/addView
 
    * `filter:api.video-playlist.videos.list.params` and `filter:api.video-playlist.videos.list.result`
  * Support `getSettings()`, `isLoggedIn()` and `getAuthHeader()` client plugin helpers in embed
  * Player URL query parameters:
-   * Support `controlBar=0` to hide player control bar. See [the documentation](https://docs.joinpeertube.org/api-embed-player?id=url-parameters) for more information
+   * Support `controlBar=0` to hide player control bar. See [the documentation](https://docs.joinpeertube.org/api/embed-player#url-parameters) for more information
 
 ### Features
 
 
 ### Plugins/Themes/Embed API
 
- * Introduce ability for plugins to create client pages: https://docs.joinpeertube.org/contribute-plugins?id=create-client-page
- * Plugins that register custom video fields can choose in which tab they want to display them and can report errors: https://docs.joinpeertube.org/contribute-plugins?id=add-custom-fields-to-video-form
+ * Introduce ability for plugins to create client pages: https://docs.joinpeertube.org/contribute/plugins#create-client-page
+ * Plugins that register custom video fields can choose in which tab they want to display them and can report errors: https://docs.joinpeertube.org/contribute/plugins#add-custom-fields-to-video-form
  * Add new client plugin id selectors
    * Add `#plugin-selector-about-instance-moderation`, `#plugin-selector-about-instance-other-information`, `#plugin-selector-about-instance-features`, `#plugin-selector-about-instance-statistics`, `#plugin-selector-about-menu-instance`, `#plugin-selector-about-menu-peertube`, `#plugin-selector-about-menu-network` in about page [#4597](https://github.com/Chocobozzz/PeerTube/pull/4597)
    * Add `#plugin-selector-menu-user-dropdown-language-item` in menu [#4597](https://github.com/Chocobozzz/PeerTube/pull/4597)
 
 ### Plugins/Themes/Embed API
 
-*Documentation: https://docs.joinpeertube.org/api-plugins*
+*Documentation: https://docs.joinpeertube.org/api/plugins*
 
  * Add client plugin hooks:
    * `filter:api.video-watch.video-playlist-elements.get.params` and `filter:api.video-watch.video-playlist-elements.get.result` [#4387](https://github.com/Chocobozzz/PeerTube/pull/4387)
- * Introduce plugin id selectors: https://docs.joinpeertube.org/contribute-plugins?id=plugin-selector-on-html-elements
+ * Introduce plugin id selectors: https://docs.joinpeertube.org/contribute/plugins#plugin-selector-on-html-elements
    * Add `#plugin-selector-login-form` to login form
 
 ### Docker
 
 ### CLI tools
 
- * Add [create-move-video-storage-jobs](https://docs.joinpeertube.org/maintain-tools?id=create-move-video-storage-jobjs) script to move local video files in object storage [#4481](https://github.com/Chocobozzz/PeerTube/pull/4481)
+ * Add [create-move-video-storage-jobs](https://docs.joinpeertube.org/maintain/tools#create-move-video-storage-jobjs) script to move local video files in object storage [#4481](https://github.com/Chocobozzz/PeerTube/pull/4481)
  * Removed `peertube-repl` and `peertube-watch` scripts
  * Apply import interval only when reasonable [#4552](https://github.com/Chocobozzz/PeerTube/pull/4552)
 
 
 ### Plugins/Themes/Embed API
 
-*Documentation: https://docs.joinpeertube.org/api-plugins*
+*Documentation: https://docs.joinpeertube.org/api/plugins*
 
  * Server helpers
    * **Deprecate** `videoLanguageManager.addLanguage` and `videoLanguageManager.deleteLanguage`: use `videoLanguageManager.addConstant` and `videoLanguageManager.deleteConstant` instead
 
 ### Custom markup API
 
-*Documentation: https://docs.joinpeertube.org/api-custom-client-markup*
+*Documentation: https://docs.joinpeertube.org/api/custom-client-markup*
 
  * Add ability to only display VOD or live videos in `<peertube-videos-list>` element
  * `<peertube-container>` fills all available width. Can be changed using `data-justify-content` attribute
    * Hide or display sensitive content
    * Choose to display all videos or only local videos
  * :tada: **Beta:** Add support for saving video files in object storage [#4290](https://github.com/Chocobozzz/PeerTube/pull/4290)
-   * Check the documentation: https://docs.joinpeertube.org/admin-remote-storage
+   * Check the documentation: https://docs.joinpeertube.org/admin/remote-storage
  * :tada: Add ability for instances to follow any actor (so specific accounts and channels)
  * Updated HLS.js (library to play HLS playlists in PeerTube player) to V1:
    * Remember last bandwidth to prevent resolution change at the beginning of the video
 ### IMPORTANT NOTES
 
  * **Important:** v3.2.0 introduced a `pg_dump` export bug in the auto upgrade script. v3.2.1 fixed this bug. To upgrade from v3.2.**0**:
-   * You can upgrade manually https://docs.joinpeertube.org/install-any-os?id=manually
+   * You can upgrade manually https://docs.joinpeertube.org/install/any-os#manually
    * Or you can apply the changes introduced in this commit: https://github.com/Chocobozzz/PeerTube/commit/86dc0b9cc9374cba7548bb613ff43d92f90570a8 and then use the auto upgrade script
  * **Important:** Due to a bug in ffmpeg, PeerTube is not compatible with ffmpeg 4.4. See https://github.com/Chocobozzz/PeerTube/issues/3990
 
 
  * Add client helpers:
    * `getBaseRouterRoute()` [#4153](https://github.com/Chocobozzz/PeerTube/pull/4153)
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:left-menu.links.create.result` to add/remove left menu links
    * `filter:internal.player.videojs.options.result` to filter options sent to videojs player [#4126](https://github.com/Chocobozzz/PeerTube/pull/4126)
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:api.video-playlist-element.created`
 
 
 ### Features
 
- * :tada: Add ability to create a custom homepage using HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api-custom-client-markup) [#4007](https://github.com/Chocobozzz/PeerTube/pull/4007)
+ * :tada: Add ability to create a custom homepage using HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api/custom-client-markup) [#4007](https://github.com/Chocobozzz/PeerTube/pull/4007)
  * :tada: Add ability to search playlists in PeerTube instance and [SepiaSearch](https://sepiasearch.org/)
  * :tada: Shorter public URLs (old URLs are still supported):
    * Handle short UUID (`8r4jooaQpHp8tw1E1qpSeYq` instead of `3caf7bea-5ceb-4959-81a0-b44d184e897c`) for playlists and videos
    * Use `/a/:accountName` instead of `/accounts/:accountName` and `/c/:channelName` instead of `/video-channels/:channelName` [#4009](https://github.com/Chocobozzz/PeerTube/pull/4009)
    * Provide `/@:username` page that automatically redirect to the account or channel page [#4009](https://github.com/Chocobozzz/PeerTube/pull/4009)
  * :tada: Add RTL layout support
- * Add ability to use HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api-custom-client-markup) in instance description
+ * Add ability to use HTML, markdown and [custom HTML tags](https://docs.joinpeertube.org/api/custom-client-markup) in instance description
  * Default to dark theme (if available) if requested by the web browser
  * Add ability for admins to configure minimum age required in signup page [#4010](https://github.com/Chocobozzz/PeerTube/pull/4010)
  * Use a dedicated URL for each tab in publish page
 ### IMPORTANT NOTES
 
  * **Important:** v3.2.0 introduced a `pg_dump` export bug in the auto upgrade script. To upgrade from v3.2.0:
-   * You can upgrade manually https://docs.joinpeertube.org/install-any-os?id=manually
+   * You can upgrade manually https://docs.joinpeertube.org/install/any-os#manually
    * Or you can apply the changes introduced in this commit: https://github.com/Chocobozzz/PeerTube/commit/86dc0b9cc9374cba7548bb613ff43d92f90570a8 and then use the auto upgrade script
 
 ### Bug fixes
  * **Important:** Drop NodeJS 10 support
  * PeerTube is not compatible with NodeJS 16 yet
  * By default, HLS transcoding is now enabled and webtorrent is disabled. We suggest you to reflect this change.
- See [the documentation](https://docs.joinpeertube.org/admin-configuration?id=webtorrent-transcoding-or-hls-transcoding) for more information
+ See [the documentation](https://docs.joinpeertube.org/admin/configuration#webtorrent-transcoding-or-hls-transcoding) for more information
  * PeerTube client now displays bigger video thumbnails.
- To fix old thumbnails quality, run `regenerate-thumbnails` script after your PeerTube upgrade: https://docs.joinpeertube.org/maintain-tools?id=regenerate-thumbnailsjs
+ To fix old thumbnails quality, run `regenerate-thumbnails` script after your PeerTube upgrade: https://docs.joinpeertube.org/maintain/tools#regenerate-thumbnailsjs
 
 ### Docker
 
 
  * Theme:
    * `--submenuColor` becomes `--submenuBackgroundColor`
- * Support HTML placeholders for plugins. See [the documentation](https://docs.joinpeertube.org/contribute-plugins?id=html-placeholder-elements) for more information
+ * Support HTML placeholders for plugins. See [the documentation](https://docs.joinpeertube.org/contribute/plugins#html-placeholder-elements) for more information
    * `player-next` next to the PeerTube player
- * Support storing files for plugins in a dedicated directory. See [the documentation](https://docs.joinpeertube.org/contribute-plugins?id=storage) for more information
+ * Support storing files for plugins in a dedicated directory. See [the documentation](https://docs.joinpeertube.org/contribute/plugins#storage) for more information
  * Transcoding:
    * Add `inputOptions` option support for transcoding profile [#3917](https://github.com/Chocobozzz/PeerTube/pull/3917)
    * Add `scaleFilter.name` option support for transcoding profile [#3917](https://github.com/Chocobozzz/PeerTube/pull/3917)
    * `plugin.getBaseRouterRoute()`
    * `plugin.getDataDirectoryPath()`
    * `user.getAuthUser()`
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:modal.video-download.shown`
    * `action:video-upload.init`
    * `action:video-url-import.init`
    * `action:auth-user.logged-in` & `action:auth-user.logged-out`
    * `action:auth-user.information-loaded`
    * `action:admin-plugin-settings.init`
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.download.video.allowed.result` & `filter:api.download.torrent.allowed.result` to forbid download
    * `filter:html.embed.video-playlist.allowed.result` & `filter:html.embed.video.allowed.result` to forbid embed
    * `filter:api.search.videos.local.list.params` & `filter:api.search.videos.local.list.result`
 
 ### Plugins/Themes/Embed API
 
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.user.me.videos.list.params` and `filter:api.user.me.videos.list.result`
  * Add server helpers:
    * `videos.loadByIdOrUUID`
- * Add server transcoding helpers (https://docs.joinpeertube.org/contribute-plugins?id=add-new-transcoding-profiles):
+ * Add server transcoding helpers (https://docs.joinpeertube.org/contribute/plugins#add-new-transcoding-profiles):
    * `transcodingManager.addVODProfile`
    * `transcodingManager.addVODEncoderPriority`
    * `transcodingManager.addLiveProfile`
 
 ### Docker
 
- * Fix [upgrade documentation](https://docs.joinpeertube.org/install-docker?id=upgrade)
+ * Fix [upgrade documentation](https://docs.joinpeertube.org/install/docker#upgrade)
  * Add live RTMP port in docker compose
 
 ### Bug fixes
  * Replace traefik by nginx in our docker-compose template:
    * Better consistency with our default setup (we now use the same stack)
    * Use our default nginx template enabling many optimizations
-   * Update the documentation to take into account this change: https://docs.joinpeertube.org/install-docker
+   * Update the documentation to take into account this change: https://docs.joinpeertube.org/install/docker
 
 ### Plugins/Themes/Embed API
 
  * Add ability for auth plugins to redirect user on logout [#32](https://framagit.org/framasoft/peertube/PeerTube/-/merge_requests/32) & [#33](https://framagit.org/framasoft/peertube/PeerTube/-/merge_requests/33)
  * Add `input-password` setting to plugins [#3375](https://github.com/Chocobozzz/PeerTube/issues/3375)
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.accounts.videos.list.params`
    * `filter:api.accounts.videos.list.result`
    * `filter:api.video-channels.videos.list.params`
 
 ### Plugins/Themes/Embed API
 
- * Add embed API (https://docs.joinpeertube.org/api-embed-player):
+ * Add embed API (https://docs.joinpeertube.org/api/embed-player):
    * `playNextVideo` method
    * `playPreviousVideo` method
    * `getCurrentPosition` method
  * Embed URL parameters
    * Add ability to disable PeerTube link in embed using an URL param (`peertubeLink=0`)
  * Add plugins support in embed
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:embed.player.loaded` (for embed)
- * Add custom fields in video update/upload form using `registerVideoField` (https://docs.joinpeertube.org/contribute-plugins?id=add-custom-fields-to-video-form)
+ * Add custom fields in video update/upload form using `registerVideoField` (https://docs.joinpeertube.org/contribute/plugins#add-custom-fields-to-video-form)
 
 ### Features
 
@@ -1571,7 +1769,7 @@ A new endpoint to report videos will be created in PeerTube 2.4 and will also al
 
 ### CLI tools
 
- * Add redundancy CLI: https://docs.joinpeertube.org/maintain-tools?id=peertube-redundancyjs
+ * Add redundancy CLI: https://docs.joinpeertube.org/maintain/tools#peertube-redundancyjs
  * Add ability to pass remaining options to youtube-dl binary in peertube-import script ([@drzraf](https://github.com/drzraf))
 
 ### Docker
@@ -1581,19 +1779,19 @@ A new endpoint to report videos will be created in PeerTube 2.4 and will also al
 
 ### Maintenance
 
- * Add nginx configuration to redirect videos to an S3 bucket ([@rigelk](https://github.com/rigelk)) and update of the [corresponding documentation](https://docs.joinpeertube.org/admin-remote-storage).
+ * Add nginx configuration to redirect videos to an S3 bucket ([@rigelk](https://github.com/rigelk)) and update of the [corresponding documentation](https://docs.joinpeertube.org/admin/remote-storage).
 
 ### Plugins/Themes/Embed API
 
- * Add embed API (https://docs.joinpeertube.org/api-embed-player):
+ * Add embed API (https://docs.joinpeertube.org/api/embed-player):
    * `playbackState` can be `ended`
    * `playbackStatusUpdate` has a `duration` field
    * `setCaption` and `getCaptions` methods
- * Add client plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add client plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `action:login.init`
    * `action:video-watch.video-threads.loaded`
    * `action:video-watch.video-thread-replies.loaded` ([@ipbc-dev](https://github.com/ipbc-dev))
- * Add server plugin hooks (https://docs.joinpeertube.org/api-plugins):
+ * Add server plugin hooks (https://docs.joinpeertube.org/api/plugins):
    * `filter:api.video.pre-import-url.accept.result`
    * `filter:api.video.pre-import-torrent.accept.result`
    * `filter:api.video.post-import-url.accept.result`
@@ -1785,13 +1983,13 @@ A new endpoint to report videos will be created in PeerTube 2.4 and will also al
 
 We added some sections in the documentation website:
 
- * S3 remote storage: https://docs.joinpeertube.org/admin-remote-storage
- * Instances redundancy: https://docs.joinpeertube.org/admin-following-instances
- * Moderate your instance: https://docs.joinpeertube.org/admin-moderation
- * Customize your instance (install plugins & themes): https://docs.joinpeertube.org/admin-customize-instance
- * PeerTube logs (standard log/audit log): https://docs.joinpeertube.org/admin-logs
- * Mute accounts/instances: https://docs.joinpeertube.org/use-mute
- * Controlled player embed API: https://docs.joinpeertube.org/api-embed-player
+ * S3 remote storage: https://docs.joinpeertube.org/admin/remote-storage
+ * Instances redundancy: https://docs.joinpeertube.org/admin/following-instances
+ * Moderate your instance: https://docs.joinpeertube.org/admin/moderation
+ * Customize your instance (install plugins & themes): https://docs.joinpeertube.org/admin/customize-instance
+ * PeerTube logs (standard log/audit log): https://docs.joinpeertube.org/admin/logs
+ * Mute accounts/instances: https://docs.joinpeertube.org/use/mute
+ * Controlled player embed API: https://docs.joinpeertube.org/api/embed-player
 
 ### Docker
 
@@ -1826,7 +2024,7 @@ We added some sections in the documentation website:
 
  * PeerTube moved translations from Zanata to Weblate. Here is the new translations website URL: https://weblate.framasoft.org/projects/peertube/
  * We now provide a JavaScript library to control a PeerTube embed: https://www.npmjs.com/package/@peertube/embed-api
- * Add ability to generate HLS videos using `create-transcoding-job` script (see [the documentation](https://docs.joinpeertube.org/maintain-tools?id=create-transcoding-jobjs))
+ * Add ability to generate HLS videos using `create-transcoding-job` script (see [the documentation](https://docs.joinpeertube.org/maintain/tools#create-transcoding-jobjs))
  * Update nginx template: (you need to [update manually](https://github.com/Chocobozzz/PeerTube/blob/develop/support/doc/production.md#nginx))
    * Add streaming playlists endpoint
    * Add `client_body_temp_path` hint
@@ -2095,7 +2293,7 @@ We added some sections in the documentation website:
 ### Features
 
  * :tada: Support Finnish, Greek and Scottish Gaelic languages
- * :tada: Add basic plugins and themes support (**beta**): https://docs.joinpeertube.org/contribute-plugins
+ * :tada: Add basic plugins and themes support (**beta**): https://docs.joinpeertube.org/contribute/plugins
    * Install plugins or themes from the administration panel
    * Choose a default theme for your instance
    * Users can choose the theme they want among the list of themes their administrator installed
@@ -2801,8 +2999,8 @@ This version is a pre release because it contains many important changes, and re
 **Important:** Before upgrading run the following commands (no need to stop PeerTube) on your PeerTube database (in this example it's *peertube_prod*):
 
 ```
-sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
-sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS pg_trgm;'
+sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
+sudo -u postgres psql peertube_prod -c 'CREATE EXTENSION IF NOT EXISTS pg_trgm;'
 ```
 
 You will need [PostgreSQL Contrib](https://www.postgresql.org/docs/9.6/static/contrib.html).