trailbaseio /trailbase
An open, sub-millisecond, single-executable Firebase alternative with type-safe APIs, built-in WebAssembly runtime, realtime subscriptions, auth, MCP and admin UI built on Rust, SQLite (PG) & Wasmtime.
★ 5,766⑂ 202👁 19⑃ 91● 180▤ 255
+7
日增长
5,766
stars
202
forks
19
watchers
91
prs
180
issues
255
releases
README
An open, sub-millisecond,
single-executable Firebase alternative with type-safe REST & realtime APIs,
multi-DB, WebAssembly runtime, geospatial support, SSR, auth and admin
UI built on Rust, Wasmtime & SQLite (or experimentally Postgres v0.28+).
Simplify with fewer moving parts: an easy to self-host, single-executable,
extensible backend for your mobile, web or desktop application.
Sub-millisecond latencies eliminate the need for dedicated caches, no more
stale or inconsistent data.
TrailBase
Try the
demo online
Email: admin@localhost
password: secret
For more context, documentation, and a live demo, check out the website:
trailbase.io.
Questions? Thoughts? - Take a look at the
FAQ or reach out.
If you like TrailBase or want to follow along, consider leaving a ⭐🙏.
Project Structure & Releases
This repository contains all components that make up TrailBase including the
server, client libraries, tests, documentation and examples.
Only the benchmarks are
kept separately due to their external dependencies.
Pre-built binaries are available as
GitHub releases for
Linux, MacOS and Windows or Docker images.
Client packages for various languages are available via:
- JavaScript/TypeScript
- Dart/Flutter
- Rust
- C/.Net
- Swift
- Kotlin
- Go
- Python
Getting Started
TrailBase is a single executable and therefore very easy to
deploy.
You can simply download the appropriate pre-built
GitHub release bundle for
your system (MacOS, Linux or Windows), unpack and run the executable w/o having
to worry about dependencies or shared-library skew.
If you want to get started even quicker, install TrailBase with the following
command:
sh
Linux & MacOS
curl -sSL https://trailbase.io/install.sh | bash
Windows
iwr https://trailbase.io/install.ps1 | iex
Alternatively, run TrailBase using the Docker image:
sh
alias trail='
mkdir -p traildepot && \
docker run \
-p 4000:4000 \
-e ADDRESS=0.0.0.0:4000 \
--mount type=bind,source="$PWD"/traildepot,target=/app/traildepot \
trailbase/trailbase /app/trail'
Then execute trail help to check that it is properly installed and list all
available command line options.
To bring up the server on localhost:4000, run:
sh
trail run
On first start, a ./traildepot folder will be bootstrapped, an admin user
created and their credentials printed to the terminal.
Afterwards open http://localhost:4000/\_/admin/
in your browser and use the credentials to log into the admin dashboard.
If you want to install the auth UI, you can simply run:
sh
trail components add trailbase/auth_ui
, which will add a WASM component in ./traildepot/wasm exposing additional UI
endpoints, e.g.
http://localhost:4000/\_/auth/login.
Building
If you have all the necessary build dependencies (Rust, node.js, geos,
protobuf, pnpm) installed, you can build TrailBase by running:
sh
Windows only: make sure to Top issues
#161Too much compiling needed now. Might we need a "Detached/optional Scripting Runtime" for developers?28 comments · 2025-10-08#156Feature Request: Serve image thumbnails17 comments · 2025-09-24#210Clarify conditions for a integer/UUID primary key column15 comments · 2026-02-08#167Make TB-as-a-library and crate releases more useful11 comments · 2025-10-21#124Feature request: add batch & transactional (create/update/upsert/delete)10 comments · 2025-08-06#86Auth docs improvements suggestions10 comments · 2025-07-11#111Feature request: add separate sqlite database as a storage layer9 comments · 2025-07-31#200Feature: Hooks for Records API7 comments · 2025-12-29
Discussions
#305Auth -login1 comments · 2026-10-22#304Would per-component capabilities fit TrailBase?1 comments · 2026-10-14#285EDIT: [REMOVED/deprecated] Proposal: Read-only replica mode5 comments · 2026-09-05#258Multi-DB/multi-tenant1 comments · 2026-07-06#246Microsoft OAuth (OIDC)1 comments · 2026-06-16#247Roadmap to v1.02 comments · 2026-06-16#225Realtime subscribe method for Kotlin SDK?1 comments · 2026-04-04#263Idea: Integrate Stoolap, the Rust database5 comments · 2026-03-07
Latest release
v0.35.12 v0.35.12 2026-11-10- Internal: simplify hook/subscription lifecycle. Subscriptions keep hook alive. - Fix race between record-level-subscriptions and record deletion, which could lead to an orphaned subscription. - Update dependencies. Full Changelog: https://github.com/trailbaseio/trailbase/compare/v0.35.11...v0.35.12