Stratosv1.4.0
Getting Started• 3 min read

Installation & System Requirements

Hardware requirements, macOS compatibility, notarization, and privileged helper daemon setup.

System Requirements

  • Supported OS: macOS 13 Ventura, macOS 14 Sonoma, or macOS 15 Sequoia (macOS 13.0+ required).
  • Hardware Architecture: Native Apple Silicon (M1, M2, M3, M4) & Intel Macs.
  • Disk Space: ~600 MB of free disk space for bundled stack binaries (Nginx, PHP-FPM 8.1–8.4, MariaDB, Redis, Dnsmasq).
  • Privileges: Administrator password requested on first launch to configure /etc/resolver/test and local port redirects.

Installing Stratos

  1. Download Stratos-1.4.0.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 System Keychain.
    • Installing the terminal CLI companion (~/bin/stratos).
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.