starting-as-a-service.md

Starting as a Service

When using CommandBox on a staging or production server, you may wish to start up servers as a service when the OS comes online. The recommended approach is to use the CommandBox Service Manager Module, which is a commercial module that handles all major operating systems (Linux, Mac, Windows) automatically.

See screencast here:

{% embed url="https://www.ortussolutions.com/products/commandbox-service-manager" %}

Alternatively, you can manually do so following one of these community guides.

Windows

See screencast here: https://www.ortussolutions.com/blog/screencast-starting-commandbox-servers-as-a-windows-service

MacOS

Coming soon...

CentOS/RHEL/Ubuntu (system.d)

Create a .service file

nano /usr/lib/systemd/system/mySite.service

as follows:

[Unit]
Description=mySite Service

[Service]
ExecStart=/usr/local/bin/box server start /var/www/mySiteAPI/server.json
Type=forking

[Install]
WantedBy=multi-user.target

Start the service

systemctl start mySite.service

Give the service about a minute to load up, then check its status

systemctl status mySite.service

Once you've verified the service is running as expected, enable the service to load at boot

systemctl enable mySite.service