> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Von Heroku zu Square Cloud migrieren

> Eine praktische Anleitung für den Umzug einer Web-, Worker- oder API-Anwendung von Heroku zu Square Cloud: Konfigurations-Mapping, Deployment-Schritte und wichtige Unterschiede, die du einplanen solltest.

## Warum Entwickler migrieren

Herokus Dyno-Modell rechnet Rechenstunden und Add-ons getrennt ab, was die monatlichen Kosten mit wachsender App schwer vorhersehbar macht. Square Cloud verfolgt einen anderen Ansatz:

* **Vorhersehbare Pauschalpreise in BRL** — ein Planpreis deckt RAM, vCPU und Blob Storage ab, ohne dass sich gemessene Add-on-Rechnungen aufsummieren. Siehe [Pläne und Preise](/de/platform/plans).
* **Dedizierte Ressourcen** — RAM und vCPU sind für deine Anwendung reserviert, keine geteilte Best-Effort-Kapazität.
* **Deploy in Sekunden** — lade eine ZIP-Datei hoch oder pushe über die CLI, und deine Anwendung läuft, ohne Build-Warteschlange.

## Konzept-Mapping

| Heroku                                              | Square Cloud                                                                                       |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `Procfile` (`web:`/`worker:`-Prozesstypen)          | [`squarecloud.app`-Konfigurationsdatei](/de/getting-started/config-file) — Felder `MAIN`/`START`   |
| Buildpacks                                          | [Runtimes](/de/runtimes/introduction) — automatische Spracherkennung, kein Buildpack zum Auswählen |
| Config Vars                                         | Umgebungsvariablen, gesetzt im Dashboard oder aus einer `.env`-Datei hochgeladen                   |
| Heroku Postgres                                     | [Verwaltete Square-Cloud-Datenbanken](/de/services/databases) (PostgreSQL, MySQL, MongoDB, Redis)  |
| `heroku logs --tail`                                | Dashboard-Logs, oder `squarecloud app logs` über die CLI                                           |
| Benutzerdefinierte Domains (kostenpflichtige Dynos) | Benutzerdefinierte Domains ab dem [Standard-Plan oder höher](/de/platform/plans)                   |

## Migrationsschritte

<Steps>
  <Step title="Erstelle deine Konfigurationsdatei">
    Ersetze dein `Procfile` durch eine `squarecloud.app`-Datei im Stammverzeichnis deines Projekts. Ein Heroku-`Procfile` wie:

    ```
    web: node index.js
    ```

    wird zu:

    ```systemd squarecloud.app theme={null}
    MAIN=index.js
    MEMORY=512
    VERSION=recommended
    DISPLAY_NAME=My migrated app
    SUBDOMAIN=my-app
    ```

    Bei einem Worker-Prozesstyp lässt du `SUBDOMAIN` weg und setzt stattdessen `START` auf den Startbefehl deines Workers. Siehe die [Referenz zur Konfigurationsdatei](/de/getting-started/config-file) für alle Felder.
  </Step>

  <Step title="Setze deine Umgebungsvariablen">
    Exportiere deine Heroku Config Vars (`heroku config`) und setze dieselben Schlüssel auf Square Cloud, entweder über das Umgebungsvariablen-Panel im Dashboard oder durch Hochladen einer `.env`-Datei:

    ```bash theme={null}
    squarecloud app env set --from-file .env --app <appID>
    ```
  </Step>

  <Step title="Deployen">
    Lade dein Projekt über die CLI oder das Dashboard hoch:

    ```bash theme={null}
    squarecloud upload
    ```

    Siehe [So hostest du deine Website/API](/de/tutorials/how-to-deploy-your-website) für eine vollständige Anleitung zu beiden Methoden.
  </Step>

  <Step title="Richte deine DNS aus">
    Sobald die App unter `<subdomain>.squareweb.app` live ist, richte die DNS deiner Domain auf Square Cloud aus und hänge sie über die CLI an:

    ```bash theme={null}
    squarecloud app network domain example.com --app <appID>
    ```

    Benutzerdefinierte Domains erfordern einen aktiven Standard-Plan oder höher.
  </Step>
</Steps>

## Wichtige Unterschiede, die du einplanen solltest

* **Region und Latenz.** Das Rechenzentrum von Square Cloud befindet sich in New York — siehe den [Plattformüberblick](/de/platform/overview) für Infrastrukturdetails. Wenn sich die meisten deiner Nutzer in einer anderen Region als deine aktuelle Heroku-Dyno-Region befinden, miss die Latenz, bevor du umziehst.
* **Keine kostenlose Dyno-Stufe.** Square Cloud hat kein Äquivalent zu einem kostenlosen Dyno — ein aktiver kostenpflichtiger Plan ist erforderlich, um irgendeine Anwendung auszuführen. Siehe [Pläne und Preise](/de/platform/plans), um die richtige Stufe für deine Arbeitslast zu wählen.
* **Datenbanken ziehen separat um.** Heroku-Postgres-Daten zu migrieren bedeutet, sie zu exportieren (z. B. `pg_dump`) und in eine neue [von Square Cloud verwaltete Datenbank](/de/services/databases) wiederherzustellen — plane für die Umstellung ein Wartungsfenster ein.

## Kontaktiere uns

Falls du weiterhin **technische Schwierigkeiten** hast, steht dir unser **spezialisiertes Support-Team** zur Verfügung. [**Kontaktiere uns**](https://squarecloud.app/de/support) und wir helfen dir gerne, jedes Problem zu lösen — die Qualität unseres Supports ist ein wichtiger Grund, warum Entwickler Square Cloud mit [**4,9/5 bei 402 Bewertungen**](https://www.trustpilot.com/review/squarecloud.app) auf Google und Trustpilot bewerten.