Prerequisites for building and running the platform

Before you build or deploy MobilityManager, make sure your workstation or build agent has the required toolchain. This article lists the prerequisites for building from source and the options for running the result.

Build prerequisites

To compile the platform from source you need:

.NET 10 SDK — builds the API service and shared libraries.
Node.js 18+ and npm — builds the Angular 19 user interface that is bundled into the API.

The Angular UI is only compiled during Release builds or when you explicitly request it, so Node.js is not needed for fast Development-only backend builds.

Note: If you deploy a prebuilt container image instead of building from source, you do not need the .NET SDK or Node.js on the target host — only a container runtime such as Docker.

Verify your tools

Confirm the .NET SDK is installed:
```
dotnet --version
```
Confirm Node.js and npm are installed:
```
node --version
npm --version
```

Building the solution

Use the configuration that matches your goal:

Development (fast, no UI build):
```
dotnet build
```
Production (includes the Angular UI):
```
dotnet build -c Release
```
Force the UI build in Debug mode:
```
dotnet build /p:BuildAngularUI=true
```

Running for local development

The quickest path is Visual Studio 2022: open CK.MobilityManager.slnx, set CK.MobilityManager.AppHost as the startup project, and press F5. The Aspire AppHost starts PostgreSQL, the API service, and the Angular UI with hot reload.

From the command line, provide a database password and run the AppHost:

$env:Parameters__postgres-password="DevPassword123!"
dotnet run --project src/CK.MobilityManager.AppHost

You can also run the API on its own (serving the bundled UI) with dotnet run --project src/CK.MobilityManager.ApiService, or run the Angular dev server separately from src/web/UI with npm start for hot-reload UI work.

Container and cluster runtimes

For containerised deployments you additionally need:

Docker with Compose v2 for the Docker Compose stacks.
kubectl (with Kustomize built in) for Kubernetes deployments.

Tip: PostgreSQL is the recommended local database, especially on ARM-based machines. SQL Server remains fully supported for teams that already run it.

Deployment architecture overview
Choosing between PostgreSQL and SQL Server
Using the LocalDatabase provider mode
Running the platform with Docker Compose for development

Written by Alexander Hagemann

Updated: