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.
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 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.