RustaBase OSS Overview — Install and Develop the Rust Backend

About

RustaBase is an open-source backend engine built in Rust, designed to help you build and scale modern applications with a powerful, unified platform. It provides a PostgreSQL database, authentication, file storage, realtime capabilities, edge functions, and an admin dashboard — all in one.

Features

Database

PostgreSQL at the core, with powerful extensions and a simple API.

Auth

Built-in authentication with email, OAuth, and JWT support.

Storage

Store and serve files, images, and more with access controls.

Realtime

Live data subscriptions for your application.

Edge Functions

Run server-side JavaScript for endpoints and database events.

Admin Dashboard

A focused dashboard to manage your data, users, and services.

Setup

Option 1 — One-click install (Docker)

Run the backend and PostgreSQL with Docker Compose. Configure your secrets before starting.

git clone https://github.com/rustabase/rustabase.git
cd rustabase
cp .env.example .env
# Set RB_ENCRYPTION_KEY (32 characters) and POSTGRES_PASSWORD in .env
docker compose up -d --build

Create your administrator, then open http://localhost:8090/admin/.

docker compose exec rustabase rustabase superuser upsert [email protected] 'strong-password'

Option 2 — Develop

Install Rust, Bun, and PostgreSQL. Point RB_POSTGRES_URL at an existing database.

git clone https://github.com/rustabase/rustabase.git
cd rustabase
cp .env.example .env
# Set RB_ENCRYPTION_KEY (32 characters) and RB_POSTGRES_URL in .env
make console
cargo run -- serve

Run cargo test --workspace for tests. For dashboard development, run bun install && bun run dev in console/.

Deploy

Documentation

Read the docs to learn more and get started.

License

RustaBase is licensed under the Apache License 2.0.See the LICENSE file for more information.