Installing SaasForgeKit on Windows

Quick Answer

What this page covers: Installing SaasForgeKit on Windows

This guide walks you through setting up SaasForgeKit on Windows 10/11.

See related implementation guides

Last updated:

Installing SaasForgeKit on Windows

This guide walks you through setting up SaasForgeKit on Windows 10/11.

We recommend using Laravel Herd for Windows. It bundles PHP, Composer, and a zero-config local server for Laravel projects.

For Pro version

Complete Tenancy Mode setup before running migrations.

Laravel Herd

Download and install Herd from the official Herd website.

During setup, Herd creates a parked directory at %USERPROFILE%\Herd. Projects in this directory are automatically served on the .test domain.

Install SaasForgeKit

Clone the repository into your Herd directory:

Lite (open source):

cd $env:USERPROFILE\Herd
git clone git@github.com:SaasForgeKit/saasforgekit.git
cd saasforgekit

Pro (requires purchase):

cd $env:USERPROFILE\Herd
git clone git@github.com:SaasForgeKit/saasforgekit-pro.git saasforgekit
cd saasforgekit

Run the built-in setup script:

composer run setup

This command installs PHP dependencies, creates .env, generates an app key, runs migrations, installs npm dependencies, and builds frontend assets.

Optional: manual setup steps

composer install
copy .env.example .env
php artisan key:generate
php artisan migrate --seed
npm install
npm run build

Start development

composer run dev

This starts the app server, queue worker, log stream, and Vite dev server.

Visit the site

Open:

http://saasforgekit.test

Default admin login

If you seeded the database, the default admin account is:

Email:

[email protected]

Password:

password

Database notes

For tenancy mode configuration, see Tenancy Mode (Required). For local development, SQLite or MySQL are both valid options. Configure your database connection in .env as needed.

PreviousmacOS
NextDocker