Skip to main content
Install and start Admin9 from source.

​
Requirements

  • PHP 8.2 or newer
  • Composer
  • Node.js and npm
  • MySQL 8
  • Redis
  • Mailpit or another local SMTP sink
The repository also includes a Docker Compose setup based on Laravel Sail.

​
Clone and install

git clone git@github.com:admin9-labs/admin9.git
cd admin9

composer install
npm install
cp .env.example .env
php artisan key:generate

​
Configure environment

.env.example defaults to Docker Compose service names: 
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=password

REDIS_HOST=redis
MAIL_HOST=mailpit
MAIL_PORT=1025
QUEUE_CONNECTION=sync
If you are not using Docker Compose, replace those hostnames with your local services.

​
Prepare the database

php artisan migrate:fresh --seed
The default database seeder loads:
  • intervals
  • currencies
  • OAuth login providers
  • payment providers
  • roles and permissions
  • email providers
  • verification providers
  • FAQs
  • legal pages

​
Start the application

For a native local setup: 
npm run dev
php artisan serve
For the Laravel Sail workflow: 
./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate:fresh --seed
./vendor/bin/sail npm run dev

​
First URLs to verify

  • / for the marketing site
  • /admin for the Filament admin panel
  • /dashboard for the authenticated user dashboard
  • /blog
  • /roadmap
If those routes load, the core HTTP layer is functioning.
Last modified on March 30, 2026