Skip to content

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.

WARNING

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

  1. Locate the saasforgekit.zip archive from your CodeCanyon download.
  2. Move it to %USERPROFILE%\Herd.
  3. Extract the archive (for example to SaasForgeKit-main).
  4. Rename the extracted folder to saasforgekit.
  5. Open PowerShell and navigate to the project folder:
powershell
cd $env:USERPROFILE\Herd\saasforgekit

Run the built-in setup script:

powershell
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

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

Start development

powershell
composer run dev

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

Visit the site

Open:

text
http://saasforgekit.test

Default admin login

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

Email:

Password:

text
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.