Skip to content

Getting Started

Hosted Instance

A hosted instance of this server is available at https://udap-security.fast.hl7.org.

This guide is for running the server locally for development or testing purposes.

Requirements

To run the server locally, you will need:

  • .NET 9 SDK - Required
  • Microsoft SQL Server - Optional (SQLite is used by default)
  • Python 3.x - Optional (for building documentation)

To run the server in a container, you will need a container manager such as:

Starting the Server Locally

Run the server from the root directory of the project:

Start the server
dotnet run --project IdentityServer/IdentityServer.csproj

Server Started

The server will start on https://localhost:5001 by default.

Development Certificates

First Time Setup

If this is your first time running the server, you'll likely need to create and trust a development certificate.

Create the certificate:

Generate dev certificate
dotnet dev-certs https

Trust the certificate:

Trust the certificate
dotnet dev-certs https --trust

Learn More

For more information on development certificates, see the .NET documentation.

Running in a Container

You can also run the server in a container.

Container Manager Compatibility

These instructions use Docker, but should work with other OCI-compatible container managers like Podman.

The easiest way to run the server is using Docker Compose:

Start with Docker Compose
docker compose up

This will use the pre-built image from Docker Hub and start the server with all necessary configuration.

Pull and run the pre-built image directly:

Run pre-built container
docker run -p 5001:443 -e ASPNETCORE_URLS="https://+:443" hlseven/fast-udap-security

The server will be available at https://localhost:5001.

Build the Docker image from source:

Build Docker image
docker build -f IdentityServer/Dockerfile -t fast-security .

Then run your locally-built image:

Run local container
docker run -p 5001:443 fast-security