Documentation / Your server
Cloud Providers
Order and manage servers directly from cloud providers like Hetzner.
calmo.cloud can order servers directly from supported cloud providers. Instead of setting up a server yourself and entering its IP address, you select a location, server type, and OS image — calmo.cloud handles the rest.
Supported providers #
| Provider | Status |
|---|---|
| Hetzner Cloud | Supported |
More providers will be added in the future.
Setting up a cloud provider #
Before you can order servers, you need to add your cloud provider API credentials.
1. Get an API token #
Log into your cloud provider's dashboard and create an API token with read/write permissions. For Hetzner, go to Security > API Tokens in the Hetzner Cloud Console.
2. Add the provider to calmo.cloud #
- In the sidebar, go to Infrastructure Settings and select Server Providers
- Click New Server Provider
- Fill in:
- Name — A label to identify this provider (e.g., "Hetzner Production")
- Type — Select your cloud provider
- API Token — Paste the token from step 1
The API token is stored encrypted. You can add multiple providers, for example separate accounts for production and staging.
Ordering a cloud server #
1. Create a new server #
Go to Servers and click New Server. Select Cloud Provider as the creation method.
2. Configure the server #
Fill in the following fields:
- Name — A friendly name for the server
- Cloud Provider — Select the provider you configured
- Location — Choose a data center location
- Server Type — Select the hardware configuration (CPU, RAM, disk)
- OS Image — Choose the operating system
- SSH Private Key — Select the key calmo.cloud will use to connect
- Domain — The generic domain for services on this server
Server types that are currently out of stock at the selected location are shown greyed out and cannot be selected.
3. Wait for provisioning #
After clicking Create, calmo.cloud will:
- Upload your SSH key to the cloud provider (if not already there)
- Order the server via the provider's API
- Wait for the server to be ready and receive its IP address
- Automatically start the standard setup (Docker, database, proxy)
You can track the provisioning status in the server list and on the server's edit page.
Provisioning status #
Cloud servers show a Provision Status badge:
| Status | Meaning |
|---|---|
| Pending | Server creation has been queued |
| Creating | The cloud provider is setting up the server |
| Running | Server is ready and calmo.cloud is configuring it |
| Failed | Something went wrong during provisioning |
Managing cloud servers #
Cloud servers have additional controls available on the edit page:
- Power On — Start the server
- Power Off — Stop the server (requires confirmation)
- Reboot — Restart the server (requires confirmation)
- Delete from Provider — Remove the server from the cloud provider (requires confirmation)
Deleting a server from the provider permanently destroys it, including all data. This cannot be undone.
Common questions #
Can I mix manual and cloud servers?
Yes. You can have both manually added servers and cloud-provisioned servers in the same team. They work identically once set up.
What happens if provisioning fails?
The server will show a Failed status. You can delete it and try again. Common causes include API rate limits or the selected server type being temporarily unavailable.
Can I manage an existing cloud server through calmo.cloud?
Not currently. Cloud management only works for servers ordered through calmo.cloud. For existing servers, add them manually using their IP address.