Erste Schritte

Anmelden

Öffne cloady.com und melde dich mit E-Mail und Passwort, Google, GitHub oder dem SSO deines Unternehmens an. Um ein Konto anzulegen oder ein Passwort zurückzusetzen, wähle Create account or reset password, bestätige den Code aus deiner E-Mail und lege ein Passwort fest. Bestehende Konten mit Passwort brauchen bei der Anmeldung keinen E-Mail-Code. Du kannst auch schon vor der Anmeldung im Deploy-Feld auf cloady.com beginnen: Konfiguriere die App dort, und Deploy bittet dich, dich anzumelden, ohne dass du die Seite verlässt, und deployt sie anschließend.

Bei der ersten Anmeldung wird dein Konto angelegt, und du wirst gebeten, eine Telefonnummer zu verifizieren: Gib sie ein und danach den Code, den du per SMS erhältst. Das ist einmal pro Konto nötig – bis es erledigt ist, schickt dich das Dashboard zu diesem Schritt zurück, und die API antwortet mit phone_required (403). Danach landest du in deinem ersten Workspace, den Cloady für dich anlegt; er bleibt leer, bis du etwas deployst.

Einen Workspace anlegen

Ein Workspace enthält deine Anwendungen, dein Team und ein Abonnement und hat seine eigene Adresse cloady.com/w/acme-inc. Dein erster Workspace existiert bereits. Um einen weiteren hinzuzufügen, klicke in der oberen Leiste auf den Umschalter WORKSPACE und dann auf New workspace:

1. Name – z. B. Acme Inc. Der Name für URLs wird daraus abgeleitet und live angezeigt; ist er schon vergeben, siehst du die angepasste Variante.
2. Icon · optional – klicke auf die Kachel im Kopfbereich des Dialogs, um eines hochzuladen. Es legt auch die Farben des Workspaces fest.

Ein neuer Workspace kostet nichts und kann sofort deployen. Was er zahlt, richtet sich nach dem, was seine Apps deklarieren; der Preis ergibt sich aus vier Plänen (siehe Kapazität und Preis). Jeder Workspace, dessen Apps in 0,5 vCPU, 1 GB RAM und 5 GB SSD passen, zahlt nichts.

Ein Abonnement gilt für alle Regionen – pro Region musst du nichts freischalten.

Region und Umgebung wählen

Jede App läuft in genau einer Region und einer Umgebung, die du beide beim Deploy festlegst. Du stellst sie in der oberen Leiste ein; eine neue App übernimmt, was dort ausgewählt ist, und in ihrer Karte kannst du vor dem Deploy noch eine andere Region wählen.

• Region – wo deine App läuft: USA West, USA Ost, Deutschland oder Singapur. Das Menü listet Regionen unter Deployed (in denen du schon Apps hast) und unter Available; ein Wechsel filtert auch das Dashboard. Eine App bleibt in ihrer Region, solange du sie nicht mit Transfer verschiebst – um dieselbe App in einer zweiten Region zu betreiben, deploye sie auch dort.
• Environment – Production, Preview oder Development. Der Name einer Anwendung ist innerhalb eines Workspaces und einer Umgebung eindeutig, daher kann api gleichzeitig in Production und in Preview existieren. Development-Apps behalten eine bearbeitbare Kopie deines Codes und werden bei einem Push nicht neu deployt.

Worauf du stoßen kannst:

• Hat eine Region keine freie Kapazität, zeigt der Deploy Adding capacity…, während ein Server der Region beitritt, und läuft dann von selbst weiter – das dauert meist ein paar Minuten. Lässt sich die App nach etwa 40 Minuten immer noch nicht platzieren, schlägt der Deploy fehl; starte ihn dann erneut.

Eine App deployen

Klicke in der oberen Leiste auf New application und sag dem Feld, was du deployen willst:

• Ein Template – eine fertige Anwendung (WordPress, Postgres, …); tippe zum Suchen und klicke eines an.
• Ein GitHub-Repository – füge seine URL ein oder wähle eines deiner Repos. Öffentliche Repos funktionieren sofort; für ein privates wähle zuerst Connect GitHub account.
• Ein Docker-Image – tippe seinen Namen (nginx, ghcr.io/acme/api:1.4) oder eine Registry wie docker.io/, um beliebte Images zu durchstöbern.
• Ein Ordner – zieh ihn hinein, bis zu 50 MB und 3000 Dateien (node_modules, .git, .next, __pycache__ und .DS_Store werden übersprungen). Gut für eine fertig gebaute statische Website – ganz ohne Git.

Das Feld wird zur Karte der App: oben das, was du gewählt hast, ihr Monatspreis und der Deploy-Button, darunter die Services, die sie ausführt. Öffne eine beliebige Zeile unter Settings, um sie vor dem Deploy zu ändern:

