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

# Migrer de Railway vers Square Cloud

> Un guide pratique pour déplacer un projet Railway vers Square Cloud : correspondance de configuration, étapes de déploiement et différences clés à anticiper.

## Pourquoi les développeurs migrent

Railway facture à l'usage mesuré (CPU, RAM et réseau consommés par seconde), donc la facture mensuelle évolue avec le trafic et peut être difficile à prévoir. Square Cloud adopte une approche différente :

* **Tarification forfaitaire prévisible en BRL** : un seul prix de plan pour la RAM, le vCPU et le stockage Blob, indépendamment du trafic géré par votre application. Consultez [Plans et tarifs](/fr/platform/plans).
* **Ressources dédiées** : la RAM et le vCPU sont réservés à votre application, pas une capacité partagée au mieux.
* **Déploiement en quelques secondes** : envoyez un zip ou poussez via la CLI et votre application est en ligne.

## Correspondance des concepts

| Railway                   | Square Cloud                                                                                                                       |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `railway.json` / Nixpacks | [Fichier de configuration `squarecloud.app`](/fr/getting-started/config-file) + [Runtimes](/fr/runtimes/introduction) automatiques |
| Facturation à l'usage     | [Tarification forfaitaire](/fr/platform/plans) mensuelle par plan                                                                  |
| Plugins Postgres/Redis    | [Bases de données gérées Square Cloud](/fr/services/databases) (PostgreSQL, MySQL, MongoDB, Redis)                                 |
| Variables d'environnement | Variables d'environnement, définies dans le tableau de bord ou envoyées depuis un fichier `.env`                                   |
| `railway up`              | `squarecloud upload`                                                                                                               |
| Domaines personnalisés    | Domaines personnalisés sur le [plan Standard ou supérieur](/fr/platform/plans)                                                     |

## Étapes de migration

<Steps>
  <Step title="Créez votre fichier de configuration">
    Remplacez la détection `railway.json`/Nixpacks par un fichier `squarecloud.app` à la racine de votre projet :

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

    Les [Runtimes](/fr/runtimes/introduction) de Square Cloud détectent automatiquement votre langage à partir de fichiers comme `package.json` ou `requirements.txt`, les mêmes signaux sur lesquels s'appuie Nixpacks. Consultez la [référence du fichier de configuration](/fr/getting-started/config-file) pour tous les champs.
  </Step>

  <Step title="Configurez vos variables d'environnement">
    Recréez les variables depuis l'onglet Variables de votre projet Railway, soit depuis le panneau de variables d'environnement du tableau de bord, soit en envoyant un fichier `.env` :

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

  <Step title="Déployez">
    Envoyez votre projet via la CLI ou le tableau de bord, à la place de `railway up` :

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

    Consultez [Comment héberger votre site web/API](/fr/tutorials/how-to-deploy-your-website) pour un guide complet des deux méthodes.
  </Step>

  <Step title="Migrez les plugins vers des bases de données gérées">
    Si votre projet utilisait un plugin Railway Postgres, MySQL ou Redis, provisionnez la [base de données gérée Square Cloud](/fr/services/databases) équivalente et pointez la chaîne de connexion de votre application vers celle-ci.
  </Step>

  <Step title="Pointez votre DNS">
    Une fois l'application en ligne à `<subdomain>.squareweb.app`, pointez le DNS de votre domaine vers Square Cloud et attachez-le depuis la CLI :

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

    Les domaines personnalisés nécessitent un plan Standard actif ou supérieur.
  </Step>
</Steps>

## Différences clés à anticiper

* **Modèle de facturation.** Il n'y a pas de compteur d'usage à la seconde à surveiller, le coût est fixe par plan, quel que soit le trafic. Dimensionnez votre plan selon vos besoins en RAM/vCPU plutôt que selon l'usage projeté. Consultez [Plans et tarifs](/fr/platform/plans).
* **Région et latence.** Le centre de données de Square Cloud est situé à New York, consultez la [vue d'ensemble de la plateforme](/fr/platform/overview) pour les détails d'infrastructure. Mesurez la latence depuis votre base d'utilisateurs avant de basculer si vous tourniez dans une région Railway différente.
* **Les bases de données se déplacent séparément.** Migrer les données d'un plugin Railway Postgres/Redis implique de les exporter et de les restaurer dans une nouvelle [base de données gérée Square Cloud](/fr/services/databases), prévoyez une fenêtre de maintenance pour la bascule.

## Contactez-nous

Si vous rencontrez toujours des **difficultés techniques**, notre **équipe de support spécialisée** est disponible pour vous aider. [**Contactez-nous**](https://squarecloud.app/fr/support) et nous serons ravis de vous aider à résoudre tout problème. La qualité du support compte pour beaucoup dans la note que les développeurs donnent à Square Cloud, [**4,9/5 sur 402 avis**](https://www.trustpilot.com/review/squarecloud.app) sur Google et Trustpilot.