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

ComponentMinimumRecommended
PHP8.38.4
Composer2.62.8
Node20 LTS22 LTS
Redis67

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 serve
Warning
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