• Environment – trag Variablen ein; Templates führen die auf, die sie brauchen, und können Passwörter für dich generieren.
• Build – für Code: der Branch, das Root-Verzeichnis und optionale Build- und Start-Befehle. Lass sie leer, es sei denn, die Erkennung liegt falsch – das passiert bei Monorepos und bei Builds, die in einem Unterordner liegen. Redeploy on every push ist für GitHub-Quellen standardmäßig aktiviert.
• Domains – der Name der App, nach dem sich ihre Adresse richtet, und eigene Domains, die du verbinden möchtest.
• Resources, Region und Managed backups – Skalierungsfaktoren, wo die App läuft, und tägliche Backups für 20 % des Preises der App.

Drück Enter oder klicke auf Deploy. Innerhalb des Gratis-Kontingents wird nichts berechnet. Darüber hinaus wird die hinterlegte Karte für den Rest des Monats belastet; ohne Karte fragt Deploy zuerst nach einer, und bei einer abgelehnten Karte kommt payment_required (402) zurück, ohne dass etwas angelegt wird.

Cloady baut die App, richtet HTTPS für dich ein und stellt sie unter einer cloady.io-Adresse bereit, die aus dem App-Namen, einem kurzen eindeutigen Code und dem Workspace-Namen besteht:

<app-name>-<code>-<workspace>.cloady.io

Eine App namens My Blog im Workspace acme ist also erreichbar unter:

my-blog-k7q2v9ze-acme.cloady.io

In jeder Umgebung und jeder Region ist die Adresse gleich aufgebaut; die genaue URL steht auf der Seite der App.

Die App erscheint im Raster des Workspaces, während der Dialog den Deploy live anzeigt. Konfiguration und generierte Secrets findest du unter Settings → Environment.

Eine App umbenennen

Benenne sie unter Settings → General um. Die Adresse folgt dem Namen: Der alte Hostname antwortet nicht mehr, der neue übernimmt – aktualisiere alle Links, DNS-Einträge und API-Aufrufe, die ihn verwendet haben. (Das Feld Slug ist der Teil, der in der URL erscheint; legst du ihn selbst fest, folgt er dem Namen nicht mehr.)

Lösche nie eine App, um sie umzubenennen. Das Löschen einer App vernichtet ihre Daten endgültig – jeden Service, jedes Volume, jede Umgebungsvariable, jede Domain und jeden Deploy-Eintrag, ohne dass sich das rückgängig machen lässt. Im Dialog musst du zur Bestätigung den Slug der App eintippen.

Eine eigene Domain hinzufügen

Um die App unter deinem eigenen Hostnamen auszuliefern, öffne Settings → Domains.

1. Gib den Hostnamen ein (z. B. app.yourdomain.com) und klicke auf Add domain. Aktiviere Redirect to another host (permanent), wenn er woandershin weiterleiten soll, statt die App auszuliefern.
2. Richte DNS mit dem Bereich DNS configuration auf Cloady aus; er zeigt genau die Einträge, die du kopieren musst:
   • CNAME (Standard) – ein Eintrag, der auf den integrierten cloady.io-Hostnamen der App zeigt. Am besten für Subdomains.
   • A / AAAA – für die Apex-Domain (Root-Domain), die kein CNAME sein kann. Lege beide Einträge genau wie angezeigt an.
3. Sobald DNS auflöst, richtet Cloady HTTPS für den Host von selbst ein. Die Zeile der Domain zeigt den Fortschritt: queued → pending → issued (TLS · active). failed (TLS · error) bedeutet fast immer, dass DNS noch nicht auf Cloady zeigt – korrigiere den Eintrag, dann wird es erneut versucht.

Der integrierte cloady.io-Hostname funktioniert neben deiner Domain weiter. Du kannst eine Domain auch schon beim Deploy verbinden, über die Zeile Domains der Karte; Check DNS sagt dir dort, ob die Einträge bereits auf Cloady zeigen.

Mit CLI, API, Terraform oder MCP automatisieren

Alles im Dashboard lässt sich per Skript steuern.

• CLI – npm install -g cloady, cloady login, dann cloady deploy github.com/your-org/your-repo. Siehe die CLI-Referenz.
• REST-API – lege mit persönlichen API-Tokens Workspaces an, deploye Apps, verwalte Domains und streame Logs. Siehe den API-Überblick und die Endpunkt-Referenz.
• Terraform – definiere Workspaces, Anwendungen, Umgebungsvariablen und Domains als Code und führe dann terraform apply aus. Siehe den Leitfaden zum Terraform-Provider.
• MCP-Server – steuere Cloady aus einem AI-Agenten heraus, mit denselben Operationen als Tools. Siehe den Leitfaden zum MCP-Server.