> ## 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.

# Migrare da Heroku a Square Cloud

> Una guida pratica per spostare un'applicazione web, worker o API da Heroku a Square Cloud: mappatura della configurazione, passaggi di deploy e differenze chiave da pianificare.

## Perché gli sviluppatori migrano

Il modello a dyno di Heroku fattura separatamente ore di calcolo e add-on, rendendo il costo mensile difficile da prevedere man mano che un'app cresce. Square Cloud adotta un approccio diverso:

* **Prezzi fissi e prevedibili in BRL** — un solo prezzo del piano copre RAM, vCPU e storage Blob, senza fatture per add-on a consumo che si sommano sopra. Consulta [Piani e prezzi](/it/platform/plans).
* **Risorse dedicate** — RAM e vCPU sono riservate alla tua applicazione, non capacità condivisa best-effort.
* **Deploy in pochi secondi** — carica uno zip o effettua il push tramite CLI e la tua applicazione è in esecuzione, senza coda di build.

## Mappatura dei concetti

| Heroku                                         | Square Cloud                                                                                                 |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `Procfile` (tipi di processo `web:`/`worker:`) | [File di configurazione `squarecloud.app`](/it/getting-started/config-file) — campi `MAIN`/`START`           |
| Buildpack                                      | [Runtimes](/it/runtimes/introduction) — rilevamento automatico del linguaggio, nessun buildpack da scegliere |
| Config Vars                                    | Variabili d'ambiente, impostate nella dashboard o caricate da un file `.env`                                 |
| Heroku Postgres                                | [Database gestiti di Square Cloud](/it/services/databases) (PostgreSQL, MySQL, MongoDB, Redis)               |
| `heroku logs --tail`                           | Log della dashboard, oppure `squarecloud app logs` dalla CLI                                                 |
| Domini personalizzati (dyno a pagamento)       | Domini personalizzati sul [piano Standard o superiore](/it/platform/plans)                                   |

## Passaggi di migrazione

<Steps>
  <Step title="Crea il tuo file di configurazione">
    Sostituisci il tuo `Procfile` con un file `squarecloud.app` nella root del tuo progetto. Un `Procfile` Heroku come questo:

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

    diventa:

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

    Per un tipo di processo worker, rimuovi `SUBDOMAIN` e imposta invece `START` con il comando di avvio del tuo worker. Consulta il [riferimento del file di configurazione](/it/getting-started/config-file) per ogni campo.
  </Step>

  <Step title="Imposta le tue variabili d'ambiente">
    Esporta le tue Config Vars di Heroku (`heroku config`) e imposta le stesse chiavi su Square Cloud, sia dal pannello delle variabili d'ambiente della dashboard sia caricando un file `.env`:

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

  <Step title="Effettua il deploy">
    Carica il tuo progetto tramite la CLI o la dashboard:

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

    Consulta [Come ospitare il tuo sito web/API](/it/tutorials/how-to-deploy-your-website) per una panoramica completa di entrambi i metodi.
  </Step>

  <Step title="Punta il tuo DNS">
    Una volta che l'app è online su `<subdomain>.squareweb.app`, punta il DNS del tuo dominio verso Square Cloud e collegalo dalla CLI:

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

    I domini personalizzati richiedono un piano Standard o superiore attivo.
  </Step>
</Steps>

## Differenze chiave da pianificare

* **Regione e latenza.** Il data center di Square Cloud si trova a New York — consulta la [Panoramica della piattaforma](/it/platform/overview) per i dettagli sull'infrastruttura. Se la maggior parte dei tuoi utenti si trova in una regione diversa dalla tua attuale regione dyno Heroku, misura la latenza prima del passaggio.
* **Nessun livello dyno gratuito.** Square Cloud non ha un equivalente dyno gratuito — è richiesto un piano a pagamento attivo per eseguire qualsiasi applicazione. Consulta [Piani e prezzi](/it/platform/plans) per scegliere il livello adatto al tuo carico di lavoro.
* **I database si spostano separatamente.** Migrare i dati di Heroku Postgres significa esportarli (ad esempio con `pg_dump`) e ripristinarli in un nuovo [database gestito di Square Cloud](/it/services/databases) — pianifica una finestra di manutenzione per il passaggio.

## Contattaci

Se continui a riscontrare **difficoltà tecniche**, il nostro **team di supporto specializzato** è disponibile ad assisterti. [**Contattaci**](https://squarecloud.app/it/support) e saremo felici di aiutarti a risolvere qualsiasi problema — la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud [**4,9/5 su 402 recensioni**](https://www.trustpilot.com/review/squarecloud.app) su Google e Trustpilot.