Railway es una plataforma de infraestructura donde puedes aprovisionar infraestructura, desarrollar con esa infraestructura localmente y luego desplegar en la nube. Permite despliegues instantáneos desde GitHub con configuración cero, SSL automático y aprovisionamiento de bases de datos integrado.

Esta guía explica cómo desplegar una aplicación Bun con una base de datos PostgreSQL (opcional), que es exactamente lo que proporciona la plantilla a continuación.

Puedes seguir esta guía paso a paso o simplemente desplegar la plantilla preconfigurada con un clic:

---

Prerrequisitos:

• Una aplicación Bun lista para desplegar
• Una cuenta de Railway
• Railway CLI (para el método de despliegue CLI)
• Una cuenta de GitHub (para el método de despliegue Dashboard)

---

Método 1: Desplegar vía CLI

Paso 1

Asegúrate de tener instalada la CLI de Railway.

bun install -g @railway/cli

Paso 2

Inicia sesión en tu cuenta de Railway.

railway login

Paso 3

Después de autenticarte correctamente, inicializa un nuevo proyecto.

railway init

Paso 4

Después de inicializar el proyecto, agrega una nueva base de datos y servicio.

NOTE

El Paso 4 solo es necesario si tu aplicación usa una base de datos. Si no necesitas PostgreSQL, salta al Paso 5.

# Agregar base de datos PostgreSQL. ¡Asegúrate de agregar esto primero!
railway add --database postgres

# Agregar tu servicio de aplicación.
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

Paso 5

Después de que se hayan creado y conectado los servicios, despliega la aplicación en Railway. Por defecto, los servicios solo son accesibles dentro de la red privada de Railway. Para hacer tu aplicación accesible públicamente, necesitas generar un dominio público.

# Desplegar tu aplicación
railway up

# Generar dominio público
railway domain

¡Tu aplicación está ahora en vivo! Railway auto-despliega en cada push a GitHub.

---

Método 2: Desplegar vía Dashboard

Paso 1

Crear un nuevo proyecto

1. Ve al Panel de Railway
2. Haz clic en "+ New" → "GitHub repo"
3. Elige tu repositorio

Paso 2

Agregar una base de datos PostgreSQL y conectar esta base de datos al servicio

NOTE

El Paso 2 solo es necesario si tu aplicación usa una base de datos. Si no necesitas PostgreSQL, salta al Paso 3.

1. Haz clic en "+ New" → "Database" → "Add PostgreSQL"
2. Después de que se haya creado la base de datos, selecciona tu servicio (no la base de datos)
3. Ve a la pestaña "Variables"
4. Haz clic en "+ New Variable" → "Add Reference"
5. Selecciona DATABASE_URL desde postgres

Paso 3

Generar un dominio público

1. Selecciona tu servicio
2. Ve a la pestaña "Settings"
3. En "Networking", haz clic en "Generate Domain"

¡Tu aplicación está ahora en vivo! Railway auto-despliega en cada push a GitHub.

---

Configuración (Opcional)

Por defecto, Railway usa Nixpacks para detectar y construir automáticamente tu aplicación Bun con configuración cero.

Sin embargo, usar el constructor de aplicaciones Railpack proporciona mejor soporte para Bun y siempre soportará la última versión de Bun. Las plantillas preconfiguradas usan Railpack por defecto.

Para habilitar Railpack en un proyecto personalizado, agrega lo siguiente a tu railway.json:

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

Para más configuraciones de construcción, consulta la documentación de Railway.