- How do I install nuboxdevcom/maintenance-bundle in a Laravel app?
- Install the package with Composer using composer require nuboxdevcom/maintenance-bundle. If your Laravel version does not auto-discover the service provider, register it in config/app.php. Check the README for any publishable configuration or required setup steps.
- How do I enable and disable maintenance mode with this package?
- The package provides commands to put your Laravel application into maintenance mode and bring it back online. Run the enable command before deploys or migrations, then run the disable command when work is finished. Refer to the README for the exact command signatures and options.
- Can I let specific users or IP addresses bypass maintenance mode?
- Yes, the package is designed to let you control who still gets through while everyone else sees the maintenance message. You can typically allow specific IP addresses or authenticated users through configuration. Check the README for the exact bypass options supported by your version.
- How do I customize the maintenance page message shown to visitors?
- The package shows a friendly maintenance message to visitors while the site is unavailable. You can customize the response through publishable views or configuration options where available. Review the README for the supported customization path in your installed version.
- Which Laravel versions does this package support?
- The package overview references Symfony 3.x and 4.x, while the package blurb targets Laravel apps, so compatibility depends on the specific release you install. Check composer.json and the README for the supported Laravel and PHP version constraints before adopting it. Pin a version that you have tested against your application.
- Is this package a replacement for Laravel's built-in maintenance mode?
- Laravel already ships with php artisan down and php artisan up for basic maintenance mode. This package is aimed at adding control over who can still access the site and what everyone else sees. Evaluate whether those extra controls justify adding another dependency to your project.
- How can I test maintenance mode without locking myself out?
- Add your own IP address or an authenticated test account to the bypass list before enabling maintenance mode. Test the complete enable and disable flow in staging first, then repeat it in production during a low-traffic window. Keep an emergency disable command ready in case something goes wrong.
- Does maintenance mode affect Laravel queues and scheduled tasks?
- Maintenance mode generally affects HTTP requests, not queue workers or scheduled tasks that are already running. Pause workers and the scheduler separately if they must not run during your deploy or migration. Confirm the package behavior in the README for your specific version.
- Can I change the HTTP status code returned during maintenance mode?
- The package is intended to return a friendly maintenance response while your application is unavailable. Customize the response and any status code settings through configuration or published views where supported. If you need a specific status code such as 503, verify that option in the README before relying on it.
- Is nuboxdevcom/maintenance-bundle actively maintained and safe for production?
- Review the repository's recent commits, open issues, and tagged releases before adopting the package in production. Pin a tested version and run through the enable and disable flow in staging first. If the package appears inactive, consider Laravel's built-in down and up commands or a maintained alternative.