Installation & System Requirements

System Requirements

• Supported OS: macOS 13 Ventura, macOS 14 Sonoma, macOS 15 Sequoia, or macOS 16+ Tahoe (macOS 13.0+ required).
• Hardware Architecture: Native Apple Silicon (M1, M2, M3, M4) & Intel Macs.
• Disk Space: ~600 MB of free disk space for core binaries, database clients, and PHP runtimes.
• Privileges: Administrator password requested on first launch to configure /etc/resolver/test and local port redirects.

Installing Stratos

1. Download Stratos-1.4.1-universal.dmg from the official downloads page.
2. Open the DMG file and drag Stratos.app into your /Applications directory.
3. Launch Stratos from Launchpad or Spotlight.
4. The First-Launch Onboarding Wizard will guide you through:
   • Selecting your local webroot directory (default: ~/Sites).
   • Trusting the 4096-bit Local Root CA in your macOS login Keychain.
   • Installing the terminal CLI companion (~/bin/stratos).
   • Pre-flight verification and on-demand provisioning of missing runtimes.

Security & Gatekeeper Notarization: Stratos binaries are signed with an official Apple Developer ID and notarized via Apple's Notary Service (xcrun notarytool). It opens seamlessly without security warnings.

Verifying Installation

Open your terminal and check the CLI companion status:

stratos status

You will see a JSON output displaying active services, assigned ports, and webroot configurations.