PHPackages eii/laravel-installer - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. eii/laravel-installer ActiveLibrary[Utility & Helpers](/categories/utility) eii/laravel-installer ===================== A package to install Laravel applications with wizard steps. 2.0.0(4d ago)3256↑12.5%2[1 issues](https://github.com/amit-eiitech/laravel-installer/issues)[2 PRs](https://github.com/amit-eiitech/laravel-installer/pulls)MITPHPPHP ^8.2 Since Sep 18Pushed 2mo agoCompare [ Source](https://github.com/amit-eiitech/laravel-installer)[ Packagist](https://packagist.org/packages/eii/laravel-installer)[ RSS](/packages/eii-laravel-installer/feed)WikiDiscussions main Synced today READMEChangelogDependencies (9)Versions (15)Used By (0) Laravel Installer ================= [](#laravel-installer) [![Latest Version on Packagist](https://camo.githubusercontent.com/8f8ad86a236796f35fccdca480d1380fbcc229f01b041a1b533d50d17a91d9fe/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6569692f6c61726176656c2d696e7374616c6c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eii/laravel-installer)[![Total Downloads](https://camo.githubusercontent.com/eca31f827f6f47fdde3bce8d228caf58e67dae494409f143ae9e8cc47a847f72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6569692f6c61726176656c2d696e7374616c6c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eii/laravel-installer)[![PHP Version Requirement](https://camo.githubusercontent.com/0a824c24898e8da01a31e2251264fc2b61313f613f16356e7ee892bd351191fc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6569692f6c61726176656c2d696e7374616c6c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eii/laravel-installer)[![Laravel Version](https://camo.githubusercontent.com/182f4c0a7b4cfd31f09296714e8a9734ede6da20bb4deeb5db6aa2e33777906b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d25334525334425323031302e302d7265643f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eii/laravel-installer)[![License](https://camo.githubusercontent.com/af3f51a46df71938ad6e6e18aab30a1fc4345a8e39c9c2a835d32a87100fd70e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6569692f6c61726176656c2d696e7374616c6c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/eii/laravel-installer) [![Laravel Installer](https://camo.githubusercontent.com/9d438046a86194f0ca0381ba9afbb5f43885f97220f4899436c9a128d0aebc11/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f62616e6e65722d312e6a70673f763d32)](https://camo.githubusercontent.com/9d438046a86194f0ca0381ba9afbb5f43885f97220f4899436c9a128d0aebc11/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f62616e6e65722d312e6a70673f763d32) This package features a multi-step wizard designed for a seamless Laravel application installation. It offers an intuitive interface that guides users through server requirement checks, environment configuration, database setup, and the creation of an initial admin user, all using Livewire components. By including the Laravel installer in your application, you can eliminate the need to assist your clients with server setup. Clients can independently check server requirements, update the .env file, migrate the database, and link storage, all through a step-by-step installation guide. Screenshots ----------- [](#screenshots) [![laravel-installer step-1](https://camo.githubusercontent.com/bfc4588565a7212349df70d426ee2e1d317fb3bf05e26390b0b6b0c39f883198/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d312e776562703f763d32)](https://camo.githubusercontent.com/bfc4588565a7212349df70d426ee2e1d317fb3bf05e26390b0b6b0c39f883198/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d312e776562703f763d32)[![laravel-installer step-2](https://camo.githubusercontent.com/d8ef3fa25d412abbc9fc67a9ae28c62eca8b96e3f4795378a9bd6e91cf0ff4fb/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d322e776562703f763d32)](https://camo.githubusercontent.com/d8ef3fa25d412abbc9fc67a9ae28c62eca8b96e3f4795378a9bd6e91cf0ff4fb/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d322e776562703f763d32)[![laravel-installer step-3](https://camo.githubusercontent.com/48ff950eb781d086168e2e7e65ddfac137191741f16b51a7f0bf6808972d8f88/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d332e776562703f763d32)](https://camo.githubusercontent.com/48ff950eb781d086168e2e7e65ddfac137191741f16b51a7f0bf6808972d8f88/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d332e776562703f763d32)[![laravel-installer step-4](https://camo.githubusercontent.com/da420fdca705a7ac190fbf955e887713efe98b073e97d8c4c2b0721a2d64ba87/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d342e776562703f763d32)](https://camo.githubusercontent.com/da420fdca705a7ac190fbf955e887713efe98b073e97d8c4c2b0721a2d64ba87/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d342e776562703f763d32)[![laravel-installer step-5](https://camo.githubusercontent.com/be1b5140d45a74ce11eaf6e32ad01a6eb7481b0641e3eeee11d34648b239bd94/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d352e776562703f763d32)](https://camo.githubusercontent.com/be1b5140d45a74ce11eaf6e32ad01a6eb7481b0641e3eeee11d34648b239bd94/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d352e776562703f763d32)[![laravel-installer step-6](https://camo.githubusercontent.com/32383aa59a8977e3e544553a4fd3ab78d40acf89a78ce4229e9c5cf22f52b346/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d362e776562703f763d32)](https://camo.githubusercontent.com/32383aa59a8977e3e544553a4fd3ab78d40acf89a78ce4229e9c5cf22f52b346/68747470733a2f2f65696974656368736f6c7574696f6e732e636f6d2f73746f726167652f7061636b616765732f6c61726176656c2d696e7374616c6c65722f737465702d362e776562703f763d32)✨ What’s New in v1.1.2 ---------------------- [](#-whats-new-in-v112) ### 1️⃣ Loading State for Action Buttons [](#1️⃣-loading-state-for-action-buttons) - Added loading indicators to step action buttons (Next / Finish). - Improves user experience during time-consuming operations. - Clearly informs users that processing is in progress and prevents duplicate submissions. ### 2️⃣ Improved Environment Input Handling [](#2️⃣-improved-environment-input-handling) - Automatic trimming of input values to prevent validation errors caused by trailing spaces (common when copying & pasting). - Quoted environment values when saving to .env, ensuring: - SMTP passwords containing spaces work correctly - No unexpected server errors (HTTP 500) during mail configuration 3️⃣ Spatie Permission Compatibility ----------------------------------- [](#3️⃣-spatie-permission-compatibility) - Added compatibility with spatie/laravel-permission - Ensures smooth integration for applications using role & permission management - Merged via PR #8 (thanks @vince844 🙌) Features -------- [](#features) - **Easy Installation**: Easily Integrate in to your Laravel project. - **Step-by-Step Wizard**: User-friendly interface for guided installation. - **Server Requirement Checks**: Automatically verifies PHP version, extensions, and server configurations. - **Environment Setup**: Configures `.env` file with database credentials, app name, and other essentials. - **Database Migration and Seeding**: Runs migrations and seeds the database with initial data. - **Link-Storage**: Runs storage link (configurable). - **Admin User Creation**: Sets up a default administrator account securely. - **Livewire Integration**: Dynamic, real-time updates, data validations without page reloads. - **Customizable**: Easily extend or modify steps with additional livewire components to fit your application's needs. - **Error Handling**: Graceful error messages and rollback options for failed installations. Requirements ------------ [](#requirements) - PHP >= 8.1 - Laravel >= 10.0 - Composer >= 2.0 - Livewire >= 3.0 Installation ------------ [](#installation) 1. You can install the package via Composer: ``` composer require eii/laravel-installer ``` 2. After installation, publish the package's assets and configuration by running the install command: ``` php artisan installer:install ``` 3. Update the config/installer. (app\_name, requirements, etc.) Usage ----- [](#usage) - Navigate to `/install` in your browser to start the wizard. - Follow the wizard steps to complete the installation. - The wizard steps are defined in the config/laravel-installer.php file. You can add, remove, or reorder steps as needed. - Modify the views published in `resources/views/vendor/installer` as needed. Configuration ------------- [](#configuration) The configuration file is located at `config/laravel-installer.php`. Key options include: - `lock_file`: Path to the installation lock file to prevent re-running the installer. - `redirect_after_install`: URL to redirect to after successful installation. - `requirements`: Array of server requirements to check (e.g., PHP version, extensions like `pdo_mysql`). Troubleshooting --------------- [](#troubleshooting) - **Resetting the Installer**: During development, you can reset the installation state by clearing sessions, progress, and lock files: ``` php artisan installer:reset ``` - **Installation Fails on Requirements**: Ensure your server meets the listed requirements. Check the Laravel documentation for setup guides. - **Database Connection Issues**: Verify your `.env` credentials and that the database server is running. - **Livewire Not Working**: Make sure Livewire is properly installed and assets are published. - **For more help, check the issues on GitHub or open a new one.** Development ----------- [](#development) If you want to modify the styling of the installer, you can rebuild the CSS using Tailwind CSS: 1. Install dependencies: ``` npm install ``` 2. Build the assets: ``` npm run build ``` 3. For real-time development: ``` npm run watch ``` Contributing ------------ [](#contributing) Contributions are welcome! Please follow these steps: 1. Contributions are welcome! Please follow these steps: 2. Create a new branch (`git checkout -b feature/YourFeature`). 3. Commit your changes (`git commit -m 'Add YourFeature'`). 4. Push to the branch (`git push origin feature/YourFeature`). 5. Open a Pull Request. We appreciate bug reports, feature requests, and code improvements. License ------- [](#license) This package is open-sourced software licensed under the MIT license. Credits ------- [](#credits) Amit Haldar (Eii Tech Solutions ) Built with Laravel and Livewire If you find this package useful, consider starring the repository on GitHub! ### Health Score 46 — FairBetter than 92% of packages Maintenance86 Actively maintained with recent releases Popularity20 Limited adoption so far Community10 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 77.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~23 days Recently: every ~31 days Total 13 Last Release 4d ago Major Versions 1.2.2 → 2.0.02026-06-30 PHP version history (2 changes)v1.0.0PHP ^8.1 2.0.0PHP ^8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/156731306?v=4)[Amit Haldar](/maintainers/amit-eiitech)[@amit-eiitech](https://github.com/amit-eiitech) --- Top Contributors [![amit-eiitech](https://avatars.githubusercontent.com/u/156731306?v=4)](https://github.com/amit-eiitech "amit-eiitech (31 commits)")[![vince844](https://avatars.githubusercontent.com/u/5254717?v=4)](https://github.com/vince844 "vince844 (9 commits)") ### Embed Badge ![Health badge](/badges/eii-laravel-installer/health.svg) ``` [![Health](https://phpackages.com/badges/eii-laravel-installer/health.svg)](https://phpackages.com/packages/eii-laravel-installer) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k15.1M132](/packages/laravel-pulse)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9762.4M131](/packages/roots-acorn)[tallstackui/tallstackui TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications. 725173.2k14](/packages/tallstackui-tallstackui)[laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.6k29.9M146](/packages/laravel-cashier)[laravel/ai The official AI SDK for Laravel. 1.0k3.2M194](/packages/laravel-ai) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)