Bosbase

Bosbase is a permanently open-source and free backend platform designed as a modern alternative to PocketBase and Supabase. It delivers a full-featured backend solution while embracing the AI era with AI-driven development tools and flexible extensibility.

Bosbase is completely free for personal use and for large-scale enterprise deployments. It's fully community-managed with no licensing fees or hidden costs.

Bosbase is built on the foundation of PocketBase — huge thanks to the PocketBase project for the inspiration! We extended and redesigned it from first principles to better support large-scale commercial deployments, PostgreSQL as the primary database (with pgvector for vector capabilities), zero-downtime hot-reload for complex business logic, WASM plugins, and AI-assisted operations.

• AI-driven development — Integrate AI to automate operations, generate code, implement logic, and bring your creative ideas to life faster.
• Complete backend in one place — Database (PostgreSQL + pgvector), Authentication, instant REST/GraphQL-like APIs, Realtime subscriptions, File Storage, Vector embeddings support, and WASM runtime for custom plugins.
• Hot-reload & zero-downtime updates — Implement and modify complex business logic without restarting the service.
• PostgreSQL backend — Scalable, production-ready with PostgreSQL support for enterprise-grade deployments and cost reduction.
• Extensible platform — Designed for AI-driven automated operations and custom extensions.
• Permanently open source & free — MIT licensed, completely free for personal use and large-scale enterprise deployments. Fully community-managed with no licensing fees.

Bosbase is permanently open source and free. It's completely free for personal use and for large-scale enterprise deployments. It's fully community-managed, ensuring transparency and long-term sustainability.

Bosbase helps enterprises and developers reduce backend costs while enabling powerful AI-native features.

Create a docker-compose.yml file with the following services, then run docker compose up -d:

