Deployment

Self-Hosted (Docker Compose)

You can easily host the backend services (Auth Service, Backend, Database, Cache) yourself using Docker Compose.

Prerequisites

• Docker
• Docker Compose

Configuration

Use the docker-compose.yml from the repository.

Running the Stack

1. Start the services:

   # Start services in detached mode
   docker-compose up -d

2. The services (and databases) will be available at:

   • Auth Service: http://localhost:8080
   • Backend: http://localhost:9000

Railway

BudgetBuddyDE is designed to be easily deployable on Railway.

Instance configuration

It is possible to configure the runtime of a service in the Railway cloud using railway.json files. These are located in the directory of a service or an app. The Railway documentation offers some help regarding the possible configuration options...

• Railway Docs: Using Config as Code
• Railway Docs: Using Config as Code -> Configurable settings

{
   "$schema": "https://railway.com/railway.schema.json",
   "build": {
      "builder": "NIXPACKS",
      "buildCommand": "echo building!"
   },
   "deploy": {
      "preDeployCommand": ["npm run db:migrate"],
      "startCommand": "echo starting!",
      "healthcheckPath": "/",
      "healthcheckTimeout": 100,
      "restartPolicyType": "never"
   }
}