Railway è una piattaforma infrastrutturale dove puoi fornire infrastruttura, sviluppare con quella infrastruttura localmente e poi distribuire nel cloud. Abilita deploy istantanei da GitHub con zero configurazione, SSL automatico e provisioning di database integrato.

Questa guida illustra il deploy di un'applicazione Bun con un database PostgreSQL (opzionale), che è esattamente ciò che il modello sottostante fornisce.

Puoi seguire questa guida passo-passo o semplicemente distribuire il modello preconfigurato con un clic:

---

Prerequisiti:

• Un'applicazione Bun pronta per la distribuzione
• Un account Railway
• Railway CLI (per il metodo di deploy CLI)
• Un account GitHub (per il metodo di deploy Dashboard)

---

Metodo 1: Distribuire tramite CLI

Passaggio 1

Assicurati di avere Railway CLI installato.

bun install -g @railway/cli

Passaggio 2

Accedi al tuo account Railway.

railway login

Passaggio 3

Dopo esserti autenticato con successo, inizializza un nuovo progetto.

railway init

Passaggio 4

Dopo aver inizializzato il progetto, aggiungi un nuovo database e servizio.

NOTE

Il Passaggio 4 è necessario solo se la tua applicazione usa un database. Se non hai bisogno di PostgreSQL, salta al Passaggio 5.

# Aggiungi il database PostgreSQL. Assicurati di aggiungerlo per primo!
railway add --database postgres

# Aggiungi il servizio della tua applicazione.
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

Passaggio 5

Dopo che i servizi sono stati creati e connessi, distribuisci l'applicazione su Railway. Per impostazione predefinita, i servizi sono accessibili solo all'interno della rete privata di Railway. Per rendere la tua app pubblicamente accessibile, devi generare un dominio pubblico.

# Distribuisci la tua applicazione
railway up

# Genera dominio pubblico
railway domain

La tua app è ora online! Railway esegue il deploy automatico ad ogni push su GitHub.

---

Metodo 2: Distribuire tramite Dashboard

Passaggio 1

Crea un nuovo progetto

1. Vai su Railway Dashboard
2. Clicca "+ New" → "GitHub repo"
3. Scegli il tuo repository

Passaggio 2

Aggiungi un database PostgreSQL e connetti questo database al servizio

NOTE

Il Passaggio 2 è necessario solo se la tua applicazione usa un database. Se non hai bisogno di PostgreSQL, salta al Passaggio 3.

1. Clicca "+ New" → "Database" → "Add PostgreSQL"
2. Dopo che il database è stato creato, seleziona il tuo servizio (non il database)
3. Vai alla scheda "Variables"
4. Clicca "+ New Variable" → "Add Reference"
5. Seleziona DATABASE_URL da postgres

Passaggio 3

Genera un dominio pubblico

1. Seleziona il tuo servizio
2. Vai alla scheda "Settings"
3. Sotto "Networking", clicca "Generate Domain"

La tua app è ora online! Railway esegue il deploy automatico ad ogni push su GitHub.

---

Configurazione (Opzionale)

Per impostazione predefinita, Railway usa Nixpacks per rilevare e costruire automaticamente la tua applicazione Bun con zero configurazione.

Tuttavia, usare il builder di applicazioni Railpack fornisce un supporto Bun migliore e supporterà sempre l'ultima versione di Bun. I modelli preconfigurati usano Railpack per impostazione predefinita.

Per abilitare Railpack in un progetto personalizzato, aggiungi quanto segue al tuo railway.json:

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

Per ulteriori impostazioni di configurazione della build, consulta la documentazione Railway.