Installation
Supported runtimes and a reproducible install for Atlas 3.x.
Atlas supports PHP 8.3+ and Node 20+. Choose one installer path and stay on it for the life of the project so lockfiles remain reproducible.
System requirements
| Component | Minimum | Recommended |
|---|---|---|
| PHP | 8.3 | 8.4 |
| Composer | 2.6 | 2.8 |
| Node | 20 LTS | 22 LTS |
| Redis | 6 | 7 |
Install
bashterminal
composer create-project atlas/skeleton:^3.0 my-app
cd my-app
cp .env.example .env
php atlas key:generate
php atlas migrate
php atlas serveWarning
Pin the major channel (^3.0) in composer.json. Floating to the next major without an upgrade plan will break migrations.
Verify the install
- OKWelcome page loads on http://127.0.0.1:8000
- Database migrations completed without errors
- Queue worker starts with php atlas queue:work
Corporate network notes
Corporate proxies sometimes strip Composer metadata. Set COMPOSER_CAFILE and retry with --prefer-dist if package discovery fails.
Updated Aug 5, 2026
