Cloud Providers
Order and manage servers directly from cloud providers like Hetzner.
hav.sh 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 — hav.sh 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 hav.sh
- 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 hav.sh 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, hav.sh 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 hav.sh 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 hav.sh?
Not currently. Cloud management only works for servers ordered through hav.sh. For existing servers, add them manually using their IP address.