pm2.web - Process Monitoring and Management
pm2.web is a web-based application designed to monitor and manage processes running on your server using the PM2 process manager. With pm2.web, you can easily monitor your processes, control them with various actions, view logs, manage server functions, and even set up access controls for users.Easily install, deploy to Vercel, and utilize MongoDB Atlas to maintain a server with 0 open ports or host everything on-premise.
Pages - Features
- Monitoring
- Process Management
- Server Management (Planned)
- Access Control
- Settings
- Alert Setup (Planned)
Installation
To get started with pm2.web, follow these steps:
- Setup Backend
- Setup Dashboard
Usage
Once pm2.web is installed and running, you can perform the following actions:
- Monitoring:
- Process:
- Server Management (Planned/On Demand):
- Access Control:
- Settings:
- Alert Setup (Planned/On Demand):
- User Registration:
/login page
- If a registration code is configured, the user needs to enter the code
- The 1st user which registers is automatically assigned the owner permission
- The owner can assign permissions to registered users through the access control page
- registered user without any permissions can't access the dashboard nor login
- accounts linked with oauth2 can't login with credentials (can be unlinked in the settings page)
- Setup Github OAuth
- https://github.com/settings/developers -> New OAuth App
- Configure the callback url to http:///api/auth/callback/github
- Add NEXT_PUBLIC_GITHUB_CLIENT_ID and NEXT_GITHUB_SECRET to the .env file with the values from the OAuth App
- Usage: Only registered users (per credentials) can login with auth2, which links the oauth2 with the existing user account in the database
- Setup Registration Code
- Go to the settings page and add/generate the registration code
- Setup Google OAuth (Planned/On Demand)
- TBD
Up Next
- Performance Improvements for Charts & Logs
Contributing
Contributions to pm2.web are welcome! If you would like to contribute to the project, please follow these guidelines:
- Fork the repository on GitHub.
- Create a new branch from the
masterbranch to work on your changes.
- Make your modifications and ensure they adhere to the project's coding standards.
- Commit your changes with clear and descriptive commit messages.
- Push your branch to your forked repository.
- Submit a pull request to the
masterbranch of the main pm2.web repository.
License
pm2.web is released under the GNU General Public License v3.0. For more information, please refer to the LICENSE file.
Support
For any questions, issues, or feature requests, please refer to the project's GitHub repository: github.com/oxdev03/pm2.web.
Open an issue and provide details about your inquiry, and the community or maintainers will assist you as soon as possible.
Credits
pm2.web is built on the foundation of the PM2 process manager (BUS Api) (pm2.keymetrics.io). We acknowledge and appreciate the PM2 team's efforts.
The pm2.web project is currently maintained and supported by a single developer.
Disclaimer
pm2.web is not affiliated with or endorsed by PM2 or (pm2.keymetrics.io). pm2.web is an independent project created by a third-party developer.