Fluxbase

Fluxbase

A lightweight, self-hosted Backend-as-a-Service with PostgreSQL, real-time subscriptions, authentication, storage, and edge functions.

Get Started View on GitHub

Core Features

🗄️

Postgres REST API

Full PostgreSQL with PostgREST-compatible API, row-level security, and automatic migrations.

🔐

Authentication

JWT tokens, OAuth/OIDC, SAML SSO, magic links, 2FA, and complete user management.

⚡

Edge Functions

Deploy serverless TypeScript/JavaScript functions with Deno runtime and cron scheduling.

📁

File Storage

S3-compatible storage with signed URLs, image transforms, and access policies.

🔄

Real-time

WebSocket subscriptions for database changes with RLS-aware filtering.

⏱️

Background Jobs

Scheduled and queued jobs with progress tracking, retries, and worker pools.

🤖

AI Chatbots

Natural language interfaces to your database with streaming AI responses.

🔍

Vector Search

pgvector-powered semantic search with automatic embeddings.

🏠

Self-Hosted

Single binary deployment. No vendor lock-in. Own your data.

Quick Start

1. Clone and generate secrets

   git clone https://github.com/fluxbase-eu/fluxbase.git
   cd fluxbase/deploy
   ./generate-keys.sh  # Select option 1 (Docker Compose)

   Save the Setup Token displayed - you’ll need it for admin access.

2. Start Fluxbase

   docker compose -f docker-compose.minimal.yaml up -d

   Then open localhost:8080/admin/setup, enter your setup token, and create your admin account.

3. Install the SDK and connect

   npm install @fluxbase/sdk

   import { createClient } from "@fluxbase/sdk";
   
   // Get your API key from the admin dashboard → Client Keys
   const client = createClient("http://localhost:8080", "your-anon-key");
   
   // Query data
   const { data } = await client
     .from("posts")
     .select("id, title, author:users(name)")
     .eq("published", true);

4. Subscribe to real-time changes

   client.realtime
     .channel("table:public.posts")
     .on("INSERT", (payload) => {
       console.log("New post:", payload.new_record);
     })
     .subscribe();

For detailed setup instructions, see the Quick Start Guide.

Why Fluxbase?

Supabase Alternative

Fluxbase provides a similar developer experience to Supabase but runs as a single binary with no external dependencies besides PostgreSQL. Perfect for:

• Self-hosting on your own infrastructure
• Air-gapped environments with offline operation
• Edge deployments where simplicity matters
• Cost-conscious teams who want to avoid vendor lock-in

Compare with Supabase →

Admin Dashboard

Manage your backend with a powerful built-in admin UI featuring database browsing, user management, real-time monitoring, and more.

Explore the Docs

Introduction Learn what Fluxbase is and why it exists

Authentication Set up JWT, OAuth, and user management

Database Guide Row-level security and data access

Edge Functions Deploy serverless TypeScript functions

Real-time WebSocket subscriptions for live updates

Storage File uploads and S3-compatible storage