Quick Start

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

/detail.png

List managed applications

List the status of all application managed by BGR:

$ bgr 

/ls.png

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