Installer step 1 of 5

Environment check

The installer checks PHP, extensions, writable folders, and whether it can write the production .env file.

1. Environment check 2. Database setup 3. Store setup 4. Admin account 5. Install

What happens on this step

The installer checks PHP, extensions, writable folders, and whether it can write the production .env file.

  • Confirms PHP 8.4 and required extensions are loaded.
  • Creates storage and upload folders when possible.
  • Checks that the PHP-FPM user can write the paths it needs.

PHP 8.4 or newer

Ready

The app is built and tested on PHP 8.4 FPM.

PHP extension pdo

Ready

Required by the application runtime.

PHP extension pdo_mysql

Ready

Required by the application runtime.

PHP extension openssl

Ready

Required by the application runtime.

PHP extension json

Ready

Required by the application runtime.

PHP extension session

Ready

Required by the application runtime.

PHP extension fileinfo

Ready

Required by the application runtime.

PHP extension gd

Ready

GD is used to resize, compress, and convert uploaded images to WebP.

.env can be written

Ready

The installer writes production database settings to .env.

Database schema is readable

Ready

The installer applies database/schema.sql during the install step.

storage writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

storage/logs writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

storage/mail writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

storage/downloads writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

storage/downloads/products writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

public/uploads writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

public/uploads/products writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

public/uploads/categories writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

public/uploads/variants writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.

public/uploads/options writable

Ready

Owned by or writable to the PHP-FPM user, usually www-data on Debian.