Skip to main content

Installation

Get Saucebase running locally in three commands.

Prerequisites

  • Docker Desktop 20+ — runs all services (PHP, MySQL, Redis, Nginx)
  • Node.js 22+ — for building frontend assets on the host

Quick Start

git clone https://github.com/saucebase-dev/saucebase.git my-app
cd my-app
bash bin/setup-env

bin/setup-env starts the Docker containers, installs PHP dependencies, runs the Saucebase installer with all modules, and builds frontend assets. Visit https://localhost when it completes.

Alternatives

Laravel Herd

If you have Laravel Herd installed, you can follow the steps below instead.

git clone https://github.com/saucebase-dev/saucebase.git my-app
cd my-app
composer install
cp .env.example .env
# Set APP_URL to your Herd site URL (e.g. http://my-app.test) in .env
# Configure DB_* credentials in .env
php artisan saucebase:install
npm install && npm run dev

Laravel Sail

If you prefer Laravel Sail, you can follow the steps below instead.

git clone https://github.com/saucebase-dev/saucebase.git my-app
cd my-app
cp .env.example .env
# Configure .env for Sail (DB_HOST=mysql, REDIS_HOST=redis, etc.)
sail up -d
sail composer install
sail artisan saucebase:install
npm install && npm run dev

Native PHP

If you'd prefer to run Saucebase without Docker, you can install it natively with PHP and Composer.

git clone https://github.com/saucebase-dev/saucebase.git my-app
cd my-app
composer install
cp .env.example .env
# Configure APP_URL, DB_*, REDIS_* in .env
php artisan saucebase:install
npm install && npm run dev

Explore the Modules

Your foundation is ready. Browse the available modules and install the ones that fit your product — each one copies directly into your codebase, ready to customize.

Free

Auth

Complete authentication system with login, registration, magic link (passwordless), password reset, email verification, and OAuth integration (Google, GitHub).

Free

Settings

Account settings pages for managing profile info, avatar, password, and connected social accounts.

Free

Billing

Subscription management and payment processing via Stripe with checkout sessions, billing portal, invoices, and webhook processing.

Free

Roadmap

Public roadmap with feature requests, voting, moderation, six statuses, and a Filament admin panel.

Free

Announcements

Site-wide announcement banners with scheduling, audience targeting, and cookie-based dismissal — managed from the Filament admin panel.

Free

Themes

Visual theme editor for designing your app's colors, fonts, radius, and shadows. Pick a built-in theme or build your own, then bake it into CSS — no runtime overhead.

Coming Soon

Blog

Full-featured blog with posts, categories, tags, and a Filament admin panel for content management.

Coming Soon

Teams

Multi-user team collaboration with role-based permissions, invitations, and team switching for B2B SaaS applications.