n8n auf Square Cloud selbst hosten

​

Einführung

• Dieser Artikel führt dich durch die Erstellung und das Hosten einer n8n-Anwendung auf Square Cloud.
• Bevor du beginnst, stelle sicher, dass du ein Konto bei Square Cloud hast, das du auf der Registrierungsseite mit deiner E-Mail-Adresse erstellen kannst.
• Schließlich benötigst du einen aktiven Plan mit mindestens 4GB RAM auf deinem Konto, zum Beispiel Standard: n8n läuft mit 3GB (MEMORY=3072 weiter unten), und kleinere Pläne haben nicht so viel RAM. Vergleiche die verfügbaren Pläne und wähle einen passend zu deinen Bedürfnissen.

​

Projekt erstellen

• n8n läuft auf Node.js, das Projekt braucht also nur eine package.json.
• Die package.json führt n8n in ihren Abhängigkeiten und hat ein Skript, um es zu starten. Hier ist das Beispiel:

{
  "name": "squarecloud-n8n",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "n8n"
  },
  "author": "Square Cloud Education <squarecloud.app>",
  "license": "ISC",
  "dependencies": {
    "n8n": "2.41.3"
  }
}

• Die n8n-Version ist bewusst fest eingetragen: latest kann bei jeder Neuinstallation auf eine neue Major-Version mit Breaking Changes springen. n8n 2.x benötigt Node.js 24 oder neuer, was VERSION=recommended bereitstellt.
• Um später zu aktualisieren, prüfe die neueste Version mit npm view n8n version, lies die n8n-Release-Notes, ändere die Version in der package.json und lade dein Projekt erneut hoch.

​

Dateien in deiner ZIP-Datei

• package.json
• squarecloud.app (die Konfigurationsdatei unten)
• .env (optional, mit den Variablen unten)

​

Konfigurationsdatei

• Beim Upload über das Dashboard legst du die Runtime manuell auf Node.js fest und verwendest npm run start als Startbefehl. In einer Konfigurationsdatei squarecloud.app sieht das so aus:

DISPLAY_NAME=App name
RUNTIME=nodejs
START=npm run start
MEMORY=3072
VERSION=recommended
SUBDOMAIN=my-n8n-subdomain

• Der obige MEMORY-Wert folgt den Größenregeln der Plattform. Sieh dir warum es RAM-Mindestwerte gibt an, wenn du ihn anpassen möchtest.
• Lege als Nächstes die folgenden Umgebungsvariablen fest. Du kannst sie in eine .env-Datei im Stammverzeichnis des Projekts schreiben (n8n lädt sie beim Start) oder sie im Upload-Formular unter Erweiterte Konfiguration festlegen. Ersetze my-n8n-subdomain durch deine SUBDOMAIN.

N8N_PORT=80
N8N_LISTEN_ADDRESS=0.0.0.0
N8N_HOST=my-n8n-subdomain.squareweb.app
N8N_PROTOCOL=https
N8N_WEBHOOK_URL=https://my-n8n-subdomain.squareweb.app/

• N8N_PORT und N8N_LISTEN_ADDRESS sorgen dafür, dass n8n auf allen Interfaces an Port 80 lauscht, wohin Square Cloud den Traffic deiner Subdomain leitet. n8n liest die von Square Cloud gesetzte Variable PORT nicht, daher ist N8N_PORT erforderlich.
• N8N_HOST, N8N_PROTOCOL und N8N_WEBHOOK_URL teilen n8n seine öffentliche Adresse mit. Ohne N8N_WEBHOOK_URL zeigen die Webhook-URLs, die n8n in deinen Workflows anzeigt, auf den internen Port, und externe Dienste können sie nicht erreichen. Ältere Anleitungen nennen diese Variable WEBHOOK_URL, die in n8n 2.x veraltet ist. Weitere Optionen findest du in den n8n-Endpoint-Variablen.
• Im Dashboard gesetzte Variablen haben Vorrang vor der .env-Datei. Wie du sie verwaltest, erfährst du unter Umgebungsvariablen.

​

Das Projekt auf Square Cloud hochladen

​

Über das Dashboard

1

Upload-Seite aufrufen

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

2

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.

3

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.

4

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

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

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

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

squarecloud app status
squarecloud app logs

​

Das Owner-Konto erstellen

​

Abschließende Überlegungen

​

Nächste Schritte

​

Kontaktiere uns