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 24 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
568 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
…_To minimize the breaking changes, the old parenthesis reference syntax (yourCollection(yourRelField)) will still continue to work but it is soft-depr…
To update the prebuilt executable you can run
./pocketbase update.
Added Planning Center OAuth2 provider (#4393; thanks @alxjsn).
Admin UI improvements:
Added support for back/indirect relation filter/sort (single and multiple).
The syntax to reference back relation fields is yourCollection_via_yourRelField.*.
⚠️ To avoid excessive joins, the nested relations resolver is now limited to max 6 level depth (the same as expand).
Note that in the future there will be also more advanced and granular options to specify a subset of the fields that are filterable/sortable.
Added support for multiple back/indirect relation expand and updated the keys to use the _via_ reference syntax (yourCollection_via_yourRelField).
To minimize the breaking changes, the old parenthesis reference syntax (yourCollection(yourRelField)) will still continue to work but it is soft-deprecated and there will be a console log reminding you to change it to the new one.
⚠️ Collections and fields are no longer allowed to have _via_ in their name to avoid collisions with the back/indirect relation reference syntax.
Added jsvm.Config.OnInit optional config function to allow registering custom Go bindings to the JSVM.
Added @request.context rule field that can be used to apply a different set of constraints based on the API rule execution context.
For example, to disallow user creation by an OAuth2 auth, you could set for the users Create API rule @request.context != "oauth2".
The currently supported @request.context values are:
default
realtime
protectedFile
oauth2
Adjusted the cron.Start() to start the ticker at the 00 second of the cron interval (#4394).
Note that the cron format has only minute granularity and there is still no guarantee that the scheduled job will be always executed at the 00 second.
Fixed auto backups cron not reloading properly after app settings change (#4431).
Upgraded to aws-sdk-go-v2 and added special handling for GCS to workaround the previous GCS headers signature issue that we had with v2.
This should also fix the SVG/JSON zero response when using Cloudflare R2 (#4287, #2068, #2952).
⚠️ If you are using S3 for uploaded files or backups, please verify that you have a green check in the Admin UI for your S3 configuration (I've tested the new version with GCS, MinIO, Cloudflare R2 and Wasabi).
Added :each modifier support for file and relation type fields (previously it was supported only for select type fields).
Other minor improvements (updated the ghupdate plugin to use the configured executable name when printing to the console, fixed the error reporting of admin update/delete commands, etc.).
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Ignore the JS required validations for disabled OIDC providers (#4322).
Allow HEAD requests to the /api/health endpoint (#4310).
Fixed the editor field value when visualized inside the View collection preview panel.
Manually clear all TinyMCE events on editor removal (workaround for tinymce#9377).
Nothing published for this version
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed @request.auth.* initialization side-effect which caused the current authenticated user email to not being returned in the user auth response (#2173).
The current authenticated user email should be accessible always no matter of the emailVisibility state.
Fixed RecordUpsert.RemoveFiles godoc example.
Bumped to NumCPU()+2 the concurrent thumbs generation limit as some users reported that it was too restrictive.
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
This is a small maintenance release and some of the previously planned features from the roadmap are pushed for the next one (sorry for this) to unblock the upcoming release of my other open source project.
Added Bitbucket OAuth2 provider (#3948; thanks @aabajyan).
Mark user as verified on confirm password reset (#4066).
If the user email has changed after issuing the reset token (eg. updated by an admin), then the verified user state remains unchanged.
Added support for loading a serialized json payload for multipart/form-data requests using the special @jsonPayload key.
This is intended to be used primarily by the SDKs to resolve js-sdk#274.
Added graceful OAuth2 redirect error handling (#4177).
Previously on redirect error we were returning directly a standard json error response. Now on redirect error we'll redirect to a generic OAuth2 failure screen (similar to the success one) and will attempt to auto close the OAuth2 popup.
The SDKs are also updated to handle the OAuth2 redirect error and it will be returned as Promise rejection of the authWithOAuth2() call.
Exposed $apis.gzip() and $apis.bodyLimit(bytes) middlewares to the JSVM.
Added TestMailer.SentMessages field that holds all sent test app emails until cleanup.
Optimized the cascade delete of records with multiple relation fields.
Updated the serve and admin commands error reporting.
Minor Admin UI improvements (reduced the min table row height, added option to duplicate fields, added new TinyMCE codesample plugin languages, hide the collection sync settings when the Settings.Meta.HideControls is enabled, etc.)
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed JSVM types generation for functions with omitted arg types (#4145).
Updated Go deps.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
json field changes that was causing View collection column expressions recognized as json to fail to resolve (#4072).> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed the json field equal query comparisons to work correctly with plain JSON primitive values like null, bool number, etc. (#4068).
Since there are plans in the future to allow custom SQLite builds and also in some situations it may be useful to be able to distinguish NULL from '', for the json fields (and for any other future non-standard field) we no longer apply COALESCE by default, aka.:
Dataset:
1) data: json(null)
2) data: json('')
For the json field filter "data = null" only 1) will resolve to TRUE.
For the json field filter "data = ''" only 2) will resolve to TRUE.
Minor Go tests improvements
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Added sleep(milliseconds) JSVM binding.
It works the same way as Go time.Sleep(), aka. it pauses the goroutine where the JSVM code is running.
Fixed multi-line text paste in the Admin UI search bar (#4022).
Fixed the monospace font loading in the Admin UI.
Fixed various reported docs and code comment typos.
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Added --dev flag and its accompanying app.IsDev() method (in place of the previosly removed --debug) to assist during development (#3918).
The --dev flag prints in the console "everything" and more specifically:
app.Logger().* logs (debug, info, warning, error, etc.), no matter of the logs persistence settings in the Admin UIMinor Admin UI fixes:
error label text wrapping.referer (when it is from a different source) and details labels in the logs listing.CAST(x as bool) expressions.Replaced the default API tests timeout with a new ApiScenario.Timeout option (#3930).
A negative or zero value means no tests timeout.
If a single API test takes more than 3s to complete it will have a log message visible when the test fails or when go test -v flag is used.
Added timestamp at the beginning of the generated JSVM types file to avoid creating it everytime with the app startup.
Nothing published for this version
Soft-deprecated and renamed app.Cache() with app.Store().
To update the prebuilt executable you can run
./pocketbase update.
Added expand, filter, fields, custom query and headers parameters support for the realtime subscriptions.
Requires JS SDK v0.20.0+ or Dart SDK v0.17.0+.
// JS SDK v0.20.0
pb.collection("example").subscribe("*", (e) => {
...
}, {
expand: "someRelField",
filter: "status = 'active'",
fields: "id,expand.someRelField.*:excerpt(100)",
})
// Dart SDK v0.17.0
pb.collection("example").subscribe("*", (e) {
...
},
expand: "someRelField",
filter: "status = 'active'",
fields: "id,expand.someRelField.*:excerpt(100)",
)
Generalized the logs to allow any kind of application logs, not just requests.
The new app.Logger() implements the standard log/slog interfaces available with Go 1.21.
// Go: https://pocketbase.io/docs/go-logging/
app.Logger().Info("Example message", "total", 123, "details", "lorem ipsum...")
// JS: https://pocketbase.io/docs/js-logging/
$app.logger().info("Example message", "total", 123, "details", "lorem ipsum...")
For better performance and to minimize blocking on hot paths, logs are currently written with debounce and on batches:
- 3 seconds after the last debounced log write
- when the batch threshold is reached (currently 200)
- right before app termination to attempt saving everything from the existing logs queue
Some notable log related changes:
⚠️ Bumped the minimum required Go version to 1.21.
⚠️ Removed _requests table in favor of the generalized _logs.
Note that existing logs will be deleted!
⚠️ Renamed the following Dao log methods:
Dao.RequestQuery(...) -> Dao.LogQuery(...)
Dao.FindRequestById(...) -> Dao.FindLogById(...)
Dao.RequestsStats(...) -> Dao.LogsStats(...)
Dao.DeleteOldRequests(...) -> Dao.DeleteOldLogs(...)
Dao.SaveRequest(...) -> Dao.SaveLog(...)
⚠️ Removed app.IsDebug() and the --debug flag.
This was done to avoid the confusion with the new logger and its debug severity level.
If you want to store debug logs you can set -4 as min log level from the Admin UI.
Refactored Admin UI Logs:
Added new filesystem/System.Copy(src, dest) method to copy existing files from one location to another.
This is usually useful when duplicating records with file field(s) programmatically.
Added filesystem.NewFileFromUrl(ctx, url) helper method to construct a *filesystem.BytesReader file from the specified url.
OAuth2 related additions:
Added new PKCE() and SetPKCE(enable) OAuth2 methods to indicate whether the PKCE flow is supported or not.
The PKCE value is currently configurable from the UI only for the OIDC providers.
This was added to accommodate OIDC providers that may throw an error if unsupported PKCE params are submitted with the auth request (eg. LinkedIn; see #3799).
Added new displayName field for each listAuthMethods() OAuth2 provider item.
The value of the displayName property is currently configurable from the UI only for the OIDC providers.
Added expiry field to the OAuth2 user response containing the optional expiration time of the OAuth2 access token (#3617).
Allow a single OAuth2 user to be used for authentication in multiple auth collection.
⚠️ Because now you can have more than one external provider with collectionId-provider-providerId pair, Dao.FindExternalAuthByProvider(provider, providerId) method was removed in favour of the more generic Dao.FindFirstExternalAuthByExpr(expr).
Added onlyVerified auth collection option to globally disallow authentication requests for unverified users.
Added support for single line comments (ex. // your comment) in the API rules and filter expressions.
Added support for specifying a collection alias in @collection.someCollection:alias.*.
Soft-deprecated and renamed app.Cache() with app.Store().
Minor JSVM updates and fixes:
Updated $security.parseUnverifiedJWT(token) and $security.parseJWT(token, key) to return the token payload result as plain object.
Added $apis.requireGuestOnly() middleware JSVM binding (#3896).
Use IS NOT instead of != as not-equal SQL query operator to handle the cases when comparing with nullable columns or expressions (eg. json_extract over json field).
Based on my local dataset I wasn't able to find a significant difference in the performance between the 2 operators, but if you stumble on a query that you think may be affected negatively by this, please report it and I'll test it further.
Added MaxSize json field option to prevent storing large json data in the db (#3790).
Existing json fields are updated with a system migration to have a ~2MB size limit (it can be adjusted from the Admin UI).
Fixed negative string number normalization support for the json field type.
Trigger the app.OnTerminate() hook on app.Restart() call.
A new bool IsRestart field was also added to the core.TerminateEvent event.
Fixed graceful shutdown handling and speed up a little the app termination time.
Limit the concurrent thumbs generation to avoid high CPU and memory usage in spiky scenarios (#3794; thanks @t-muehlberger).
Currently the max concurrent thumbs generation processes are limited to "total of logical process CPUs + 1".
This is arbitrary chosen and may change in the future depending on the users feedback and usage patterns.
If you are experiencing OOM errors during large image thumb generations, especially in container environment, you can try defining the GOMEMLIMIT=500MiB env variable before starting the executable.
Slightly speed up (~10%) the thumbs generation by changing from cubic (CatmullRom) to bilinear (Linear) resampling filter (the quality difference is very little).
Added a default red colored Stderr output in case of a console command error.
You can now also silence individually custom commands errors using the cobra.Command.SilenceErrors field.
Fixed links formatting in the autogenerated html->text mail body.
Removed incorrectly imported empty local('') font-face declarations.
Nothing published for this version
⚠️ This is a prerelease intended primarily for test purposes.
⚠️ This is a prerelease intended primarily for test purposes.
Nothing published for this version
⚠️ This is a prerelease intended primarily for test purposes.
⚠️ This is a prerelease intended primarily for test purposes.
Nothing published for this version
⚠️ This is a prerelease intended primarily for test purposes.
⚠️ This is a prerelease intended primarily for test purposes.
Added experimental expand, filter, fields, custom query and headers parameters support for the realtime subscriptions.
Requires JS SDK v0.20.0-rc or Dart SDK v0.17.0-rc.
// JS SDK v0.20.0-rc
pb.collection("example").subscribe("*", (e) => {
...
}, {
expand: "someRelField",
filter: "status = 'active'",
fields: "id,expand.someRelField.*:excerpt(100)",
})
// Dart SDK v0.17.0-rc
pb.collection("example").subscribe("*", (e) {
...
},
expand: "someRelField",
filter: "status = 'active'",
fields: "id,expand.someRelField.*:excerpt(100)",
)
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed TinyMCE source code viewer textarea styles (#3715).
Fixed text field min/max validators to properly count multi-byte characters (#3735).
Allowed hyphens in usernames (#3697). More control over the system fields settings will be available in the future.
Updated the JSVM generated types to use directly the value instead of * | undefined union in functions/methods return declarations.
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Added the release notes to the console output of ./pocketbase update (#3685).
Added missing documention for the JSVM $mails.* bindings.
Relaxed the OAuth2 redirect url validation to allow any string value (#3689; thanks @sergeypdev). Note that the redirect url format is still bound to the accepted values by the specific OAuth2 provider.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed tokenizer.Scan()/ScanAll() to ignore the separators from the default trim cutset.
An option to return also the empty found tokens was also added via Tokenizer.KeepEmptyTokens(true).
This should fix the parsing of whitespace characters around view query column names when no quotes are used (#3616).
Fixed the :excerpt(max, withEllipsis?) fields query param modifier to properly add space to the generated text fragment after block tags.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Soft-deprecated $os.exec() in favour of $os.cmd() to make it more clear that the call only prepares the command and doesn't execute it.
To update the prebuilt executable you can run
./pocketbase update.
Added Patreon OAuth2 provider (#3323; thanks @ghostdevv).
Added mailcow OAuth2 provider (#3364; thanks @thisni1s).
Added support for :excerpt(max, withEllipsis?) fields modifier that will return a short plain text version of any string value (html tags are stripped).
This could be used to minimize the downloaded json data when listing records with large editor html values.
await pb.collection("example").getList(1, 20, {
"fields": "*,description:excerpt(100)"
})
Several Admin UI improvements:
date field tooltip on hover.editor field values by initially fetching only a partial of the records data (the complete record data is loaded on record preview/update).editor field..woff and .ttf fonts and keep only .woff2.Removed the explicit Content-Type charset from the realtime response due to compatibility issues with IIS (#3461).
The Connection:keep-alive realtime response header was also removed as it is not really used with HTTP2 anyway.
Added new JSVM bindings:
new Cookie({ ... }) constructor for creating *http.Cookie equivalent value.new SubscriptionMessage({ ... }) constructor for creating a custom realtime subscription payload.$os.exec() in favour of $os.cmd() to make it more clear that the call only prepares the command and doesn't execute it.⚠️ Bumped the min required Go version to 1.19.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Added global raw template function to allow outputting raw/verbatim HTML content in the JSVM templates (#3476).
{{.description|raw}}
Trimmed view query semicolon and allowed single quotes for column aliases (#3450). Single quotes are usually not a valid identifier quote characters, but for resilience and compatibility reasons SQLite allows them in some contexts where only an identifier is expected.
Bumped the GitHub action to use min Go 1.21.2 (the fixed issues are not critical as they are mostly related to the compiler/build tools).
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed empty thumbs directories not getting deleted on Windows after deleting a record img file (#3382).
Updated the generated JSVM typings to silent the TS warnings when trying to access a field/method in a Go->TS interface.
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
created and updated fields as N/A when the view query doesn't have them.> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed JS error in the Admin UI when listing records with invalid relation field value (#3372).
This could happen usually when executing raw SQL import scripts or when directly modifying the record field value without data validations. Further integrity checks may be added eventually in the future.
Updated Go deps and the generated JSVM types.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Return the response headers and cookies in the $http.send() result (#3310).
Added more descriptive internal error message for missing user/admin email on password reset requests.
Updated Go dependencies.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
\) support in the Admin UI to allow using select field values with comma (#2197).Nothing published for this version
One column per quarter.