NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #19 by repository stars
Latest stable
v0.40.6
Last release 23 days ago
26 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
567 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Lock the _otps and _mfas system collections Delete API rule for superusers only.
Record owners can still access the List and View endpoints in case you want to show history of the recent OTP and MFA attempts.
If you have existing collections snapshot migrations you may want to delete and regenerate them or update manually the deleteRule to null in the snapshot for the _otps and _mfas collections.
Reassign in the JSVM executors the global $app variable with the hook scoped e.app value to minimize the risk of a deadlock when a hook or middleware is wrapped in a transaction.
Reuse the OAuth2 created user record pointer to ensure that all its following hooks operate on the same record instance.
Added tags support for the OnFileTokenRequest hook.
Other minor changes (added index for the _collections type column, added more detailed godoc for the collection fields and core.App methods, fixed flaky record enrich tests, etc.).
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Register the default panic-recover middleware after the activity logger so that we can log the error.
Updated the RequestEvent.BindBody FormData type inferring rules to convert numeric strings into float64 only if the resulting minimal number string representation matches the initial FormData string value (#5687).
Fixed the JSVM types to include properly generated function declarations when the related Go functions have shortened/combined return values.
Reorganized the record table fields<->columns syncing to remove the PRAGMA writable_schema usage.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Fixed realtime 403 API error on resubscribe (#5674).
Fixed the auto OAuth2 avatar mapped field assignment when the OAuth2 provider doesn't return an avatar URL (#5673). In case the avatar retrieval fails and the mapped record field "Required" option is not set, the error is silenced and only logged with WARN level.
Added Router.SEARCH(path, action) helper method for registering SEARCH endpoints.
Changed all builtin middlewares to return *hook.Handler[*core.RequestEvent] with a default middleware id for consistency and to allow removal.
Or in other words, replace .BindFunc(apis.Gzip()) with .Bind(apis.Gzip()).
Updated the JSVM types to reflect the recent Go structs changes.
Nothing published for this version
Nothing published for this version
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Added Notion OAuth2 provider (#4999; thanks @s-li1).
Added monday.com OAuth2 provider (#5346; thanks @Jaytpa01).
Added option to retrieve the OIDC OAuth2 user info from the id_token payload for the cases when the provider doesn't have a dedicated user info endpoint.
Fixed the relation record picker to sort by default by @rowid instead of the created field as the latter is optional (#5641).
Fixed the UI "Set Superusers only" button click not properly resetting the input state.
Fixed the OAuth2 providers logo path shown in the "Authorized providers" UI.
Fixed the single value UI for the select, file and relation fields (#5646)
Nothing published for this version
Nothing published for this version
Nothing published for this version
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Fixed the UI settings update form to prevent sending empty string for the mail password or the S3 secret options on resave of the form.
⚠️ Added an exception for the OAuth2 field in the GO->JSVM name mapping rules:
// old -> new
collection.oAuth2.* -> collection.oauth2.*
Added more user friendly view collection truncate error message.
Added an extra suffix character to the name of autogenerated template migration file for *test suffixed collections to prevent acidentally resulting in _test.go migration files.
Added FieldsList.AddMarshaledJSON([]byte) helper method to load a serialized json array of objects or a single json object into an existing collection fields list.
Fixed the autogenerated Go migration template when updating a collection (#5631).
⚠️ If you have already used a previous prerelease and have autogenerated Go migration files, please check the migration files named {timestamp}_updated_{collection}.go and manually change:
<table width="100%"> <tr> <th width="50%">Old (broken)</th> <th width="50%">New</th> </tr> <tr> <td width="50%">
// add field / update field
if err := json.Unmarshal([]byte(`[{
...
}]`), &collection.Fields); err != nil {
return err
}
</td> <td width="50%">
// add field / update field
if err := collection.Fields.AddMarshaledJSON([]byte(`{
...
}`)); err != nil {
return err
}
</td> </tr> </table> To test that your Go migration files work correctly you can try to start PocketBase with a new temp pb_data, e.g.:
go run . serve --dir="pb_data_temp"
Nothing published for this version
Nothing published for this version
Nothing published for this version
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Make PRAGMA optimize statement optional for the cases if it is not supported by the driver (#5611).
Reapply the minimum required pb_data/auxiliary.db migrations if the db file was manually deleted (#5618).
To avoid confusion and unnecessary casting, the hook.HandlerFunc[T] type has been removed and instead everywhere we now use directly the underlying function definition: func(T) error.
Fixed the UI input field type of the OTP.length field (#5617).
Other minor fixes (fixed API preview and examples error message typos, better hint for combined/multi-spaced view query columns, fixed the path for the HTTPS green favicon path, etc.).
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
pb_data/auxiliary.db instead of pb_data/aux.db because it seems that on Windows aux is disallowed as file name (#5607).
If you have already upgraded to v0.23.0-rc please rename manually your pb_data/aux.db file to pb_data/auxiliary.db.> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Allow changing collate, sort and partial constraints for indexes on system fields.
Added system cron to run once a day PRAGMA wal_checkpoint(TRUNCATE) as a fallback to assist in high traffic applications where the autocheckpoint may not be able to take its turn.
Similar to the PRAGMA optimize, its execution is optional and even if it is not supported by a custom driver it will result only in a WARN app log.
Unless something else show up, this is expected to be the last release candidate before the final v0.23.0, planned to be released in the next 1-2 weeks. Because there were several experiments and changes in the rc versions regarding the migrations, if you had a v0.22.x app that you've migrated already to some of the other rc versions and have a full collections snapshot generated for it, note that you may have to regenerate the snapshot again (hopefully this would be the last time).
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Added WakaTime OAuth2 provider (#5829; thanks @tigawanna).
Added superuser otp EMAIL command as fallback for generating superuser OTPs from the command line in case OTP has been enabled for the _superusers but the SMTP server has deliverability issues.
⚠️ Changed OnRecordRequestOTPRequest hook to be triggered even if there is no record matching the email (aka. e.Record could be nil), allowing you to manually create a new user with the OTP request and assigning it to e.Record.
Added new sentTo system field to the _otps collection (it is managed programmatically or by superusers; it could be anything - email, phone, messanger app id, etc.).
By default when the OTP is submitted via email it is automatically populated with the user email address (via the OnMailerRecordOTPSend hook's finalizer).
This allow us on valid auth-with-otp request to automatically mark the user email as verified.
Added RateLimitRule.Audience optional field for restricting a rate limit rule for "@guest"-only, "@auth"-only, ""-any (default).
Added default max limits for the expressions count and length of the search filter and sort params. This is just an extra measure mostly for the case when the filter and sort parameters are resolved outside of the request context since the request size limits won't apply.
Other minor changes (better error in case of duplicated rate limit rule, fixed typos, changed field id and name length validator to max 100, updated Go deps, etc.).
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Fixed JSVM types errors (#5797).
Skip the default loadAuthToken middleware if e.Auth is already loaded (#5800).
Restored the API rules for the default initial "users" collection migration to be the same as in <= v0.22.x.
⚠️ Replaced the old Instagram provider with a new one that is compatible with the new Instagram Login APIs (#5588; thanks @pnmcosta).
The provider key is instagram2 to prevent conflicts with existing linked users.
⚠️ Changes regarding the first superuser creation based on #5814.
⚠️ Removed apis.RequireSuperuserAuthOnlyIfAny() middleware.
⚠️ Removed RequestEvent.UnsafeRealIP() to prevent misuse and confusion with RequestEvent.RealIP() (the latter is considered safer because it checks the trusted proxy headers settings).
> This is a prerelease intended for test and experimental purposes only!
[!CAUTION] This is a prerelease intended for test and experimental purposes only!
Restore the CRC32 checksum autogeneration for the collection/field ids in order to maintain deterministic default identifier value and minimize conflicts between custom migrations and full collections snapshots. There is a system migration that will attempt to normalize existing system collections ids, but if you already migrated to v0.23.0-rc and have generated a full collections snapshot migration, you have to delete it and regenerate a new one.
Change the behavior of the default generated collections snapshot migration to act as "extend" instead of "replace" to prevent accidental data deletion.
I think this would be rare but if you want the old behaviour you can edit the generated snapshot file and replace the second argument (deleteMissing) of App.ImportCollection/App.ImportCollectionsByMarshaledJSON from false to true.
Added app.SubscriptionsBroker().TotalClients() helper method to return the total registered realtime clients (#5793).
Nothing published for this version
( Backported from v0.40.6 ) Bumped the min Go GitHub action version to 1.27.3 as it includes a security fix related to the recent eMudhra CA compromis…
(Backported from v0.40.6) Added a global restriction for the max WxH pixels size when generating a thumb to reduce the risk of excessive memory usage.
The default limit is pretty generous and currently set to max 250<<20 (262144000) pixels and can be changed with the env PB_THUMBS_MAX_SOURCE_PIXELS.
(Backported from v0.40.6) Bumped golang.org/x/ dependencies (#7865).
(Backported from v0.40.6) Bumped the min Go GitHub action version to 1.27.3 as it includes a security fix related to the recent eMudhra CA compromise.
I didn't rush a fix 2 days ago as the impact for most PocketBase servers is not that serious and requires to already have a MiTM, but nonetheless it is recommended to update. Please make sure to also check for OS/Docker image updates to make sure that you have the latest ca-certificates bundle.
( Backported from v0.40.5 ) Bumped the min Go GitHub action version to 1.27.2 as it includes several net/http security fixes . One of the fixes is for…
net/http security fixes.( Backported from v0.40.3 ) Fixed collection index validator to allow expressions with parenthesis in the optional WHERE clause.
(Backported from v0.40.3) Fixed collection index validator to allow expressions with parenthesis in the optional WHERE clause.
(Backported from v0.40.3) Fixed nested cascade delete of self-referenced relation records.
(Backported from v0.40.3) Bumped golang.org/x/* dependencies to silence security scanners (#7829).
( Backported from v0.40.2 ) Bumped goja and its related dependencies (regex unescaped dash error fix and base64 optimizations) .
(Backported from v0.40.2) Bumped goja and its related dependencies (regex unescaped dash error fix and base64 optimizations).
(Backported from v0.40.2) Return an error when filter params fallback fails to json serialize and optimized params replacement to execute in a single pass.
(Backported from v0.40.2) Bumped the min Go GitHub action version to 1.27.1 as it includes some minor database/sql and enconding/json/v2 bug fixes.
Workaround encoding/json infinite recursion when used with Go 1.27.0 (#7808).
encoding/json infinite recursion when used with Go 1.27.0 (#7808).…1.26.6 because it comes with some minor bug and security fixes.
golang.org/x/* deps and the min Go GitHub action version to 1.26.6 because it comes with some minor bug and security fixes.(_Backported from v0.39.10_) Reverted the auto panic recover handling for the cli commands to preserve the old behavior and allow panic to force exit
(_Backported from v0.39.9_) Bumped goja, fexpr and their related deps.
(_Backported from v0.39.8_) Bumped golang.org/x/* indirect dependencies as there are some minor security fixes.
(Backported from v0.39.8) Bumped golang.org/x/* indirect dependencies as there are some minor security fixes.
(Backported from v0.39.8) Updated modernc.org/sqlite to v1.54.0 (SQLite 3.53.3).
(_Backported from v0.39.7_) ⚠️ Security fix for unhandled panic in internal worker goroutines (#7762).
(Backported from v0.39.7) Replaced github.com/go-ozzo/ozzo-validation with the fork github.com/pocketbase/ozzo-validation since the original library has recently changed ownership and the new maintainer cannot be trusted.
(Backported from v0.39.7) Fixed View collection * validator and added more friendly error messages (#7761).
(Backported from v0.39.7) ⚠️ Security fix for unhandled panic in internal worker goroutines (#7762).
Nothing published for this version
(_Backported from v0.39.6_) Bumped the min Go GitHub action version to 1.26.5 as it includes some minor security fixes.
(_Backported from v0.39.1_) Bumped the min Go GitHub action version to 1.26.4 as it includes some minor security fixes.
(_Backported from v0.38.2_) Updated all golang.org/x/ packages to cover the recent security fixes _(none of them should be a critical issue in PocketB…
golang.org/x/ packages to cover the recent security fixes (none of them should be a critical issue in PocketBase but nonetheless it is advised to update).(_Backported from v0.38.1_) Force unset the auth state of existing realtime connections on user tokenKey change.
(_Backported from v0.38.0_) Bumped min Go GitHub action version to 1.26.3 because it comes with some minor bug and security fixes.
(_Backported from v0.37.4_) ⚠️ Fixed a pre-hijacking OAuth2 linking vulnerability (#7662).
(Backported from v0.37.4) Adjusted Bitbucket, GitHub, GitLab and Gitea/Forgejo OAuth2 providers to better reflect recent API updates and doc references. In case the userinfo data is not sufficient, some of the providers now send a separate list emails request in order to minimize eventual linking security issues caused by custom onpremise setups (e.g. Gitea/Forgejo allows skipping the email verification if an ENV variable is configured).
(Backported from v0.37.4) ⚠️ Fixed a pre-hijacking OAuth2 linking vulnerability (#7662).
(_Backported from v0.36.9_) Bumped min Go GitHub action version to 1.26.2 because it comes with several minor security fixes.
(Backported from v0.36.9) Updated the Discord AuthUser.Name field to use global_name (#7603).
(Backported from v0.36.9) Updated modernc.org/sqlite to v1.48.2 (vfs and other error path related fixes).
(Backported from v0.36.9) Bumped min Go GitHub action version to 1.26.2 because it comes with several minor security fixes.
(_Backported from v0.36.7_) Updated modernc.org/sqlite to v1.46.2 and SQLite 3.51.3. _⚠️ SQLite 3.51.3 fixed a database corruption bug that is very un
(Backported from v0.36.7) Updated modernc.org/sqlite to v1.46.2 and SQLite 3.51.3.
⚠️ SQLite 3.51.3 fixed a database corruption bug that is very unlikely to happen (with PocketBase even more so because we queue on app level all writes and explicit transactions through a single db connection), but still it is advised to upgrade.
(Backported from v0.36.7) Updated other minor Go and npm deps. The min Go version in the go.mod of the package was also bumped to Go 1.25.0 because some of the newer deps require it.
(_Backported from v0.36.6_) Bumped min Go GitHub action version to 1.26.1 because it comes with some minor bug and security fixes.
(_Backported from v0.36.0_) Bumped min Go GitHub action version to 1.25.6 because it comes with some minor security fixes.
(_Backported from v0.34.1_) Bumped min Go GitHub action version to 1.25.5 because it comes with some minor security fixes. _The runner action was also…
(Backported from v0.34.1) - Added missing : char to the autocomplete regex (#7353).
(Backported from v0.34.1) Bumped min Go GitHub action version to 1.25.5 because it comes with some minor security fixes.
The runner action was also updated to actions/setup-go@v6 since the previous v5 Go source seems no longer accessible.
(_Backported from v0.30.2_) Bumped min Go GitHub action version to 1.24.8 since it comes with some minor security fixes.
(_Backported from v0.29.2_) Bumped min Go GitHub action version to 1.23.12 since it comes with some minor fixes for the runtime and `database/sql` pac
database/sql package.(_Backported from v0.26.6_) Allow OIDC email_verified to be int or boolean string since some OIDC providers like AWS Cognito has non-standard userinfo
email_verified to be int or boolean string since some OIDC providers like AWS Cognito has non-standard userinfo response (#6657).(_Backported from v0.26.3_) Fixed and normalized logs error serialization across common types for more consistent logs error output (#6631).
(_Backported from v0.26.2_) - Updated golang-jwt/jwt dependency because it comes with a minor security fix.
golang-jwt/jwt dependency because it comes with a minor security fix.(_Backported from v0.25.5_) Set the current working directory as a default goja script path when executing inline JS strings to allow require(m) trave
require(m) traversing parent node_modules directories.One column per quarter.