Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kinsleykajiva/j-pm
This is a java process manager CLI App
https://github.com/kinsleykajiva/j-pm
Last synced: 3 days ago
JSON representation
This is a java process manager CLI App
- Host: GitHub
- URL: https://github.com/kinsleykajiva/j-pm
- Owner: kinsleykajiva
- License: gpl-3.0
- Created: 2024-03-19T19:07:36.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-04-13T18:41:26.000Z (7 months ago)
- Last Synced: 2024-04-14T04:07:05.813Z (7 months ago)
- Language: Java
- Size: 40.6 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: ReadMe.md
- License: LICENSE
Awesome Lists containing this project
README
# Java Process Manager (JPM)
**Version:** 0.1
Welcome and thank you for using JPM!
JPM is an application process manager for Linux and Windows Operating Systems, designed to help your applications run in the background, report errors, and handle crashes. Our goal is to simplify application administration as much as possible.
## Supported Application Environments
- Java Jar apps
- Node JS apps
More support for other apps is coming soon!
## Features
- **Multi-platform Support**: JPM seamlessly works across Linux and Windows environments, offering a consistent experience regardless of your operating system.
- **Background Process Management**: Effortlessly run your applications in the background, freeing up your terminal or command prompt for other tasks.
- **Error Reporting**: Stay informed about application errors and crashes with detailed reports, enabling you to troubleshoot issues effectively.
- **Simple Administration**: JPM prioritizes ease of use, providing a straightforward interface for managing your applications.
### What's Required?
Ensure that Java and Node.js are installed globally on your system.
For development, use GraalVM-Java SDK version 22 and above.
#### How to install?
just download the jpm app or binary app found in the [executable-app](/executable-app) folder in this repository.
or just run this
For windows install command :
```shell
powershell -c "irm https://raw.githubusercontent.com/kinsleykajiva/J-PM/master/executable-app/windows/install.ps1 | iex"
```
this command will download and install jpm and will also add jpm to system PATH .So restart your shell and run `jpm -v`
Make jpm as part of the global `PATH` or add the folder where jpm file is found to `PATH`
Please note the first install of running `jpm install` run as adminstrator .
Start or run an Application as a process
```shell
jpm start app.js
```
or
```shell
jpm start app.jar
```
[Screenshot](imgs/1.png)
You can call jpm from anywhere on your machine or within a folder, provided it is defined in the PATH
To get list of running apps/process that jpm is managing :
```shell
jpm ls
```
[Screenshot](imgs/2.png)
To stop application :
```shell
jpm stop
```
This will remove the app from the list of apps.
How the app works as much.
JPM does not directly run the application; instead, it utilizes a backend service application to maintain them. Running `jpm install` installs this server, which operates on port 8080.
Both apps are binary executables, and the server will always be running after installation.
Built with the following for windows:
```shell
Java version: 22+36, vendor version: GraalVM CE 22+36.1
Graal compiler: optimization level: 2, target machine: x86-64-v3
C compiler: cl.exe (microsoft, x64, 19.39.33523)
Garbage collector: Serial GC
```
Please note that this app is still in development, and we are exploring its viability as a production-ready product.
## Folders/Files of interest
- `${HOME}/.jpm` - this is the folder where everything that this app will use to cache
- `${HOME}/.jpm/logs` - where are all running apps logs are located
## Contributions
JPM is an ongoing project, and contributions from the community are welcome. If you have ideas for improvements or new features, please feel free to submit a pull request or open an issue on the project's GitHub repository