Railway é uma plataforma de infraestrutura onde você pode provisionar infraestrutura, desenvolver com essa infraestrutura localmente e depois implantar na nuvem. Ele permite implantações instantâneas do GitHub com configuração zero, SSL automático e provisionamento de banco de dados embutido.

Este guia mostra como implantar uma aplicação Bun com um banco de dados PostgreSQL (opcional), que é exatamente o que o modelo abaixo fornece.

Você pode seguir este guia passo a passo ou simplesmente implantar o modelo pré-configurado com um clique:

---

Pré-requisitos:

• Uma aplicação Bun pronta para implantação
• Uma conta Railway
• Railway CLI (para método de implantação via CLI)
• Uma conta GitHub (para método de implantação via Dashboard)

---

Método 1: Implantar via CLI

Passo 1

Certifique-se de ter o Railway CLI instalado.

bun install -g @railway/cli

Passo 2

Faça login na sua conta Railway.

railway login

Passo 3

Após autenticar com sucesso, inicialize um novo projeto.

railway init

Passo 4

Após inicializar o projeto, adicione um novo banco de dados e serviço.

NOTE

O Passo 4 só é necessário se sua aplicação usar um banco de dados. Se você não precisar do PostgreSQL, vá para o Passo 5.

# Adicione o banco de dados PostgreSQL. Certifique-se de adicionar este primeiro!
railway add --database postgres

# Adicione o serviço da sua aplicação.
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

Passo 5

Após os serviços serem criados e conectados, implante a aplicação no Railway. Por padrão, os serviços são acessíveis apenas dentro da rede privada do Railway. Para tornar sua aplicação acessível publicamente, você precisa gerar um domínio público.

# Implante sua aplicação
railway up

# Gere domínio público
railway domain

Sua aplicação está agora online! O Railway faz auto-deploy a cada push no GitHub.

---

Método 2: Implantar via Dashboard

Passo 1

Crie um novo projeto

1. Vá para Railway Dashboard
2. Clique em "+ New" → "GitHub repo"
3. Escolha seu repositório

Passo 2

Adicione um banco de dados PostgreSQL e conecte este banco de dados ao serviço

NOTE

O Passo 2 só é necessário se sua aplicação usar um banco de dados. Se você não precisar do PostgreSQL, vá para o Passo 3.

1. Clique em "+ New" → "Database" → "Add PostgreSQL"
2. Após o banco de dados ser criado, selecione seu serviço (não o banco de dados)
3. Vá para a aba "Variables"
4. Clique em "+ New Variable" → "Add Reference"
5. Selecione DATABASE_URL do postgres

Passo 3

Gere um domínio público

1. Selecione seu serviço
2. Vá para a aba "Settings"
3. Em "Networking", clique em "Generate Domain"

Sua aplicação está agora online! O Railway faz auto-deploy a cada push no GitHub.

---

Configuração (Opcional)

Por padrão, o Railway usa Nixpacks para detectar e buildar automaticamente sua aplicação Bun com configuração zero.

No entanto, usar o builder de aplicação Railpack fornece melhor suporte ao Bun e sempre suportará a versão mais recente do Bun. Os modelos pré-configurados usam Railpack por padrão.

Para habilitar Railpack em um projeto personalizado, adicione o seguinte ao seu railway.json:

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

Para mais configurações de build, consulte a documentação do Railway.