PHPackages souravmsh/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. [DevOps & Deployment](/categories/devops) 4. / 5. souravmsh/laravel-installer ActiveLibrary[DevOps & Deployment](/categories/devops) souravmsh/laravel-installer =========================== A sleek and easy-to-use web-based installer for Laravel applications. 1.2.6(3w ago)028proprietaryPHPPHP ^8.2 Since Apr 12Pushed 3w agoCompare [ Source](https://github.com/souravmsh/laravel-installer)[ Packagist](https://packagist.org/packages/souravmsh/laravel-installer)[ RSS](/packages/souravmsh-laravel-installer/feed)WikiDiscussions main Synced 3w ago READMEChangelog (3)Dependencies (6)Versions (4)Used By (0) [![Version](https://camo.githubusercontent.com/c896511147621f6f232380150982dc2d121986e9839ec2eede670ee91d23900f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e322e362d626c75652e7376673f7374796c653d666c61742d737175617265)](CHANGELOG.md)[![Software License](https://camo.githubusercontent.com/5576aee1b4947ddf675987dc0d20c8fa9addda562c323b18fe3d353a88dc8f2b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d50726f70726965746172792d7265642e7376673f7374796c653d666c61742d737175617265)](LICENSE) A sleek, modern, and easy-to-use web-based installer for Laravel applications. This package provides a step-by-step wizard to help users set up your Laravel application, including environment configuration, database connection, and license validation. Features -------- [](#features) - **Standard Requirements Check**: Verifies PHP version and required extensions. - **Permissions Check**: Ensures necessary directories are writable. - **Environment Configuration**: Easy setup for `.env` variables. - **Database Setup**: Wizard for database connection and migration. - **License Validation**: Flexible support for license key validation (Required, Optional, or Disabled). - **Modern Mobile-App UI**: Sleek, glassmorphism-based design optimized for clarity and ease of use. Installation ------------ [](#installation) You can install the package via composer: ``` composer require souravmsh/laravel-installer ``` Setup ----- [](#setup) ### 1. Register the Service Provider (Optional for Laravel 5.5+) [](#1-register-the-service-provider-optional-for-laravel-55) The package will automatically register itself using Laravel's package discovery. ### 2. Publish Configuration and Assets [](#2-publish-configuration-and-assets) You can publish the configuration file and views using the following commands: **Publish All:** ``` php artisan vendor:publish --tag="laravel-installer-publish" ``` **Publish Configuration Only:** ``` php artisan vendor:publish --tag="laravel-installer-config" ``` **Publish Views Only:** ``` php artisan vendor:publish --tag="laravel-installer-views" ``` ### 3. Middleware [](#3-middleware) The package provides two middlewares: - `installer.check`: Ensures the application is installed before allowing access. - `installer.redirect`: Redirects to the homepage if the application is already installed. You should apply these to your routes as needed. The configuration file is located at `config/laravel_installer.php`. You can customize the application name, license server, and other settings here. ``` return [ 'app_name' => env('APP_NAME', 'Laravel Application'), // Enable or disable the installer entirely 'installer_enabled' => env('INSTALLER_ENABLED', true), // Force redirection to the installer when the app is uninstalled 'force_install_redirect' => env('INSTALLER_FORCE_REDIRECT', true), // Path to the installation lock file 'installed_key_path' => env('INSTALLER_KEY_PATH', 'app/private/key.install'), // Supported: "required", "optional", "disabled" 'license_check' => env('INSTALLER_LICENSE', 'optional'), 'license_server_url' => env('INSTALLER_LICENSE_URL', 'null'), 'license_storage_path' => env('INSTALLER_LICENSE_KEY_PATH', 'app/private/key.private'), ]; ``` Usage ----- [](#usage) Once installed, navigate to `/install` to begin the installation process. The installer will guide you through: 1. Welcome Screen 2. Server Requirements Check 3. Directory Permissions Check 4. Environment Configuration 5. Database Setup 6. License Validation 7. Installation Completion ### Commands [](#commands) #### Install Package [](#install-package) Use this command to install the package and publish its configuration file to your host application. Note: The configuration is also automatically copied when the package is required via Composer (Zero-Touch publish). ``` php artisan laravel-installer:install ``` #### Reset / Fresh Install [](#reset--fresh-install) Use this command to tear down the current installation and return the application to setup mode. It is safe to run at any time — it includes a confirmation prompt to prevent accidental resets. ``` php artisan laravel-installer:reset ``` The command runs three sequential steps: StepAction**1. Fix permissions**Sets write permissions on `.env` (664), `storage/` (775 recursive), `bootstrap/cache/` (775), and `storage/app/private/` (775). Creates missing directories automatically.**2. Remove lock files**Deletes the install lock file (`key.install`) **and** the license key file (`key.private`) if they exist. Prints the resolved path of each so you can verify.**3. Clear all caches**Runs `optimize:clear` which flushes config, route, view, event, and compiled bootstrap caches — including `bootstrap/cache/config.php` that individual `cache:clear` calls miss.After the command completes, the `installer.check` middleware will detect the missing lock file and redirect all protected routes to the setup wizard. > **Note:** If `INSTALLER_ENABLED=false` is set in your `.env`, the middleware bypasses the lock-file check entirely. The command will warn you if this is the case — set `INSTALLER_ENABLED=true` to re-enable setup mode. Security -------- [](#security) If you discover any security-related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Shohrab Hossain](https://github.com/souravmsh) - [All Contributors](../../contributors) License ------- [](#license) Proprietary License. Please see [License File](LICENSE) for more information. ### Health Score 42 — FairBetter than 88% of packages Maintenance94 Actively maintained with recent releases Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 85.2% 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 ~39 days Total 3 Last Release 25d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/12506579?v=4)[Shohrab Hossain](/maintainers/souravmsh)[@souravmsh](https://github.com/souravmsh) --- Top Contributors [![souravmsh](https://avatars.githubusercontent.com/u/12506579?v=4)](https://github.com/souravmsh "souravmsh (23 commits)")[![souravqfin](https://avatars.githubusercontent.com/u/156651351?v=4)](https://github.com/souravqfin "souravqfin (4 commits)") --- Tags laravelconfigurationSettingsinstallerwizarddeploymentinstallsetupsouravmshcodekernel ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/souravmsh-laravel-installer/health.svg) ``` [![Health](https://phpackages.com/badges/souravmsh-laravel-installer/health.svg)](https://phpackages.com/packages/souravmsh-laravel-installer) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)