Appearance
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
- Locate the
saasforgekit.ziparchive from your CodeCanyon download. - Move it to
%USERPROFILE%\Herd. - Extract the archive (for example to
SaasForgeKit-main). - Rename the extracted folder to
saasforgekit. - Open PowerShell and navigate to the project folder:
powershell
cd $env:USERPROFILE\Herd\saasforgekitQuick setup (recommended)
Run the built-in setup script:
powershell
composer run setupThis 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 buildStart development
powershell
composer run devThis starts the app server, queue worker, log stream, and Vite dev server.
Visit the site
Open:
text
http://saasforgekit.testDefault admin login
If you seeded the database, the default admin account is:
Email:
Password:
text
passwordDatabase 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.