oxmgr
v0.1.7
Published
Oxmgr - lightweight cross-platform process manager
Readme
Oxmgr
Oxmgr is a lightweight, cross-platform Rust process manager and PM2 alternative.
Use it to run, supervise, reload, and monitor long-running services on Linux, macOS, and Windows. Oxmgr is language-agnostic, so it works with Node.js, Python, Go, Rust binaries, and shell commands.
Why Oxmgr
- Language-agnostic: manage any executable, not just Node.js apps
- Cross-platform: Linux, macOS, and Windows
- Low overhead: Rust daemon with persistent local state
- Practical operations: restart policies, health checks, logs, and CPU/RAM metrics
- Config-first workflows with idempotent
oxmgr apply - PM2 ecosystem compatibility via
ecosystem.config.json - Interactive terminal UI for day-to-day operations
Core Features
- Start, stop, restart, reload, and delete managed processes
- Named services and namespaces
- Restart policies:
always,on-failure, andnever - Health checks with automatic restart on repeated failures
- Log tailing, log rotation, and per-process stdout/stderr logs
- Best-effort zero-downtime reloads
- Git pull and webhook-driven update workflow
- Import and export bundles with
.oxpkg - Service installation for
systemd,launchd, and Windows Task Scheduler
Install
npm
npm install -g oxmgrHomebrew
brew tap empellio/homebrew-tap
brew install oxmgrChocolatey
choco install oxmgr -yAUR (Arch Linux)
yay -S oxmgr-binAPT (Debian/Ubuntu)
echo "deb [trusted=yes] https://vladimir-urik.github.io/OxMgr/apt stable main" | sudo tee /etc/apt/sources.list.d/oxmgr.list
sudo apt update
sudo apt install oxmgrBuild from source
git clone https://github.com/Vladimir-Urik/OxMgr.git
cd OxMgr
cargo build --release
./target/release/oxmgr --helpFor signed APT setup, local installation, and platform-specific notes, see docs/install.md.
Quick Start
Start a service:
oxmgr start "node server.js" --name api --restart alwaysInspect and operate it:
oxmgr list
oxmgr status api
oxmgr logs api -f
oxmgr uiUse a config file for repeatable setups:
version = 1
[[apps]]
name = "api"
command = "node server.js"
restart_policy = "on_failure"
max_restarts = 10
stop_timeout_secs = 5oxmgr validate ./oxfile.toml
oxmgr apply ./oxfile.tomlPM2 Migration
Oxmgr supports PM2-style ecosystem.config.json, which makes it easier to move existing PM2 setups without rewriting everything on day one.
Useful links:
Documentation
- Documentation Index
- Installation Guide
- User Guide
- CLI Reference
- Terminal UI Guide
- Pull and Webhook Guide
- Deployment Guide
- Service Bundles
- Examples
Contributing
Issues, PRs, and documentation improvements are welcome. Start with CONTRIBUTING.md for local setup, checks, and testing expectations.
Community
Oxmgr is created and maintained by Vladimír Urík.
The project is developed under the open-source patronage of Empellio.
