Managing Machines

Machines can be managed via the CLI or the dashboard.

Manually creating a machine

To create a machine via the CLI, run:

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

The --name flag is required. This will create a machine without a machine provider, meaning that you’ll have to manually provision and connect a machine. See running machines for details.

Letting Dboxed create a cloud machine

You can also let Dboxed create a cloud machine for you. First, create a machine provider and then use the name of the provider in the machine creation:

dboxed machine create --name=<machine-name> --machine-provider=<provider-name> <provider-args>

<provider-args> depends on the provider type. See machine-providers for details.

Listing machines

To list existing machines, run:

dboxed machine ls

Attaching boxes

To attach a box to a machine, run:

dboxed machine add-box <machine-name> --box=<box-name>

If the machine is running, the box will be started on the machine.

Detaching boxes

To detach a box from a machine, run:

dboxed machine rm-box <machine-name> --box=<box-name>

If the machine is running, the box will be stopped on the machine.

Removing a machine

To remove a machine, run:

dboxed machine rm <machine-name>

If the machine is running, all boxes will be stopped on the machine.