A simple process supervisor written in Go.

Paladin is a simple way to launch and maintain services. It provides the following features:

• Simple TOML configuration.
• Automatically restart failed processes.
• Log each process to a different file, even separating stdout and stderr.
• Specify process dependencies, so things start in the right order.
• Launch processes under different users and groups.

• Clone this repo in your $GOPATH.
• Copy etc/paladin.conf.sample to /etc/paladin.conf and set your values.
• Run go build.
• Put paldin in your path.

Compile with something like -ldflags="-X main.localbase=/usr/local" on systems where the config file will not live under /etc, such as FreeBSD.

This code is under the BSD-2-Clause license. See the LICENSE file for the full text.

The config file uses TOML format. It consists of general options, and several [[process]] blocks that define each process that paladin is responsible for.

The following general options do not go inside a TOML block:

The following options are per-process, and go in a [[process]] block:

log_file = "/var/log/paladin.log"

[[process]]
name = "my-program"
path = "/path/to/my-program"
args = []
cwd = "/path/to"
restart_delay = 1000
min_runtime = 100
stdout = "/tmp/my-program-stdout"
user = "myuser"
group = "mygroup"

[[process]]
name = "my-other-program"
path = "/path/to/my-other-program"
args = ["-a", "-d"]
min_runtime = 100
soft_depends = [ "my-program" ]
restart_delay = 1000