BRG Process Management Quick Start
BGR is a daemon process manager that will help you manage and keep your application online. Getting started with BGR is straightforward, it is offered as a simple and intuitive CLI, installable via Bun.
Installation
The latest BGR version is installable with Bun:
$ bun install bgr@latest -g
To install Node.js and Bun you can use NVM
Start an app
The simplest way to start, daemonize and monitor your application is by using this command line:
$ bgr --name myapp --directory /path/to/project --command "npm start"
Managing processes
Managing application state is simple here are the commands:
# Restart a process
$ bgr myapp --restart
# Delete a process
$ bgr --delete myapp
# Delete all processes
$ bgr --nuke
# Clean stopped processes
$ bgr --clean
View process details
To check the current status of your application and view detailed process information (including PID, runtime, logs, and environment variables), use the following command:
$ bgr myapp
List managed applications
List the status of all application managed by BGR:
$ bgr
What’s next?
Learn how to declare all your application’s behavior options into a TOML configuration file.
You can also explore the available command-line options to manage your processes more efficiently.
Learn how to perform Safe Restarts to reload your application without downtime.
Learn how to configure startup scripts so your apps come back online automatically.
Contribute to this page