Railway est une plateforme d'infrastructure où vous pouvez provisionner de l'infrastructure, développer avec cette infrastructure localement, puis déployer dans le cloud. Elle permet des déploiements instantanés depuis GitHub avec zéro configuration, SSL automatique et provisionnement de base de données intégré.

Ce guide explique comment déployer une application Bun avec une base de données PostgreSQL (optionnelle), ce qui est exactement ce que fournit le modèle ci-dessous.

Vous pouvez soit suivre ce guide étape par étape, soit simplement déployer le modèle préconfiguré en un clic :

---

Prérequis :

• Une application Bun prête à être déployée
• Un compte Railway
• Railway CLI (pour la méthode de déploiement CLI)
• Un compte GitHub (pour la méthode de déploiement via le tableau de bord)

---

Méthode 1 : Déployer via CLI

Étape 1

Assurez-vous d'avoir installé Railway CLI.

bun install -g @railway/cli

Étape 2

Connectez-vous à votre compte Railway.

railway login

Étape 3

Après vous être authentifié avec succès, initialisez un nouveau projet.

railway init

Étape 4

Après avoir initialisé le projet, ajoutez une nouvelle base de données et un nouveau service.

NOTE

L'étape 4 n'est nécessaire que si votre application utilise une base de données. Si vous n'avez pas besoin de PostgreSQL, passez à l'étape 5.

# Ajouter la base de données PostgreSQL. Assurez-vous de l'ajouter en premier !
railway add --database postgres

# Ajouter votre service d'application.
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

Étape 5

Après que les services ont été créés et connectés, déployez l'application sur Railway. Par défaut, les services sont uniquement accessibles au sein du réseau privé de Railway. Pour rendre votre application accessible publiquement, vous devez générer un domaine public.

# Déployer votre application
railway up

# Générer un domaine public
railway domain

Votre application est maintenant en ligne ! Railway redéploie automatiquement à chaque push GitHub.

---

Méthode 2 : Déployer via le tableau de bord

Étape 1

Créer un nouveau projet

1. Allez sur le tableau de bord Railway
2. Cliquez sur "+ New" → "GitHub repo"
3. Choisissez votre dépôt

Étape 2

Ajouter une base de données PostgreSQL et connecter cette base de données au service

NOTE

L'étape 2 n'est nécessaire que si votre application utilise une base de données. Si vous n'avez pas besoin de PostgreSQL, passez à l'étape 3.

1. Cliquez sur "+ New" → "Database" → "Add PostgreSQL"
2. Après que la base de données a été créée, sélectionnez votre service (pas la base de données)
3. Allez dans l'onglet "Variables"
4. Cliquez sur "+ New Variable" → "Add Reference"
5. Sélectionnez DATABASE_URL depuis postgres

Étape 3

Générer un domaine public

1. Sélectionnez votre service
2. Allez dans l'onglet "Settings"
3. Sous "Networking", cliquez sur "Generate Domain"

Votre application est maintenant en ligne ! Railway redéploie automatiquement à chaque push GitHub.

---

Configuration (Optionnel)

Par défaut, Railway utilise Nixpacks pour détecter et build automatiquement votre application Bun avec zéro configuration.

Cependant, utiliser le constructeur d'application Railpack fournit une meilleure prise en charge de Bun et prendra toujours en charge la dernière version de Bun. Les modèles préconfigurés utilisent Railpack par défaut.

Pour activer Railpack dans un projet personnalisé, ajoutez ce qui suit à votre railway.json :

{
  "$schema": "https://railway.com/railway.schema.json",
  "build": {
    "builder": "RAILPACK"
  }
}

Pour plus de paramètres de configuration de build, consultez la documentation Railway.