laranail/installer-headless

Headless, framework-friendly Laravel application installer engine — requirements checks, .env generate/update, DB connection test, migration/seeder runner, admin creation, pluggable step pipeline, install lock, and CLI/TUI. Web UI ships separately in laranail/installer-web.

v0.2.0 2026-06-29 20:19 UTC

Requires

• php: ^8.4.1 || ^8.5
• ext-json: *
• illuminate/console: ^13.0
• illuminate/contracts: ^13.0
• illuminate/database: ^13.0
• illuminate/filesystem: ^13.0
• illuminate/http: ^13.0
• illuminate/support: ^13.0
• illuminate/validation: ^13.0
• laranail/console: ^1.1
• laranail/license-verifier: ^0.1
• laranail/package-tools: ^1.3
• laravel/prompts: ^0.3.18 || ^1.0

Requires (Dev)

• laranail/database-tools: ^1.0
• larastan/larastan: ^3.0
• laravel/pint: ^1.18
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• rector/rector: ^2.0
• roave/security-advisories: dev-latest
• spatie/laravel-permission: ^6.0 || ^7.0

Suggests

• laranail/database-tools: Enables the optional SQL-dump import step (ImportDatabaseStep).

MIT

• Simtabi LLC
• Imani Manyara

• cli
• installer
• wizard
• headless
• laravel
• setup
• env
• laranail

Published on Packagist.org on 2026-07-09 00:10 UTC

README

Headless installer engine for any Laravel app — requirements checks, .env generate/update, DB connection test, migrations/seeder, user creation, a pluggable step pipeline, an install-once lock, and a full CLI/TUI. All install logic, no UI coupling — it runs fully headless (CI, Docker, headless servers).

PHP ^8.4.1 on Laravel ^13. The web UI ships separately as laranail/installer-web.

Install

composer require laranail/installer-headless

Documentation

Full documentation is at opensource.simtabi.com/documentation/laranail/installer-headless — getting started, the step pipeline, license verification, the CLI/TUI, the public API for front ends, and configuration.

Contributing & security

Issues and PRs are welcome — see CONTRIBUTING.md. Report vulnerabilities per SECURITY.md ([e-mail]); participation follows the Code of Conduct.

License

MIT © Simtabi LLC. See LICENSE.