Site Management & Project Scaffolding

Adding and Linking Sites

Stratos automatically scans your configured webroot directory (default: ~/Sites). Any subfolder automatically maps to a local .test domain:

~/Sites/storefront   ->   https://storefront.test
~/Sites/api-backend  ->   https://api-backend.test

Linking External Directories

If your projects live in another folder (e.g. ~/Projects or ~/Documents/Code):

1. Open the main Stratos window and navigate to the Sites tab.
2. Click + Link Folder in the top-right toolbar.
3. Choose the project folder in the macOS file dialog.
4. Stratos provisions the Nginx VHost and creates a seamless domain binding immediately.

Per-Site Configuration

Click on any site in the list to configure its specific runtime environment:

• PHP Version Pinning: Choose between PHP 8.1, 8.2, 8.3, 8.4, or 8.5. Each version runs on an isolated Unix socket.
• HTTPS Toggle: Enable or disable SSL certificate generation per site.
• Node.js Version: Assign project-specific Node.js versions (e.g. Node 18 LTS vs Node 20/22).
• Public Directory Override: Set custom webroot public paths (e.g. /public for Laravel/Symfony or root / for WordPress).

1-Click Project Scaffolding

Want to start a new project from scratch? Click + New Project in the Sites tab:

• Laravel: Scaffolds a complete Laravel application using composer create-project laravel/laravel with pre-configured .env and SQLite database.
• WordPress: Downloads the latest WordPress release with automated salts generation.
• Slim PHP: Minimalist REST API starter boilerplate.