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

# Migre do Railway para a Square Cloud

> Um guia prático para migrar um projeto do Railway para a Square Cloud: mapeamento de configuração, passos de deploy e principais diferenças a considerar.

## Por que desenvolvedores migram

O Railway cobra por uso medido (CPU, RAM e rede consumidos por segundo), então a fatura mensal se move com o tráfego e pode ser difícil de prever. A Square Cloud adota uma abordagem diferente:

* **Preço fixo e previsível em BRL** — o preço de um único plano para RAM, vCPU e armazenamento Blob, independente de quanto tráfego sua aplicação recebe. Veja [Planos e Preços](/pt-br/platform/plans).
* **Recursos dedicados** — RAM e vCPU são reservados para sua aplicação, não capacidade compartilhada de melhor esforço.
* **Deploy em segundos** — envie um zip ou faça push via CLI e sua aplicação está rodando.

## Mapeamento de conceitos

| Railway                   | Square Cloud                                                                                                                           |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `railway.json` / Nixpacks | [Arquivo de configuração `squarecloud.app`](/pt-br/getting-started/config-file) + [Runtimes](/pt-br/runtimes/introduction) automáticos |
| Cobrança baseada em uso   | [Preço fixo mensal por plano](/pt-br/platform/plans)                                                                                   |
| Plugins Postgres/Redis    | [Bancos de dados gerenciados da Square Cloud](/pt-br/services/databases) (PostgreSQL, MySQL, MongoDB, Redis)                           |
| Variáveis de ambiente     | Variáveis de ambiente, definidas no dashboard ou enviadas de um arquivo `.env`                                                         |
| `railway up`              | `squarecloud upload`                                                                                                                   |
| Domínios personalizados   | Domínios personalizados no [plano Standard ou superior](/pt-br/platform/plans)                                                         |

## Passos de migração

<Steps>
  <Step title="Crie seu arquivo de configuração">
    Substitua a detecção do `railway.json`/Nixpacks por um arquivo `squarecloud.app` na raiz do seu projeto:

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

    Os [Runtimes](/pt-br/runtimes/introduction) da Square Cloud detectam sua linguagem automaticamente a partir de arquivos como `package.json` ou `requirements.txt`, os mesmos sinais que o Nixpacks usa. Veja a [referência do arquivo de configuração](/pt-br/getting-started/config-file) para todos os campos.
  </Step>

  <Step title="Defina suas variáveis de ambiente">
    Recrie as variáveis da aba Variables do seu projeto no Railway, seja pelo painel de variáveis de ambiente do dashboard ou enviando um arquivo `.env`:

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

  <Step title="Faça o deploy">
    Envie seu projeto pela CLI ou pelo dashboard, no lugar de `railway up`:

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

    Veja [Como Hospedar seu Site/API](/pt-br/tutorials/how-to-deploy-your-website) para um passo a passo completo dos dois métodos.
  </Step>

  <Step title="Migre plugins para bancos de dados gerenciados">
    Se seu projeto usava um plugin Postgres, MySQL ou Redis do Railway, provisione o [banco de dados gerenciado da Square Cloud](/pt-br/services/databases) equivalente e aponte a connection string da sua aplicação para ele.
  </Step>

  <Step title="Aponte seu DNS">
    Assim que a aplicação estiver no ar em `<subdominio>.squareweb.app`, aponte o DNS do seu domínio para a Square Cloud e vincule-o pela CLI:

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

    Domínios personalizados exigem um plano Standard ativo ou superior.
  </Step>
</Steps>

## Principais diferenças a considerar

* **Modelo de cobrança.** Não há um medidor de uso por segundo para acompanhar — o custo é fixo por plano independente do tráfego. Dimensione seu plano pela necessidade de RAM/vCPU em vez do uso projetado. Veja [Planos e Preços](/pt-br/platform/plans).
* **Região e latência.** O data center da Square Cloud fica localizado em Nova Iorque — veja a [Visão Geral da Plataforma](/pt-br/platform/overview) para detalhes de infraestrutura. Meça a latência a partir da sua base de usuários antes de migrar se você rodava em uma região diferente do Railway.
* **Bancos de dados migram separadamente.** Migrar dados de um plugin Postgres/Redis do Railway significa exportá-los e restaurá-los em um novo [banco de dados gerenciado da Square Cloud](/pt-br/services/databases) — planeje uma janela de manutenção para a transição.

## Contate-nos

Se você continuar enfrentando **dificuldades técnicas**, nossa **equipe de suporte especializada** está disponível para auxiliá-lo. [**Entre em contato conosco**](https://squarecloud.app/pt-br/support) e teremos prazer em ajudá-lo a resolver qualquer questão — a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com [**4.9/5 em 402 avaliações**](https://www.trustpilot.com/review/squarecloud.app) no Google e Trustpilot.