Running Machines

There are three options to run a machine.

Using automatically created cloud servers

When creating a machine with a machine provider, Dboxed will start the servers with proper init scripts so that the machine service is installed automatically.

Manually run after creation

After a machine has been created in Dboxed, you can run it with the help of a token. First, create the token:

dboxed token create --name=<token-name> --machine=<machine-name>

Copy the token and then run the following command on the server that you want the machine to be run:

dboxed machine run <machine-name> --api-token=<secret-token>

This will run the machine and start/stop boxes depending on the attached boxes. Please note that when you stop the foreground process, reconciliation of boxes will also stop. Check the next section for an alternative without this limitation.

Installing the machine service

You can also install a systemd service on your server that automatically starts the machine service, even after reboot. First, create a token the same way as in the previous chapter. Then run the following command:

dboxed machine service install <machine-name> --api-token=<secret-token>

This will install a Systemd service named dboxed-machine, which will be started automatically. It will also be started on reboot and restarted on failure.

To uninstall the service, run:

dboxed machine service uninstall