Schnellstart: deine erste App deployen

Diese Anleitung deployt einen kleinen Node.js-Webserver, damit du den gesamten Ablauf von Anfang bis Ende siehst: drei Dateien, eine ZIP-Datei und ein Upload. Für einen Bot oder eine andere Sprache sind die Schritte dieselben.

Bevor du beginnst

Square Cloud ist eine kostenpflichtige Plattform: für ein Deployment ist ein aktiver Plan erforderlich, damit dein Projekt von Anfang an auf produktionsreifer Infrastruktur läuft. Erstelle dein Konto und wähle dann den Plan, der für dich am besten geeignet ist (siehe was jeder Plan bietet).

Registrieren

Wenn du Square noch nie verwendet hast, registriere dich, um loszulegen.

Anmelden

Wenn du bereits ein Konto hast, melde dich an, um loszulegen.

Projekt anlegen

Erstelle einen Ordner mit diesen drei Dateien.

App schreiben

index.js beantwortet jede Anfrage mit einer kurzen Nachricht. Port und Host liest die Datei aus den Umgebungsvariablen PORT und HOST, die Square Cloud auf 80 und 0.0.0.0 setzt:

index.js

const http = require("node:http");

const port = process.env.PORT || 3000;
const host = process.env.HOST || "0.0.0.0";

http
  .createServer((req, res) => {
    res.writeHead(200, { "Content-Type": "text/plain" });
    res.end("Hello from Square Cloud!");
  })
  .listen(port, host, () => {
    console.log(`Listening on http://${host}:${port}`);
  });

Abhängigkeiten auflisten

Jedes Node.js-Projekt braucht eine package.json: Square Cloud installiert die darin aufgeführten Pakete, bevor deine App startet. Dieses Beispiel hat keine, aber die Datei muss existieren und darf nicht leer sein.

package.json

{
  "name": "hello-square",
  "version": "1.0.0",
  "private": true,
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  }
}

Konfigurationsdatei hinzufügen

squarecloud.app sagt Square Cloud, welche Datei ausgeführt wird, wie viel Arbeitsspeicher reserviert wird und welche Runtime-Version zum Einsatz kommt. SUBDOMAIN veröffentlicht die App als Website unter https://<subdomain>.squareweb.app, wähle also einen Namen, den noch niemand vergeben hat.

squarecloud.app

MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Hello Square
SUBDOMAIN=hello-square-yourname

Jedes Feld wird in der Referenz zur Konfigurationsdatei erklärt. Die VS Code-Erweiterung vervollständigt und prüft diese Datei schon beim Tippen.

Eine Website muss auf Port 80 und Host 0.0.0.0 lauschen. Ein Server, der an localhost, 127.0.0.1 oder einen anderen Port (etwa 3000 oder 8080) gebunden ist, ist nicht erreichbar, und die Website zeigt eine Timeout-Seite. Wenn du PORT und HOST ausliest, wie es index.js tut, stimmt das auf Square Cloud, und auf deinem Rechner läuft der Server weiter auf Port 3000.

Du deployst stattdessen einen Bot? Lass SUBDOMAIN weg, füge AUTORESTART=true hinzu und bewahre das Token in einer Umgebungsvariable auf, niemals im Code. Das Discord-Bot-Tutorial führt dich durch einen vollständigen Bot.

Projekt zippen

Du deployst mit der CLI? Überspringe diesen Abschnitt: squarecloud upload zippt den Ordner für dich.

Die Dateien auswählen, nicht den Ordner

Öffne den Projektordner und markiere alles darin. squarecloud.app muss auf der obersten Ebene der ZIP-Datei liegen: Wenn du den Ordner selbst komprimierst, landen die Dateien in einem Unterordner, und der Deploy schlägt mit MISSING_CONFIG fehl.

ZIP-Datei erstellen

Windows
macOS
Linux

Klicke mit der rechten Maustaste auf die markierten Dateien und wähle In ZIP-Datei komprimieren (Windows 11) oder Senden an → ZIP-komprimierter Ordner.

Klicke mit der rechten Maustaste auf die markierten Dateien und wähle Komprimieren, oder führe zip -r ../app.zip . im Ordner aus.

Größe prüfen

Die ZIP-Datei darf bis zu 100 MB groß sein. Lass node_modules, virtuelle Umgebungen und Build-Caches weg: Die Abhängigkeiten werden auf dem Server installiert, und diese Ordner werden beim Deploy ohnehin gelöscht.

Deployen

Lade die ZIP-Datei im Dashboard hoch oder deploye mit einem einzigen Befehl über die CLI.

