Erste App in fünf Minuten

Diese Anleitung führt von einem leeren Konto zu einer öffentlich erreichbaren App. Du brauchst ein Git-Repository mit einer Web-Anwendung, die auf dem Port aus der Umgebungsvariable PORT lauscht.

1. Konto anlegen und E-Mail bestätigen

Nach der Registrierung kommt eine E-Mail mit einem Bestätigungslink. Erst danach lassen sich Apps anlegen und deployen – das hält die Plattform frei von Wegwerf-Konten, die nur Rechenzeit verbrauchen wollen.

Die ersten 5,00 € im Monat sind je Team frei. Eine kleine App darf also dauerhaft laufen, ohne dass etwas zu zahlen ist.

2. App anlegen

In der Console unter Apps → App erstellen gibst du einen Namen und die Quelle an. Der Name bestimmt auch die Adresse: meinname.apps.rechenhalle.de.

Als Quelle sind möglich:

GitHub-Repository – nach der Anbindung deployt jeder git push automatisch neu.
Öffentliche Git-Adresse – etwa https://github.com/nutzer/projekt.git.

3. Was beim Deployment passiert

Rechenhalle erkennt selbst, womit deine App gebaut wird:

Gefundene Datei	Was passiert
`Dockerfile`	Dein Dockerfile wird gebaut und gestartet
`package.json`	`npm ci`, optional `npm run build`, dann `npm start`
`requirements.txt` oder `pyproject.toml`	Virtuelle Umgebung, Abhängigkeiten, Start über `Procfile`
`Procfile`	Der Prozess `web` wird gestartet, weitere laufen als Worker mit
`index.html`	Die Dateien werden als statische Website ausgeliefert

Danach startet der Container, und ein Health-Check prüft, ob die App auf ihrem Port antwortet. Erst wenn sie antwortet, wird der Verkehr umgeschaltet. Schlägt der Start fehl, bleibt die alte Version online.

4. Auf dem richtigen Port lauschen

Der Port steht in der Umgebungsvariable PORT und wird bei jedem Start neu gesetzt. Fest verdrahtete Ports funktionieren nicht.

// Node.js
const port = process.env.PORT || 3000;
app.listen(port, () => console.log("läuft auf " + port));

# Python, z. B. mit Gunicorn im Procfile
web: gunicorn app:app --bind 0.0.0.0:$PORT

5. Eigene Domain verbinden

Im Reiter Domains trägst du deine Domain ein und bekommst zwei DNS-Einträge: einen TXT-Eintrag als Besitznachweis und einen A- oder CNAME-Eintrag, der auf Rechenhalle zeigt. Sobald beide stimmen, wird das Zertifikat automatisch ausgestellt.

Eigene Domains sind in jeder Größe enthalten und in beliebiger Anzahl.

Häufige Fragen

Wie lange dauert ein Deployment?

Für eine kleine Node- oder Python-App meist unter einer Minute. Der Build macht den Großteil aus; der Wechsel auf die neue Version selbst dauert Sekunden.

Was kostet die erste App?

In Größe S 0,90 Cent pro Stunde, höchstens 5,00 € im Monat – und das ist genau der monatliche Freibetrag. Eine kleine App läuft damit kostenlos.

Brauche ich Docker-Kenntnisse?

Nein. Nur wer ein eigenes Dockerfile mitbringt, nutzt es auch. Alle anderen Apps werden automatisch erkannt und gebaut.