Download the PHP package iperamuna/laravel-supervisor-manager without Composer
On this page you can find all versions of the php package iperamuna/laravel-supervisor-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download iperamuna/laravel-supervisor-manager
More information about iperamuna/laravel-supervisor-manager
Files in iperamuna/laravel-supervisor-manager
Package laravel-supervisor-manager
Short Description A comprehensive FilamentPHP dashboard for managing Supervisor processes and configurations in Laravel applications.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-supervisor-manager
Laravel Supervisor Manager
A powerful FilamentPHP panel for managing Supervisor processes directly from your Laravel application.
✨ Features
- Dashboard Overview: View real-time status of your Supervisor instance and all processes.
- Smart Process Control:
- Global Controls: Start, Stop, or Restart all processes with a single click from the status widget.
- Contextual Actions: Configuration cards automatically toggle between Start and Stop actions based on the process state.
- Log Viewer: View
stdoutandstderrlogs live in a modal (tailing the last 10KB of output). - Configuration Manager:
- Manage
.conffiles directly from the UI. - Sync configurations to your system's Supervisor directory.
- Deploy changes (reread/update) via the UI.
- Detect orphaned (system-only) or unsynced (local-only) configurations.
- Manage
- Filament Powered: Built with Filament V3/V4, offering a beautiful, responsive, and dark-mode compatible UI.
- Secure: Uses XML-RPC to communicate with Supervisor (localhost only recommended).
🚀 Installation
You can install the package via composer:
After installing, run the installation command to publish assets and configure the connection:
This command will prompt you for:
- The URL path for the dashboard (default:
supervisor). - The Supervisor XML-RPC credentials (URL, Port, Username, Password).
⚙️ Configuration
1. Enabling XML-RPC in Supervisor
For this package to work, you must enable the HTTP server in your supervisord.conf file (usually in /etc/supervisord.conf or /etc/supervisor/supervisord.conf).
Add or uncomment the following section:
⚠️ Security Warning: Only bind to
127.0.0.1to prevent external access. This interface gives full control over your processes.
2. Secure File Copy Setup (Recommended)
The package uses a secure architecture to handle supervisor configuration files:
How It Works
Why This Approach?
- ✅ Laravel never needs write access to system directories
- ✅ Controlled sudo access to a single, auditable script
- ✅ Automatic reread/update after deployment
- ✅ Works on macOS (Homebrew) and Linux systems
Automated Setup
Run the included setup script:
This will:
- Install the copy script to
/usr/local/bin/supervisor-copy - Guide you through sudoers configuration
- Test the setup automatically
Manual Setup
If you prefer manual installation:
Step 1: Install the copy script
Step 2: Configure sudoers
Add this line (replace your-username with your actual user):
For Laravel Herd on macOS, use your Mac username:
For production servers, use your web server user:
Step 3: Update your .env
Legacy Mode (Not Recommended)
If you can't use the secure copy script, you can disable it:
Note: This requires your web server user to have write permissions to the supervisor directory, which is a security risk.
🛡️ Access Control
By default, the package uses App\Models\User in the configuration. To control who can access the dashboard, ensure your User model implements FilamentUser and defines the canAccessPanel method, or configure a different user model in config/supervisor-manager.php.
🔧 Usage
Visit the dashboard at /supervisor (or your configured path).
Managing Processes
- Global Control: The status widget (top right) allows you to Start All, Stop All, or Restart the supervisor daemon.
- Smart Toggle: The status widget automatically hides the "Start All" button if processes are running, keeping the UI clean.
- Process Cards: Use the Restart button on any process card to restart it individually.
- Logs: Click LOGS or ERR on a process card to view the latest log output.
Managing Configurations
- Navigate to the Configurations page.
- Create new configurations locally.
- Sync them to the system directory (
/etc/supervisor/conf.dby default). - Deploy changes to reload the Supervisor daemon.
- Start/Stop: Each configuration card features a smart Start/Stop button that reflects the current running state of the process group.
🛠️ Development
If you are contributing to the package and need to update the styles:
-
Install dependencies:
- Build the Tailwind assets:
🤝 Contributing
Please see CONTRIBUTING for details.
📄 License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-supervisor-manager with dependencies
filament/filament Version ^4.0|^5.0
guzzlehttp/guzzle Version ^7.8
illuminate/support Version ^11.0|^12.0
laravel/prompts Version ^0.3