Über das Dashboard

Upload-Seite aufrufen

Rufe die Upload-Seite auf und lade die ZIP-Datei deines Projekts hoch.

Umgebung konfigurieren

Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.

Projekt bereitstellen

Klicke abschließend auf die Schaltfläche “Deploy”, um dein Projekt auf Square Cloud zu hosten.
Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.

Anwendung wird auf Square Cloud hochgeladen

Bestätige, dass deine App live ist

Dein erstes Deploy dauert in der Regel weniger als eine Minute. Warte im Dashboard, bis der Status deiner Anwendung als “running” angezeigt wird, und prüfe die Logs auf Startfehler.
Wenn du eine Website oder API bereitgestellt hast, öffne https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.

App startet nicht? Im Leitfaden zur Fehlerbehebung findest du die häufigsten Ursachen und Lösungen.

Über die CLI

Um diese Methode zu nutzen, braucht dein Projekt eine Konfigurationsdatei mit dem Namen squarecloud.app im Stammverzeichnis. Sie teilt Square Cloud mit, wie deine Anwendung ausgeführt wird.

Leitfaden zur Konfigurationsdatei

Erfahre, wie du die Konfigurationsdatei squarecloud.app erstellst, die die Umgebung deiner Anwendung definiert.

CLI installieren

Installiere die Square Cloud CLI. Falls du sie bereits hast, führe denselben Befehl aus, um sie zu aktualisieren:

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

Anmelden

Führe den folgenden Befehl aus. Er öffnet deinen Browser: Bestätige dort die Anmeldung, und die CLI ist einsatzbereit. Es gibt keinen API-Schlüssel zu kopieren. Für Skripte und CI siehe CLI-Authentifizierung.

squarecloud auth login

Projekt hochladen

Führe in deinem Projektordner den folgenden Befehl aus. Die CLI packt den aktuellen Ordner als ZIP, lässt dabei weg, was in der squarecloud.ignore steht, und lädt ihn hoch:

squarecloud upload

Um eine selbst erstellte ZIP-Datei hochzuladen, übergib sie mit --file:

squarecloud upload --file <path/to/zip>

Bestätige, dass deine App live ist

Dein erstes Deploy dauert in der Regel weniger als eine Minute. Prüfe den Status und die Logs deiner Anwendung direkt im Terminal:

squarecloud app status
squarecloud app logs

Wenn du eine Website oder API bereitgestellt hast, öffne https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.

App startet nicht? Im Leitfaden zur Fehlerbehebung findest du die häufigsten Ursachen und Lösungen.

Sobald die App läuft, antwortet https://hello-square-yourname.squareweb.app (mit deiner Subdomain) mit Hello from Square Cloud!.

Du möchtest bei jedem Push deployen? Verbinde ein GitHub-Repository oder nutze den GitHub Actions-Workflow.

Nächste Schritte

Konfigurationsdatei

Jedes Feld von squarecloud.app: Arbeitsspeicher, Startbefehl, Subdomain und automatische Neustarts.

Umgebungsvariablen

Tokens und Verbindungs-Strings außerhalb deines Codes speichern.

Fehlerbehebung

Upload-Fehler, Websites, die nicht laden, und Apps, die nicht starten, beheben.

VS Code-Erweiterung

Hochladen, committen und Logs verfolgen, ohne deinen Editor zu verlassen.

Anleitungen für deine Sprache

Jede Anleitung behandelt die Abhängigkeitsdatei, den Startbefehl und die typischen Stolperfallen ihrer Runtime.

Dienste

Fehlerbehebung

Runtimes

Plattform

Changelog

Schnellstart: deine erste App deployen

Bevor du beginnst

Registrieren

Anmelden

Projekt anlegen

Projekt zippen

Deployen

Über das Dashboard

Über die CLI

Leitfaden zur Konfigurationsdatei

Nächste Schritte

Konfigurationsdatei

Umgebungsvariablen

Fehlerbehebung

VS Code-Erweiterung

Anleitungen für deine Sprache

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

​Bevor du beginnst

Registrieren

Anmelden

​Projekt anlegen

​Projekt zippen

​Deployen

​Über das Dashboard

​Über die CLI

Leitfaden zur Konfigurationsdatei

​Nächste Schritte

Konfigurationsdatei

Umgebungsvariablen

Fehlerbehebung

VS Code-Erweiterung

​Anleitungen für deine Sprache

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

Bevor du beginnst

Projekt anlegen

Projekt zippen

Deployen

Über das Dashboard

Über die CLI

Nächste Schritte

Anleitungen für deine Sprache