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.
Nothing published for this version
Nothing published for this version
> _To update the prebuilt executable you can run ./pocketbase update._
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Upgraded golang.org/x/net to 0.33.0 to fix CVE-2024-45338. _PocketBase uses the vulnerable functions primarily for the auto html->text mail generation…
To update the prebuilt executable you can run
./pocketbase update.
golang.org/x/net to 0.33.0 to fix CVE-2024-45338.
PocketBase uses the vulnerable functions primarily for the auto html->text mail generation, but most applications shouldn't be affected unless you are manually embedding unrestricted user provided value in your mail templates.If you are extending PocketBase with Go and upgrading with go get -u make sure to manually set in your go.mod the modernc.org/libc indirect dependency to v1.55.3, aka. the exact same version the modernc.org/sqlite driver is using.
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.
Renew the superuser file token cache when clicking on the thumb preview or download link (#6137).
Upgraded modernc.org/sqlite to 1.34.3 to fix "disk io" error on arm64 systems.
If you are extending PocketBase with Go and upgrading with go get -u make sure to manually set in your go.mod the modernc.org/libc indirect dependency to v1.55.3, aka. the exact same version the driver is using.
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.
strconv.Itoa with strconv.FormatInt to avoid the int64->int conversion overflow on 32-bit platforms (#6132).> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed Model->Record and Model->Collection hook events sync for nested and inner-hook transactions (#6122). Further optimizations related to this will be available with the next major release.
Other minor improvements (updated Go and npm deps, added extra escaping for the default mail record params in case the emails are stored as html files, fixed code comment typos, etc.).
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.
> _To update the prebuilt executable you can run ./pocketbase update._
To update the prebuilt executable you can run
./pocketbase update.
Fixed $filesystem.fileFromURL documentation and generated type (#6058).
Fixed X-Forwarded-For header typo in the suggested UI "Common trusted proxy" headers (#6063).
Updated the text field max length validator error message to make it more clear (#6066).
Other minor fixes (updated Go deps, skipped unnecessary validator check when the default primary key pattern is used, updated JSVM types, etc.).
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 UI logs search not properly accounting for the "Include requests by superusers" toggle when multiple search expressions are used.
Fixed text field max validation error message (#6053).
Other minor fixes (comment typos, JSVM types update).
Updated Go deps and the min Go release GitHub action version to 1.23.4.
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.
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 Gzip middleware not applying when serving static files.
Fixed Record.Fresh()/Record.Clone() methods not properly cloning autodate fields (#5973).
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 RecordQuery().All() custom struct scanning (#5958).
Fixed --dev log query print formatting.
Added support for passing more than one id in the Hook.Unbind method for consistency with the router.
Added collection rules change list in the confirmation popup (to avoid getting anoying during development, the rules confirmation currently is enabled only when using https).
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.
Added RequestEvent.Blob(status, contentType, bytes) response write helper (#5940).
Added more descriptive error messages.
Nothing published for this version
Nothing published for this version
> with PocketBase v0.22.x yet and in the case of critical bugs and security vulnerabilities, the fixes
[!NOTE] You don't have to upgrade to PocketBase v0.23.0 if you are not planning further developing your existing app and/or are satisfied with the v0.22.x features set. There are no identified critical issues with PocketBase v0.22.x yet and in the case of critical bugs and security vulnerabilities, the fixes will be backported for at least until Q1 of 2025 (if not longer).
If you don't plan upgrading make sure to pin the SDKs version to their latest PocketBase v0.22.x compatible:
- JS SDK:
<0.22.0- Dart SDK:
<0.19.0
[!CAUTION] This release introduces many Go/JSVM and Web APIs breaking changes!
Existing
pb_datawill be automatically upgraded with the start of the new executable, but custom Go or JSVM (pb_hooks,pb_migrations) and JS/Dart SDK code will have to be migrated manually. Please refer to the below upgrade guides:
- Go: https://pocketbase.io/v023upgrade/go/.
- JSVM: https://pocketbase.io/v023upgrade/jsvm/.
If you had already switched to some of the earlier
<v0.23.0-rc14versions and have generated a full collections snapshot migration (aka../pocketbase migrate collections), then you may have to regenerate the migration file to ensure that it includes the latest changes.
PocketBase v0.23.0 is a major refactor of the internals with the overall goal of making PocketBase an easier to use Go framework. There are a lot of changes but to highlight some of the most notable ones:
echo with a new router built on top of the Go 1.22 net/http mux enhancements.daos packages in core.App to simplify the DB operations (the models package structs are also migrated in core).DBConnect function as part of the app configuration to allow different database/sql SQLite drivers (turso/libsql, sqlcipher, etc.) and custom builds.
Note that we no longer loads the mattn/go-sqlite3 driver by default when building with CGO_ENABLED=1 to avoid multiple definition linker errors in case different CGO SQLite drivers or builds are used. You can find an example how to enable it back if you want to in the new documentation.Record model improvements (support for get/set modifiers, simplfied file upload by treating the file(s) as regular field value like record.Set("document", file), etc.).id, email, password, etc.)._superusers auth records.instagram2 to prevent conflicts with existing linked users.id_token payload for the cases when the provider doesn't have a dedicated user info endpoint.Presentable view, slightly different collection options organization, zoom/pan for the logs chart, etc.)
- Go: https://pocketbase.io/v023upgrade/go/.
- JSVM: https://pocketbase.io/v023upgrade/jsvm/.
New POST /api/batch endpoint.
New GET /api/collections/meta/scaffolds endpoint.
New DELETE /api/collections/{collection}/truncate endpoint.
New POST /api/collections/{collection}/request-otp endpoint.
New POST /api/collections/{collection}/auth-with-otp endpoint.
New POST /api/collections/{collection}/impersonate/{id} endpoint.
⚠️ If you are constructing requests to /api/* routes manually remove the trailing slash (there is no longer trailing slash removal middleware registered by default).
⚠️ Removed /api/admins/* endpoints because admins are converted to _superusers auth collection records.
⚠️ Previously when uploading new files to a multiple file field, new files were automatically appended to the existing field values.
This behaviour has changed with v0.23+ and for consistency with the other multi-valued fields when uploading new files they will replace the old ones. If you want to prepend or append new files to an existing multiple file field value you can use the + prefix or suffix:
"documents": [file1, file2] // => [file1_name, file2_name]
"+documents": [file1, file2] // => [file1_name, file2_name, old1_name, old2_name]
"documents+": [file1, file2] // => [old1_name, old2_name, file1_name, file2_name]
⚠️ Removed GET /records/{id}/external-auths and DELETE /records/{id}/external-auths/{provider} endpoints because this is now handled by sending list and delete requests to the _externalAuths collection.
⚠️ Changes to the app settings model fields and response (+new options such as trustedProxy, rateLimits, batch, etc.). The app settings Web APIs are mostly used by the Dashboard UI and rarely by the end users, but if you want to check all settings changes please refer to the Settings Go struct.
⚠️ New flatten Collection model and fields structure. The Collection model Web APIs are mostly used by the Dashboard UI and rarely by the end users, but if you want to check all changes please refer to the Collection Go struct.
⚠️ The top level error response code key was renamed to status for consistency with the Go APIs.
The error field key remains code:
{
"status": 400, // <-- old: "code"
"message": "Failed to create record.",
"data": {
"title": {
"code": "validation_required",
"message": "Missing required value."
}
}
}
⚠️ New fields in the GET /api/collections/{collection}/auth-methods response.
The old authProviders, usernamePassword, emailPassword fields are still returned in the response but are considered deprecated and will be removed in the future.
{
"mfa": {
"duration": 100,
"enabled": true
},
"otp": {
"duration": 0,
"enabled": false
},
"password": {
"enabled": true,
"identityFields": ["email", "username"]
},
"oauth2": {
"enabled": true,
"providers": [{"name": "gitlab", ...}, {"name": "google", ...}]
},
// old fields...
}
⚠️ Soft-deprecated the OAuth2 auth success meta.avatarUrl field in favour of meta.avatarURL.
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
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
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
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 auto www. redirect due to missing URI schema.
Fixed collection and field renaming when reusing an old collection/field name (#5741). ~If you have existing collections snapshot migrations you may want to delete and regenerate them.~ Edit: Collection snapshots are actually broken when combined with manual typed collections at the moment; I'll push an update sometime next week once I figure out how to resolve the issue with the random collection and field ids.
Update the "API preview" section to include information about the batch api.
Exported core.DefaultDBConnect function that could be used as a fallback when initializing custom SQLite drivers and builds.
⚠️ No longer loads the mattn/go-sqlite3 driver by default when building with CGO_ENABLED=1 to avoid multiple definition ... linker errors in case different CGO SQLite drivers or builds are used.
This means that no matter of the CGO_ENABLED value, now out of the box PocketBase will always use only the pure Go driver (modernc.org/sqlite).
This will be documented properly in the new website but if you want to continue using mattn/go-sqlite3 (e.g. because of the icu or other builtin extension) you could register it as follow:
package main
import (
"database/sql"
"log"
"github.com/mattn/go-sqlite3"
"github.com/pocketbase/dbx"
"github.com/pocketbase/pocketbase"
)
func init() {
// initialize default PRAGMAs for each new connection
sql.Register("pb_sqlite3",
&sqlite3.SQLiteDriver{
ConnectHook: func(conn *sqlite3.SQLiteConn) error {
_, err := conn.Exec(`
PRAGMA busy_timeout = 10000;
PRAGMA journal_mode = WAL;
PRAGMA journal_size_limit = 200000000;
PRAGMA synchronous = NORMAL;
PRAGMA foreign_keys = ON;
PRAGMA temp_store = MEMORY;
PRAGMA cache_size = -16000;
`, nil)
return err
},
},
)
dbx.BuilderFuncMap["pb_sqlite3"] = dbx.BuilderFuncMap["sqlite3"]
}
func main() {
app := pocketbase.NewWithConfig(pocketbase.Config{
DBConnect: func(dbPath string) (*dbx.DB, error) {
return dbx.Open("pb_sqlite3", dbPath)
},
})
// custom hooks and plugins...
if err := app.Start(); err != nil {
log.Fatal(err)
}
}
Also note that if you are not planning to use the core.DefaultDBConnect fallback as part of your custom driver registration you can exclude the default pure Go driver from the build with the build tag -tags no_default_driver to reduce the binary size a little.
⚠️ Removed JSVM BaseCollection(), AuthCollection(), ViewCollection() class aliases for simplicity and to avoid confusion with the accepted constructor arguments (you can simply use as before new Collection({ type: "base", ... }); this will also initialize the default type specific options).
Other minor improvements (added validator for duplicated index definitions, updated the impersonate popup styles, added query param support for loading a collection based on its name, 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
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.