If your instance has many videos (local or federated) in the database, automatic migrations at next startup can take several minutes to finish. Plan for a short period of downtime during this upgrade
You need to manually execute a migration script after upgrading, while PeerTube is running and the database migration is complete (Migrations finished. New migration version schema: 1125 in PeerTube startup logs):
Comment API change: GET /api/v1/videos/{id}/comment-threads/{threadId} no longer returns the full comment tree
It now returns at most 10 direct replies per comment, down to 5 levels of nesting, by default
Each node in the returned tree now has a totalChildren field: compare it against children.length to know if replies were cut off
To fetch the rest, call the new endpoint: GET /api/v1/videos/{id}/comments/{commentId}/replies
If you're a plugin author: filter:api.video-thread-comments.list.result now sees only the truncated tree. Two new hooks, filter:api.video-comment-replies.list.params / .result, cover the new replies endpoint
v8.3.0-rc.1 introduced a bug in the upgrade script: the database backup step fails, which stops the upgrade. To upgrade from v8.3.0-rc.1 (classic installation):
Replace the upgrade script with the fixed one: cd /var/www/peertube/peertube-latest && sudo -H -u peertube curl -fsSL -o dist/scripts/upgrade.sh https://raw.githubusercontent.com/Chocobozzz/PeerTube/13c16ec0e80a16f3d98b6d0e2c2942c1c22513dc/server/scripts/upgrade.sh and then run the upgrade script as usual
Prevent a moderator to change user role. Thanks to Infinit3i for reporting it
Security hardening:
Time safe comparison when checking email verification strings
Prevent replaying an email check request
Don't leak account existence in the login endpoint
Introduce per-account rate limiting for abuse creation and comment creation
Add specific rate limit for "Confirm token" endpoints (reset password, verify email, confirm 2FA)
Introduce account login lockout, disabled by default, when there are too many failed attempts for a specific account across multiple IPs. An email is sent to the account owner when the account login is locked
filter:api.video-comment-replies.list.params and filter:api.video-comment-replies.list.result for the new /api/v1/videos/{id}/comments/{commentId}/replies comment endpoint
filter:api.video-watch.video-comment-replies.list.params and filter:api.video-watch.video-comment-replies.list.result when loading more replies of a comment
Add server plugin helpers:
peertubeHelpers.email.createJob({ ... }) to send an email
peertubeHelpers.videos.updateVideo({ ... }) to update video metadata
peertubeHelpers.videos.withFile({ ... }) to fetch a video file
Add server registration features to add automatic tags to videos or comments:
Add support for externalId when returning the user from an auth plugin, so it no longer needs to rely on the user's email to map the auth provider user to a PeerTube user
Add support for language when returning the user from an auth plugin
Expose req.cookies in the onLogout hook of the registerExternalAuth plugin helper
Features
🎉 Add ability to subscribe to a remote blocklist to automatically mute/unmute accounts and servers 🎉
New Moderation → Blocklist → Subscriptions admin page to add/remove blocklist subscriptions and see their sync state
Subscriptions are periodically refreshed, automatically muting/unmuting accounts and servers to match the remote list
Add a notification when a subscription sync mutes or unmutes accounts/servers
Expose your own instance's blocklist as a public log (blocklist.public_log.enabled configuration) so other admins can subscribe to it
🎉 Add ability to subscribe to a remote watched words list, at both the platform and account level 🎉
New Moderation → Watched words → Subscriptions admin page (instance-wide lists) and a matching subscriptions page in My library (per-account lists) to add/remove subscriptions and see their sync state and imported word count
Subscribed lists are periodically fetched and synchronized, automatically adding/removing words
Existing videos and comments are automatically re-tagged in the background when a subscribed list changes
🎉 Admins can configure automatic tag policies to automatically block videos with a specific label 🎉
Add ability for moderators to set an internal note on blocked videos
Send an email notification on account login from a new device #7737
Add bulk actions to add/remove videos in a playlist in My Videos
Add ability to bulk update some video metadata in My Videos and Admin Videos Overview
Add ability for users to retry video imports and filter them by State
Users can specify the default privacy for imported videos of a channel synchronization
Admins/moderators have a special channel picker when updating a video, so they can easily move any local video to another user's channel
Admins can cancel a local transcoding job
Allow users to choose the stats interval when listing their channels #7750
Add "Nobody can embed this video" setting to videos #7716
Improve local video search by allowing search through the first 1000 characters of descriptions #7612
Various SEO improvements, including a lastmod field in sitemap entries #7738
Support the host-meta well-known endpoint for remote subscriptions
Transcription widget:
Make the transcription widget header sticky to ensure the search function remains easily accessible
Don't auto-scroll transcription to the current segment after a manual user scroll
Add a "Sync with video" button after a manual user scroll to restore auto scroll
Restore transcription widget when refreshing the page
Improve podcast UX for channels:
Add a new "Podcast" page when managing a channel to display podcast URLs and information
The channel now accepts a "Public email" configuration so that the user's email address is not used
UI & accessibility:
Improve video stats styling and add quick date filters
Fade player when video is paused and user becomes inactive #7725
Underline badges that are filters or links
Improve video miniature accessibility when listing videos
Add ... suffix to actions that lead to another step
Improve notifier error message when server returns a 502 HTTP status
Hide non-existing metadata in the video watch page
Performance:
Faster comment rendering in the web browser
Limit the number of replies when fetching replies of a thread
Reduce number of rows returned by the user SQL query
Reduce server CPU usage when handling multiple lives with a large DVR window
Bug fixes
Stick live to 1x playback rate
Correctly cleanup lives on error
Prevent memory leak in the live segment sha store
Use correct CSS variable for big play button color #7733
Fix juddery video with variable fps input
Abort ffmpeg and HTTP requests on job timeout
Fix broken byte range request support for video download endpoints when throttling is enabled
Owner/admin can bypass the download enabled setting
Fix S3 base url with forced path style
Prevent duplicated thumbnails
Support federation to other fediverse platforms that do not support the shared inbox
More robust channel sync: don't miss videos on the next sync when the previous one was aborted because of a sync error
Fix videos feed sort for playlists and respect originallyPublishedAt for videos
Fix broken views on an instance if the GeoIP request is stuck
Don't notify again when a video is re-published
Allow admin to update the default "Prevent email from being sent to the user" behaviour when processing a registration request
Add all user attributes to audit logs on create/update #7695
Correctly hide the mobile message if disabled by the admin
If your instance has many videos (local or federated) in the database, automatic migrations at next startup can take several minutes to finish. Plan for a short period of downtime during this upgrade
You need to manually execute a migration script after upgrading, while PeerTube is running and the database migration is complete (Migrations finished. New migration version schema: 1125 in PeerTube startup logs):
Comment API change: GET /api/v1/videos/{id}/comment-threads/{threadId} no longer returns the full comment tree
It now returns at most 10 direct replies per comment, down to 5 levels of nesting, by default
Each node in the returned tree now has a totalChildren field: compare it against children.length to know if replies were cut off
To fetch the rest, call the new endpoint: GET /api/v1/videos/{id}/comments/{commentId}/replies
If you're a plugin author: filter:api.video-thread-comments.list.result now sees only the truncated tree. Two new hooks, filter:api.video-comment-replies.list.params / .result, cover the new replies endpoint
SECURITY
Security hardening:
Time safe comparison when checking email verification strings
Prevent replaying an email check request
Don't leak account existence in the login endpoint
Introduce per-account rate limiting for abuse creation and comment creation
Add specific rate limit for "Confirm token" endpoints (reset password, verify email, confirm 2FA)
Introduce account login lockout, disabled by default, when there are too many failed attempts for a specific account across multiple IPs. An email is sent to the account owner when the account login is locked
filter:api.video-comment-replies.list.params and filter:api.video-comment-replies.list.result for the new /api/v1/videos/{id}/comments/{commentId}/replies comment endpoint
filter:api.video-watch.video-comment-replies.list.params and filter:api.video-watch.video-comment-replies.list.result when loading more replies of a comment
Add server plugin helpers:
peertubeHelpers.email.createJob({ ... }) to send an email
peertubeHelpers.videos.updateVideo({ ... }) to update video metadata
peertubeHelpers.videos.withFile({ ... }) to fetch a video file
Add server registration features to add automatic tags to videos or comments:
Add support for externalId when returning the user from an auth plugin, so it no longer needs to rely on the user's email to map the auth provider user to a PeerTube user
Add support for language when returning the user from an auth plugin
Expose req.cookies in the onLogout hook of the registerExternalAuth plugin helper
Features
🎉 Add ability to subscribe to a remote blocklist to automatically mute/unmute accounts and servers 🎉
New Moderation → Blocklist → Subscriptions admin page to add/remove blocklist subscriptions and see their sync state
Subscriptions are periodically refreshed, automatically muting/unmuting accounts and servers to match the remote list
Add a notification when a subscription sync mutes or unmutes accounts/servers
Expose your own instance's blocklist as a public log (blocklist.public_log.enabled configuration) so other admins can subscribe to it
🎉 Add ability to subscribe to a remote watched words list, at both the platform and account level 🎉
New Moderation → Watched words → Subscriptions admin page (instance-wide lists) and a matching subscriptions page in My library (per-account lists) to add/remove subscriptions and see their sync state and imported word count
Subscribed lists are periodically fetched and synchronized, automatically adding/removing words
Existing videos and comments are automatically re-tagged in the background when a subscribed list changes
🎉 Admins can configure automatic tag policies to automatically block videos with a specific label 🎉
Add ability for moderators to set an internal note on blocked videos
Send an email notification on account login from a new device #7737
Add bulk actions to add/remove videos in a playlist in My Videos
Add ability to bulk update some video metadata in My Videos and Admin Videos Overview
Add ability for users to retry video imports and filter them by State
Users can specify the default privacy for imported videos of a channel synchronization
Admins/moderators have a special channel picker when updating a video, so they can easily move any local video to another user's channel
Admins can cancel a local transcoding job
Allow users to choose the stats interval when listing their channels #7750
Add "Nobody can embed this video" setting to videos #7716
Improve local video search by allowing search through the first 1000 characters of descriptions #7612
Various SEO improvements, including a lastmod field in sitemap entries #7738
Support the host-meta well-known endpoint for remote subscriptions
Transcription widget:
Make the transcription widget header sticky to ensure the search function remains easily accessible
Don't auto-scroll transcription to the current segment after a manual user scroll
Add a "Sync with video" button after a manual user scroll to restore auto scroll
Restore transcription widget when refreshing the page
Improve podcast UX for channels:
Add a new "Podcast" page when managing a channel to display podcast URLs and information
The channel now accepts a "Public email" configuration so that the user's email address is not used
UI & accessibility:
Improve video stats styling and add quick date filters
Fade player when video is paused and user becomes inactive #7725
Underline badges that are filters or links
Improve video miniature accessibility when listing videos
Add ... suffix to actions that lead to another step
Improve notifier error message when server returns a 502 HTTP status
Hide non-existing metadata in the video watch page
Performance:
Faster comment rendering in the web browser
Limit the number of replies when fetching replies of a thread
Reduce number of rows returned by the user SQL query
Reduce server CPU usage when handling multiple lives with a large DVR window
Bug fixes
Stick live to 1x playback rate
Correctly cleanup lives on error
Prevent memory leak in the live segment sha store
Use correct CSS variable for big play button color #7733
Fix juddery video with variable fps input
Abort ffmpeg and HTTP requests on job timeout
Fix broken byte range request support for video download endpoints when throttling is enabled
Owner/admin can bypass the download enabled setting
Fix S3 base url with forced path style
Prevent duplicated thumbnails
Support federation to other fediverse platforms that do not support the shared inbox
More robust channel sync: don't miss videos on the next sync when the previous one was aborted because of a sync error
Fix videos feed sort for playlists and respect originallyPublishedAt for videos
Fix broken views on an instance if the GeoIP request is stuck
Don't notify again when a video is re-published
Allow admin to update the default "Prevent email from being sent to the user" behaviour when processing a registration request
Add all user attributes to audit logs on create/update #7695
Correctly hide the mobile message if disabled by the admin
This release addresses vulnerabilities ranging from medium to high severity affecting PeerTube <= 8.2.3. Security hardening is also included.
critical Unauthenticated ActivityPub Actor URL/key rebinding enables local playlist takeover in PeerTube GHSA-37jf-59fg-9hpr. Thanks to D0HY30N for the report
medium Email-verification bypass via client-controlled isPendingEmail parameter GHSA-wp9f-cmff-p8r2. Thanks to Felipe Faria from BluckerTV for the report
Add more security checks and receiving remote views/downloads
Refuse to display channel stats using withStats query parameter to other users/anonymous
Remove NodeJS 20 support. Please upgrade to NodeJS 22 (>= 22.12) before upgrading PeerTube
The public access of /api/v1/accounts API endpoint is deprecated for privacy reasons and will be behind an admin/moderator auth access in PeerTube v9, planned for the end of 2027
iOS versions < 15.4 are not supported anymore
NGINX
Fix an important NGINX I/O issue when users download a video: 5fa456e
Please upgrade your NGINX configuration
Add video privacy tag for peertube_videos_total OTEL metric
Configuration
This section is not exhaustive
Add download.max_total_bytes_per_second and download.max_bytes_per_ip_per_second configuration keys to throttle video downloads.
These new keys help prevent instability when botnets download the entire PeerTube catalog
Increase the default refresh token lifetime oauth2.token_lifetime.refresh_token to 4 weeks (instead of 2 weeks)
Allow admins to configure the default state of the Automatically publish a replay when your live ends option #7414
Docker
The entire PeerTube configuration can be set using environment variables.
Keep in mind that environment variable configuration keys override web admin configuration
Introduce a new table filter component that is simpler to use
Default runner job route is the page that lists runner jobs
Clicking on a type/state tag automatically filters data for local/runner job states and types, follow states, registration states, and user roles
Add video tag information and filter when listing my videos
Add ability to bulk accept/reject registration requests
Add ability to filter users by role in users overview
Improve comments UI on mobile
Display subscribe button when subscription state is loaded
Add g p hotkeys to go to My playlists page
Improve videos overview for admins:
Add ability to filter videos by state
Add a mute badge if the video owner is muted by the instance
Add ability to filter out videos from muted accounts
Improve video blocks overview for admins:
Add video privacy column
Add bulk actions to unblock, switch to manual block or delete the selected videos
Add a mute badge if the video owner is muted by the instance
Improve abuses overview for admins:
Add bulk action to update internal note, mark as accepted/rejected, delete report, mute reporter/reportee, block/unblock the video, delete the video/comment
Add a mute badge if the reporter/reportee is muted by the instance
Improve comments overview for admins and users:
Clicking on account name filters comments
Add a mute badge if the account that commented the video is muted by the instance
Add ability to filter out comments from muted accounts
Performance:
Reduce SQL joins when loading a video from the database
Faster video SQL query to retrieve my videos
Faster video comments SQL queries for users that list comments on their videos
Faster video redundancies SQL queries
Reduce number of rows returned by video SQL queries
Reduce number of rows returned by comments SQL queries
Faster loading of My channels page
Add /about endpoint caching in the client to reduce unnecessary API calls
Process ActivityPub View and Download activities in parallel
Forward ActivityPub View using parallel broadcast
Support ActivityPub indexable field for actors
Expose runner and runner job queue OpenTelemetry metrics #7469
Prevent stale follows by periodically re-sending Follow ActivityPub requests to remote instances
Improve follows reliability algorithm to reject followers that have been consistently down for ~7 days
Add .m4b audio file support
Bug fixes
Fix plugin settings to display default values when not configured in the DB #7484
Fix actor host link in miniature instance dropdown if search index is disabled
Fix missing stream error handling in web video object storage proxy #7535
Fix caption filename overflow
Fix setting a thumbnail from a video that is stored in object storage
Fix instance redundancies pagination
Filter out non-text languages for captions
Increase lazy static files cache time (thumbnails, captions, actor avatars/banners, etc.) to 1 year
Correctly log uncaught exceptions or unhandled promise rejections in file logger
Prevent page scrolling when applying filters while browsing instance/account/channel videos
Fix infinite scroll when listing my followers
Handle errors when updating a video playlist
Fix download filename if the video contains non-Latin characters
Fix font colors in emails by only injecting custom admin colors when the default theme is light-beige or dark-brown, to prevent accessibility issues
Fix broken audio stream P2P for lives
Fix broke HLS transcoding on concurrent video privacy change
Don't unpause the player when clicking on a transcription segment
Fix table page navigation on registration action
More robust playlist thumbnails updater
Fix concurrency issue when writing live sha segments
Fix concurrency issue when uploading the same torrent filename
We have learned that the SQL injection vulnerability fixed in v8.1.6 has been exploited at scale since at least May 18, 2026 and so before the v8.1.6 release.
According to our investigation, the attacker exploited this SQL injection to generate a token for the root user and install the peertube-plugin-google-analytics-js plugin. This plugin imports a client script from hxxps://www.googie-anaiytics.com/jquery.ui.js that currently only logs a line in the web browser.
Actions taken by this release:
Automatically remove peertube-plugin-google-analytics-js in v8.1.8
Invalidate OAuth tokens in v8.1.8 (all users must log in again)
Add a new user.disable_root_auth config key to disable root token usage
Remove the plugin from the plugin registry
Actions taken by Framasoft:
Report googie-anaiytics.com to the registrar
Send a contact-form message to public PeerTube instances
Release additional versions if we observe other attack vectors
A CVE is being requested for the SQL injection
Actions admins must take:
Upgrade to v8.1.8 as soon as possible
Review newly created users and videos
Review your instance configuration, especially Configuration -> Customization -> JavaScript/CSS
Review installed plugins
Generate new tokens for your runners
If you cannot upgrade to v8.1.8:
Remove actor follows that contain the 20.240.202.159 URL:
Find them: SELECT * FROM "actorFollow" WHERE "url" LIKE '%20.240.202.159%'
Delete them: DELETE FROM "actorFollow" WHERE "id" = ...
Remove actors that contain a ' character in inboxUrl:
Find them: SELECT * FROM "actor" WHERE "inboxUrl" LIKE '%''%'
Delete them: DELETE FROM "actor" WHERE "id" = ...
Invalidate OAuth tokens: UPDATE "oAuthToken" SET "accessTokenExpiresAt" = NOW(), "refreshTokenExpiresAt" = NOW() WHERE "accessTokenExpiresAt" > NOW() OR "refreshTokenExpiresAt" > NOW()
Remove peertube-plugin-google-analytics-js from instance plugins
Disable federation in production.yaml by setting federation.enabled to false
Log in
