Deutsche Cloud
Menu

Quickstart

From a new account to an app with a database and its own domain. Each step works in the console too; these are the commands, in order.

The full quickstart in the documentation

1. Create an account

Register at the console: your name and a work address, then the company the invoices go to, then where machines run (on our account, or in a Hetzner project of yours). A six-digit code arrives by e-mail and is valid for ten minutes. You become the owner of a new organization.

2. Install the command line and sign in

For Linux and macOS. dcloud login shows a code and opens the console in your browser; approve it there, and the CLI holds a key that acts as you for 90 days.

$ curl -fsSL https://console.platform.deutschecloud.app/api/cli/install.sh | sh
$ dcloud login
$ dcloud whoami

3. Deploy an app

Any public image works; your own goes to the container registry first. The first deployment creates the app’s machine, so it takes a minute or two. This is what it printed on our test installation:

$ dcloud deploy apps create --name hello --builder image \
    --image-ref docker.io/traefik/whoami:v1.10 --port 80
id                       b903c545-f3c2-49ea-aaad-ca18842ab562
status                   created
instanceType             performance-1
defaultUrl               hello.titanom-demo-7091.apps.platform-development.deutschecloud.app
$ dcloud deploy apps deploy hello --wait
hello: deployment 81909c7a-4364-4411-85d5-e2d97226f641 (generation 3) started
12:52:28 [provision] Provisioning a new app server
12:52:28 [provision] App server i-337b86bb ready; waiting for the agent to roll out
12:53:33 [bootstrap] Machine booted; installing the container runtime
12:53:41 [bootstrap] Container runtime and web server are up; installing the machine software
12:53:42 [rollout] Machine started rolling out generation 3
12:53:44 [rollout] Image: pulled traefik/whoami:v1.10 in 1.7s
12:53:45 [rollout] The rollout on this machine took 2.2s
12:53:48 [release] Deployment is live
live hello generation 3
$ curl https://hello.titanom-demo-7091.apps.platform-development.deutschecloud.app
Hostname: c8651f717ed8
GET / HTTP/1.1
Host: hello.titanom-demo-7091.apps.platform-development.deutschecloud.app
Captured on our test installation, 20 November 2026, output trimmed. On your account the address ends in apps.platform.deutschecloud.app.

4. Add a database and bind it

A single node is available in about two minutes and is private to your network. Binding creates a role for the app and hands it DATABASE_URL and the PG* variables at the next rollout.

$ dcloud rds instances create --identifier hello-db \
    --instance-class performance-2 --db-name hello
$ dcloud rds instances list
$ dcloud deploy database bind <app id> --db-instance-id <database id> --redeploy

5. Point a domain

Either create a CNAME at your DNS provider, or move the domain’s nameservers to a hosted zone here. The certificate follows within about a minute of the name resolving.

$ dcloud deploy domains add <app id> --domain www.example.com
$ dcloud dns zones create --name example.com

6. Connect an assistant

Claude, Cursor, VS Code and ChatGPT can use Deutsche Cloud through MCP with your permissions, after you approve them on a consent screen.

$ claude mcp add --transport http dcloud https://console.platform.deutschecloud.app/api/mcp

7. Clean up

Everything is billed while it exists. Each delete asks first; add --yes in a script.

$ dcloud deploy apps delete <app id>
$ dcloud rds instances delete <database id>
$ dcloud dns zones delete <zone id>

Where to go next

Documentation
Every product, with concepts, guides and reference.
CLI reference
Every API operation as a command, generated from the API itself.
Connect an AI assistant
MCP clients, read-only grants, access keys for agents.
OpenAPI
The HTTP API as an OpenAPI 3.1 document.