Self-Hosted / Projects / PocketBase

PocketBase
StableSpecs verified September 1, 2026 · against vv0.40.1
Overview
Open source backend in one file with auth, storage, realtime APIs, and an admin UI.
PocketBase is a self-hosted backend for small web and mobile apps that bundles an embedded SQLite database, authentication, file storage, an admin dashboard, and realtime APIs into a single executable.
The practical search intent is usually not just “what is PocketBase,” but whether it can replace a heavier backend stack for prototypes, internal tools, side projects, or lightweight production apps without forcing you into a multi-service platform on day one.
Why people choose PocketBase
The official site and repository both lean on the same core promise: open source backend in one file. That matters for self-hosters because it cuts setup time dramatically compared with larger backend platforms that need multiple services before you can ship anything useful.
PocketBase also ships the parts most small apps need first: collections, auth, uploads, subscriptions, and a dashboard. For a homelab builder or solo developer, that is often enough to launch a real tool before you decide whether you need something bigger.
What you get in the stack
Official documentation describes PocketBase as an embedded SQLite backend with realtime subscriptions, built-in users and file management, a convenient admin UI, and a simple REST-ish API. The site also highlights SDK support for common frontend stacks and a live demo of the dashboard.
Production docs add important operator details that the homepage alone does not: backups are fundamentally snapshots of pb_data, reverse proxies need the right forwarded-IP headers, and settings such as SMTP, rate limiting, and encryption keys matter once the app moves beyond local development.
What to know before you deploy
PocketBase is intentionally small, but the docs are explicit that it is still under active development and full backward compatibility is not guaranteed before 1.0. The project does not recommend it for production-critical applications unless you are prepared to track changelogs and apply migration steps when needed.
The deployment model is also part of the tradeoff. PocketBase can be deployed by uploading one binary to a Linux server, but you still need to think about TLS, backups, mail delivery, rate limiting, and how the single-node SQLite-based design fits your expected workload. That simplicity is a strength for many use cases, but it is not the same thing as a horizontally scaled managed backend platform.
If you use Docker, the official docs provide a minimal Dockerfile example rather than an official image. That is a useful clue: PocketBase supports containerized deployment, but its most natural path is still a small self-hosted binary with a persistent pb_data volume and a reverse proxy when needed.
Best fit
Choose PocketBase when you want the smallest possible self-hosted backend that still gives you auth, database records, uploads, and realtime updates from one control plane.
Compare Appwrite, Supabase, or a custom Postgres stack more closely when the project needs larger-team workflows, broader managed-service parity, or stronger guarantees around production-critical change management.
Interface previews
Screenshots of the PocketBase interface.
Feature support
| Feature | Support |
|---|---|
| Embedded SQLite databaseThe official docs describe PocketBase as an embedded database backend built on SQLite. | Supported |
| Realtime subscriptionsRealtime subscriptions are one of the project’s core headline features. | Supported |
| Authentication and user managementBuilt-in auth management is part of the default stack. | Supported |
| File storage and uploadsThe official site and repo both call out built-in files management. | Supported |
| Admin dashboard UIThe admin UI is included out of the box and can be explored in the public demo. | Supported |
| REST-ish APIPocketBase exposes a simple API by default when the server starts. | Supported |
| JavaScript and Dart SDK supportThe homepage explicitly shows JS and Dart SDK usage for frontend integrations. | Supported |
| Built-in backupsDashboard backup and restore APIs are available, with caveats for large pb_data directories. | Supported |
| TLS via direct serve or reverse proxyOfficial docs cover direct HTTPS serve and reverse-proxy setups, but production hardening is still the operator’s job. | Partial support |
| Production-critical backward-compatibility guaranteesThe docs explicitly warn that full backward compatibility is not guaranteed before 1.0. | Partial support |
Community signals
- Stars
- 61.4k
- Forks
- 3.7k
- Open issues
- 19
- Last commit
- 1d ago
- Latest release
- v0.40.5
- Repo created
- Jul 2022
Includes open pull requests
1w ago
Refreshed nightly from the GitHub API.
Alternatives
- Appwrite
Broader backend platform comparison for teams that want more built-in services and a larger control surface.
- Supabase
Popular hosted/backend-platform comparison when a project needs a fuller managed-service ecosystem.
- Firebase
Common managed backend comparison for people deciding between vendor convenience and self-hosted control.
Questions
What is PocketBase used for?
PocketBase is used to self-host a lightweight backend with records, authentication, uploads, realtime subscriptions, and an admin UI for small web and mobile apps.
Is PocketBase a self-hosted Firebase or Supabase alternative?
It can fill part of that role for smaller apps, prototypes, or internal tools. The key difference is that PocketBase is a much smaller single-binary backend built around SQLite instead of a broader hosted platform stack.
Does PocketBase need Postgres or another external database?
No for the standard setup. The official docs describe PocketBase as an embedded SQLite backend, which is one reason it is so lightweight to deploy.
Is PocketBase production ready?
With caveats. The docs say PocketBase is still under active development and full backward compatibility is not guaranteed before 1.0, so it is not recommended for production-critical applications unless you are comfortable managing changelog-driven migrations.
How do PocketBase backups work?
The official production docs say the practical backup target is the pb_data directory. Newer versions also include backup and restore APIs in the dashboard, but larger installations may need a more deliberate backup strategy.
Does PocketBase support Docker?
Yes, but with nuance. The official docs provide a minimal Dockerfile example and explain that data must persist at /pb/pb_data; PocketBase does not present an official Docker image as the primary install path.
Who should choose PocketBase instead of a bigger backend platform?
PocketBase is a strong fit for solo developers, internal tools, and smaller apps that benefit from a very small deployment footprint. Teams that need broader platform services or stricter enterprise change guarantees should compare larger alternatives before committing.
support // the lab
Found this write-up useful?
If it saved you time or a rebuild, you can support more practical homelab guides.