Managing processes with Bluepill


Bluepill was Cloud 66’s default process manager until June 2020. It has been replaced by systemd. Some legacy servers (deployed before June 2020) may still be using Bluepill. To check this:

If your servers are not running Bluepill then you are reading the wrong guide. Please visit the systemd doc instead.

If you’d like to migrate from Bluepill to systemd, please follow the migration checklist.


If bluepill is installed on your server, you can control your processes manually from your server command-line interface.

A process Bluepill config is saved into a .pill file. Bluepill loads pill files for each process it manages. See also Bluepill gem page.

When you add processes through Cloud 66 interface, they will be managed by Cloud 66. For instance if you restart your server, they will be automatically restart aswell.

Process naming convention

Cloud 66 processes beging with “cloud66_” and user processes with “user_”

Build your own pill file

To build your own process with Bluepill, please refer to this page.

Don’t forget to add a log file in your pill config. For instance:

process.stdout = process.stderr = "<STACK_PATH>/log/process.log"


To get all processes status:

$ sudo bluepill status

To get a specific process status:

$ sudo bluepill <process_name> status


To stop a specific process:

$ sudo bluepill <process_name> stop


To start a specific process:

$ sudo bluepill <process_name> start

Load a process

To load a .pill file into bluepill:

$ sudo bluepill load /etc/bluepill/autoload/<process_name>.pill

Unload a process

To quit a process from bluepill:

$ sudo bluepill <process_name> quit


Also remember that we configure the pill files to log to <STACK_PATH>/log folder.

Process signals

The default process signals for Bluepill processes are:

Generic web reload signal

Stop sequences

Process type Signal
sidekiq processes stop_sequence: term, 31, kill
All other processes (including web servers) stop_sequence: quit, 30, term, 11, kill
Restart restart_on_deploy: true

If you’d like to specify custom process signals you can do this in your Manifest file.