A Bun-native process manager inspired by PM2 that leverages Bun's built-in tools and APIs to provide fast, efficient process management for Node.js and Bun applications.
git clone https://github.com/eyuael/BunPM.git
cd bunpm
bun install
bun run build
# Install globally (when published)
bun install -g bunpm
# Start your first process
bun-pm start server.js --name "my-app"
# List all processes
bun-pm list
# View real-time logs
bun-pm logs my-app --follow
# Scale to multiple instances
bun-pm scale my-app 4
# Stop the process
bun-pm stop my-app
# Start a simple process
bun-pm start app.js
# Start with a custom name
bun-pm start app.js --name "web-server"
# Start with environment variables
bun-pm start app.js --name "api" --env NODE_ENV=production
# Start multiple instances (clustering)
bun-pm start app.js --name "cluster-app" --instances 4
# Start without auto-restart
bun-pm start app.js --name "one-shot" --no-autorestart
# Start with memory limit
bun-pm start app.js --name "limited" --memory 512M
# List all processes
bun-pm list
# Show detailed process information
bun-pm show my-app
# Stop a process
bun-pm stop my-app
# Restart a process
bun-pm restart my-app
# Delete a process configuration
bun-pm delete my-app
# Scale process instances
bun-pm scale my-app 8
# View last 100 lines of logs
bun-pm logs my-app
# View last 50 lines
bun-pm logs my-app --lines 50
# Follow logs in real-time
bun-pm logs my-app --follow
# View error logs only
bun-pm logs my-app --error
# Real-time monitoring dashboard
bun-pm monit
# Show detailed process metrics
bun-pm show my-app
# Save current processes to ecosystem file
bun-pm save ecosystem.json
# Start processes from ecosystem file
bun-pm start ecosystem.json
# Reload processes from ecosystem file
bun-pm reload ecosystem.json
# Start a web server with 4 instances
bun-pm start server.js --name "web" --instances 4
# Each instance gets a unique PORT environment variable:
# Instance 0: PORT=3000
# Instance 1: PORT=3001
# Instance 2: PORT=3002
# Instance 3: PORT=3003
# Set memory limit (process restarts if exceeded)
bun-pm start memory-intensive.js --memory 1G
# Monitor memory usage
bun-pm monit
# Start process in specific directory
bun-pm start ../other-project/app.js --cwd /path/to/project
# Set multiple environment variables
bun-pm start app.js --env "NODE_ENV=production,API_KEY=secret"
Create an ecosystem.json file to manage multiple processes:
{
"apps": [
{
"name": "web-server",
"script": "server.js",
"instances": 4,
"autorestart": true,
"memory": "512M",
"env": {
"NODE_ENV": "production",
"PORT": 3000
}
},
{
"name": "worker",
"script": "worker.js",
"instances": 2,
"cwd": "./workers",
"env": {
"WORKER_TYPE": "background"
}
},
{
"name": "scheduler",
"script": "scheduler.js",
"autorestart": true,
"memory": "256M",
"env": {
"SCHEDULE_INTERVAL": "60000"
}
}
]
}
Start all processes:
bun-pm start ecosystem.json
The examples/ directory contains ready-to-use ecosystem configurations:
See the examples documentation for detailed explanations and best practices.
Bun.spawn(), Bun.file(), and Bun.serve() for optimal performanceBun.spawn()| Command | Description | Options |
|---|---|---|
start <script> | Start a new process | --name, --instances, --memory, --env, --cwd, --no-autorestart |
stop <name|id> | Stop a process | None |
restart <name|id> | Restart a process | None |
delete <name|id> | Delete process configuration | --force |
list | List all processes | --json |
show <name|id> | Show detailed process info | --json |
logs <name|id> | View process logs | --lines, --follow, --error |
scale <name|id> <instances> | Scale process instances | None |
monit | Real-time monitoring | None |
save [file] | Save ecosystem configuration | None |
reload <file> | Reload from ecosystem file | None |
running: Process is active and healthystopped: Process has been manually stoppederrored: Process failed to start or crashed too many timesrestarting: Process is being restarted# Clone and install dependencies
git clone https://github.com/eyuael/BunPM.git
cd bunpm
bun install
# Run all tests
bun test
# Run specific test suites
bun run test:unit # Unit tests
bun run test:integration # Integration tests
bun run test:performance # Performance tests
bun run test:e2e # End-to-end tests
bun run test:stress # Stress tests
# Run comprehensive test suite
bun run test:comprehensive
# Run performance benchmarks
bun run benchmark
# Build for production
bun run build
# Clean build artifacts
bun run clean
# Run in development mode
bun run dev start server.js --name test-app
The process manager is designed to handle:
MIT License - see LICENSE file for details
See TROUBLESHOOTING.md for common issues and solutions.
FAQs
A Bun-native process manager inspired by PM2
The npm package bunpm receives a total of 3 weekly downloads. As such, bunpm popularity was classified as not popular.
We found that bunpm demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Open source is under attack because of how much value it creates. It has been the foundation of every major software innovation for the last three decades. This is not the time to walk away from it.
Security News
Socket CEO Feross Aboukhadijeh breaks down how North Korea hijacked Axios and what it means for the future of software supply chain security.
Security News
OpenSSF has issued a high-severity advisory warning open source developers of an active Slack-based campaign using impersonation to deliver malware.