Machine Providers

Machine Providers are able to create machines on behalf of dboxed, automatically provisioning them with the necessary dboxed binaries and configuration.

Currently, AWS and Hetzner are supported.

You can manage machine providers via the dashboard or via the CLI.

Creating a machine provider

To create a machine provider, use the dashboard or the CLI. With the CLI, run:

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

The --name and --type flags are required.

<provider-args> depends on the provider type, check the documentation for the individual provider types for details.

Creating a machine

To create a machine with a machine provider, run:

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

The --name and --machine-provider flags are required.

This will create the machine and then let the machine provider create the underlying cloud server.

<provider-args> depends on the provider type, check the documentation for the individual provider types for details.

Deleting a machine

When you delete a machine belonging to a machine provider, the underlying cloud server will be de-provisioned automatically.

Removing a machine provider

To remove a machine provider, run:

dboxed machine-provider rm <mp-name>