> ## 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 Railway a Square Cloud

> Una guida pratica per spostare un progetto Railway su Square Cloud: mappatura della configurazione, passaggi di deploy e differenze chiave da pianificare.

## Perché gli sviluppatori migrano

Railway fattura in base all'utilizzo a consumo (CPU, RAM e rete consumate al secondo), quindi la fattura mensile si muove insieme al traffico ed è difficile da prevedere. Square Cloud adotta un approccio diverso:

* **Prezzi fissi e prevedibili in BRL** — un solo prezzo del piano per RAM, vCPU e storage Blob, indipendente da quanto traffico gestisce la tua app. 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.

## Mappatura dei concetti

| Railway                   | Square Cloud                                                                                                                   |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `railway.json` / Nixpacks | [File di configurazione `squarecloud.app`](/it/getting-started/config-file) + [Runtimes](/it/runtimes/introduction) automatici |
| Fatturazione a consumo    | [Prezzi del piano](/it/platform/plans) fissi mensili                                                                           |
| Plugin Postgres/Redis     | [Database gestiti di Square Cloud](/it/services/databases) (PostgreSQL, MySQL, MongoDB, Redis)                                 |
| Variabili d'ambiente      | Variabili d'ambiente, impostate nella dashboard o caricate da un file `.env`                                                   |
| `railway up`              | `squarecloud upload`                                                                                                           |
| Domini personalizzati     | Domini personalizzati sul [piano Standard o superiore](/it/platform/plans)                                                     |

## Passaggi di migrazione

<Steps>
  <Step title="Crea il tuo file di configurazione">
    Sostituisci il rilevamento tramite `railway.json`/Nixpacks con un file `squarecloud.app` nella root del tuo progetto:

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

    I [Runtimes](/it/runtimes/introduction) di Square Cloud rilevano automaticamente il tuo linguaggio da file come `package.json` o `requirements.txt`, gli stessi segnali su cui si basa Nixpacks. Consulta il [riferimento del file di configurazione](/it/getting-started/config-file) per ogni campo.
  </Step>

  <Step title="Imposta le tue variabili d'ambiente">
    Ricrea le variabili dalla scheda Variables del tuo progetto Railway, 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, al posto di `railway up`:

    ```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="Migra i plugin ai database gestiti">
    Se il tuo progetto usava un plugin Railway Postgres, MySQL o Redis, crea il [database gestito di Square Cloud](/it/services/databases) equivalente e punta la connection string della tua app verso di esso.
  </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

* **Modello di fatturazione.** Non c'è alcun contatore di utilizzo al secondo da monitorare — il costo è fisso per piano indipendentemente dal traffico. Dimensiona il tuo piano in base al fabbisogno di RAM/vCPU piuttosto che all'utilizzo previsto. Consulta [Piani e prezzi](/it/platform/plans).
* **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. Misura la latenza dalla tua base utenti prima del passaggio se stavi operando in una regione Railway diversa.
* **I database si spostano separatamente.** Migrare i dati di un plugin Railway Postgres/Redis significa esportarli 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.