2.0 KiB
Aurora Native Runtime
Aurora Native is a per-platform PHP development engine that does not require Docker. The existing container engine remains supported while native runtime bundles are developed and verified.
Runtime targets
- Linux: x64 and arm64
- macOS: Intel and Apple silicon
- Windows: x64, with arm64 evaluated after the first stable runtime
Each signed runtime bundle contains a runtime.json manifest plus versioned executables for PHP, web servers, databases, Node.js, and application tooling. Bundles install below Aurora's user-data directory and never modify system PHP or database installations.
Runtime archives are created from a staging directory with npm run build:native-runtime -- <staging-directory> <output.tar.gz>. The packager resolves every executable inside the staging root, calculates its SHA-256 checksum, writes the immutable runtime.json, excludes the build template, and creates the distributable archive. Dockside independently verifies those checksums before declaring a runtime available.
Isolation model
Every project receives reserved loopback ports, generated service configuration, isolated database data, logs, PID files, and environment variables below .aurora/native. A shared Aurora router owns friendly HTTPS project hostnames. Project files remain directly accessible on the host.
Delivery sequence
- Runtime manifest, platform detection, checksum verification, and engine abstraction.
- Native process supervisor and loopback port allocator.
- Linux x64 bundle with PHP 8.4, nginx, and MariaDB 11.8.
- WordPress provisioning, lifecycle, logs, database import/export, and Adminer.
- macOS arm64/x64 and Windows x64 bundles.
- Additional PHP/database versions, Apache, Drupal, Node.js, and developer services.
Native project creation must stay disabled until the platform bundle passes executable, service-health, database, routing, and cleanup checks. Existing projects default to the container engine for backward compatibility.