services:
  bosbase-node:
    image: bosbase/bosbase:latest
    restart: unless-stopped
    environment:
      SASSPB_POSTGRES_URL: postgres://postgres:postgres@postgres-db:5432/pbosbase?sslmode=disable
      BS_ENCRYPTION_KEY: 0123456789abcdef0123456789abcdef
      # OPENAI_API_KEY: ${OPENAI_API_KEY:-sk-af61vU1kIT0uw5YzOM7VRM3KGrxBAfuhVgJX9ghtkHfdRVsu}
      # OPENAI_BASE_URL: ${OPENAI_BASE_URL:-https://api.chatanywhere.org/v1}
      # REDIS_URL: ${REDIS_URL:-192.168.1.60:6379}
      # REDIS_PASSWORD: ${REDIS_PASSWORD:-}
      WASM_ENABLE: ${WASM_ENABLE:-true}
      WASM_INSTANCE_NUM: ${WASM_INSTANCE_NUM:-2}
      SCRIPT_CONCURRENCY: ${SCRIPT_CONCURRENCY:-2}
      FUNCTION_CONN_NUM: ${FUNCTION_CONN_NUM:-10}
      EXECUTE_PATH: ${EXECUTE_PATH:-/pb/functions}
      # BOOSTER_PATH: ${BOOSTER_PATH:-/pb/booster-wasm}
      # BOOSTER_POOL_MAX: ${BOOSTER_POOL_MAX:-2}
      # BOOSTER_WASMTIME_MEMORY_GUARD_SIZE: ${BOOSTER_WASMTIME_MEMORY_GUARD_SIZE:-65536}
      # BOOSTER_WASMTIME_MEMORY_RESERVATION: ${BOOSTER_WASMTIME_MEMORY_RESERVATION:-0}
      # BOOSTER_WASMTIME_MEMORY_RESERVATION_FOR_GROWTH: ${BOOSTER_WASMTIME_MEMORY_RESERVATION_FOR_GROWTH:-1048576}
      PB_DATA_MAX_OPEN_CONNS: ${PB_DATA_MAX_OPEN_CONNS:-30}
      PB_DATA_MAX_IDLE_CONNS: ${PB_DATA_MAX_IDLE_CONNS:-15}
      PB_AUX_MAX_OPEN_CONNS: ${PB_AUX_MAX_OPEN_CONNS:-10}
      PB_AUX_MAX_IDLE_CONNS: ${PB_AUX_MAX_IDLE_CONNS:-3}
      PB_QUERY_TIMEOUT: ${PB_QUERY_TIMEOUT:-300s}
    ports:
      - "8090:8090"
      - "2678:2678"
    volumes:
      - ./bosbase-data:/pb/pb_data
      - ./pb_hooks:/pb_hooks
    depends_on:
      postgres-db:
        condition: service_healthy
    networks:
      - basenode
    command: ["sh", "-c", "sleep 5 && /pb/bosbase serve --http=0.0.0.0:8090 --encryptionEnv BS_ENCRYPTION_KEY"]
    healthcheck:
      test: ["CMD-SHELL", "wget --quiet --tries=1 --spider http://localhost:8090/api/health || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

  postgres-db:
    image: pgvector/pgvector:pg16
    restart: unless-stopped
    environment:
      POSTGRES_DB: pbosbase
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    networks:
      - basenode
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d pbosbase"]
      interval: 2s
      timeout: 5s
      retries: 10
      start_period: 10s

networks:
  basenode:
    name: basenode

Access the admin dashboard at http://localhost:8090/_/. API endpoint: http://localhost:8090

• Dashboard: https://try.bosbase.com/_/
• Superuser email: [email protected]
• Superuser password: bosbasepass
• API endpoint: https://try.bosbase.com

Feel free to explore and test features!

For production-grade self-hosting (including PostgreSQL setup, reverse proxy with SSL, backups, monitoring, etc.), see the dedicated guide:

→ bosbase/self-host

Includes one-click install scripts for Ubuntu/Rocky Linux, Docker Compose configurations, Caddy/NGINX reverse proxy, and more.

Questions, feedback, or issues? Reach out at [email protected]

Join discord

Bosbase docs

The backend HTTP, SSE, and WebSocket interface documentation is available in the local apidocs/ directory:

• Start here: apidocs/API_REFERENCE.md
• Categorized API docs: apidocs/api-reference/README.md

These documents describe request bodies, field meanings, types, examples, response formats, and endpoint usage for direct API integration.

Bosbase provides ready-to-use templates and SDKs for popular frameworks:

• bosbase/bosbase-nextjs — Next.js template with Bosbase JavaScript SDK integration

  • Includes TypeScript support
  • Docker-ready configuration
  • Complete SDK documentation included
  • Google Auth setup guide
  • Locale switcher usage examples

• bosbase/bosbase_flutter — Flutter template with Bosbase Dart SDK

  • Cross-platform mobile app (Android, iOS, Web, Windows)
  • Complete CRUD examples (songs collection)
  • Offline mock data fallback
  • Flutter SDK 3.35.7 compatible
  • Step-by-step setup guide
  • JDK 17 configuration for Android

Both templates include:

• Pre-configured Bosbase client setup
• Authentication helpers
• CRUD operation examples
• Docker deployment support
• Complete documentation

See the individual repositories for detailed setup instructions and examples.

1. Copy the SDK Docs Path to Your Project
   To keep documentation handy (e.g., for reference or offline use):

   • Clone or download the relevant SDK repository (e.g., js-sdk for JavaScript/TypeScript, python-sdk for Python, etc.) from https://github.com/orgs/bosbase/repositories.
   • Copy the docs/ folder (or README.md + any markdown docs) from the SDK repo into your project's docs/sdk/ directory (create it if needed).
   • Alternatively, link to the official docs: https://docs.bosbase.com/docs/sdk for the latest versions across all SDKs.

2. Configure Bosbase Connection
   Use the following credentials and endpoint for testing/demo purposes (from the official Bosbase try instance). For production, deploy your own Bosbase instance and update these values.

   • Superuser email: [email protected]
   • Superuser password: bosbasepass
   • API endpoint (base URL): https://try.bosbase.com
   • Admin URL: https://try.bosbase.com/_/

   Note on API endpoint to AI: Bosbase supports AI-assisted development through its SDKs (see AI Development Guides in https://docs.bosbase.com/docs/sdk). The base API endpoint above handles all requests, including any AI-related features or integrations (no separate AI-specific endpoint is required; use the standard SDK methods for collections, auth, etc.). For AI-specific examples, refer to the guides in the docs (e.g., for JS SDK: https://docs.bosbase.com/docs/sdk/js-docs/ai-development-guide).

Bosbase would not exist without PocketBase — thank you for the amazing foundation!

MIT License — see LICENSE for details.

Bosbase is permanently open source and free. It's completely free for personal use and for large-scale enterprise deployments. It's fully community-managed with:

• ✅ No licensing fees
• ✅ No enterprise tiers or paid features
• ✅ No usage limits or restrictions
• ✅ Full transparency and community governance
• ✅ Freedom to self-host and modify

We believe in open-source software that remains free forever, empowering developers and businesses of all sizes to build amazing products without backend licensing costs.