Skip to content

Local Development

This page is for contributors running SecureObs locally.

Prerequisites

  • Docker
  • .NET 8 SDK
  • Node.js 20 LTS
  • Optional: Azure CLI for infrastructure deployment work

Start The API And Database

From the repository root:

cp .env.example .env
docker compose up --build

This starts:

Service URL
API http://localhost:8080
PostgreSQL localhost:5432

Health probes:

  • http://localhost:8080/health/live
  • http://localhost:8080/health/ready

Start The Dashboard

cd SecureObs.Dashboard
npm ci
npm start

The dashboard runs at http://localhost:4200.

Run Tests

dotnet test

Frontend build:

cd SecureObs.Dashboard
npm run build

PostgreSQL-backed tests require Docker because they use Testcontainers.