Operating

Day-to-day operations for the Finaisse/Blitz platform.

Useful Commands

All commands run from the railway/ directory in fin-infra:

bun run status          # Show deployment status of all services
bun run logs            # View service logs (all)
bun run logs -- --service blitz-api   # Logs for a specific service
bun run deploy:all      # Redeploy all services
bun run vars:sync       # Push environment variables to Railway services

Checking Service Health

bun run status

Also check the Railway dashboard at railway.app — the Deployments tab shows health check status per service.

Viewing Logs

# All services
bun run logs

# Specific service
bun run logs -- --service blitz-api
bun run logs -- --service ws
bun run logs -- --service wfw

Scaling Staging Up/Down

Staging auto-scales down every night at 10:30 PM IST (cost saving) via the scheduled scale-staging.yml workflow. To scale back up in the morning — or scale down early:

Via GitHub Actions (recommended):

1. Go to fin-infra Actions
2. Select Scale Staging
3. Run workflow → choose up or down and the target (all / backend / frontend / infra)

Workflow	Trigger	Purpose
scale-staging.yml	Manual + daily schedule	Scale staging up/down; auto-downs at 10:30 PM IST

Via terminal:

bun run scale up all      # Scale everything back up
bun run scale down all    # Scale everything down

Pushing a Variable Change

1. Edit railway/shared/variables.ts in fin-infra
2. Run bun run vars:sync to push to all backend services
3. Services may need redeployment to pick up the new values: bun run deploy:backend

Provisioning

To provision or re-provision infrastructure:

bun run provision:dry       # Preview what would change
bun run provision           # Provision everything (idempotent)
bun run provision:infra     # Infra only (Postgres, RustFS, Valkey, Temporal)
bun run provision:services  # Microservices + frontend only

Initialising a New Database

Run once when setting up a new environment:

bun run init-db    # Creates finance and mgmt databases

Key External Links

Resource	URL
Staging app (frontend)	https://letsgo.finaisse.com
Railway dashboard	https://railway.app
GitHub Actions	https://github.com/finaisse-org/fin-infra/actions
GHCR images	https://github.com/orgs/finaisse-org/packages
Internal docs	https://internal-docs.finaisse.com

Staging backends (blitz-api, ws, wfw, …) are private on *.railway.internal — no public URL; the frontend's nginx proxies /api to them.

Incidents

See the Incident Response Runbook.