Top-Level Settings

These settings configure the application identity, server binding, and configuration behavior.

Overview

json

{
  "ApplicationName": null,
  "EnvironmentName": "Production",
  "Urls": "http://localhost:8080",
  "StartupMessage": "Started in {time}, listening on {urls}, version {version}"
}

Application Settings

Setting	Type	Default	Description
ApplicationName	string	null	Application identifier. Defaults to the name of the current working directory if not set. Also used as the connection ApplicationName (see Connection Settings).
EnvironmentName	string	"Production"	Environment designation (Development, Staging, Production).
Urls	string	"http://localhost:8080"	Server listening URLs. Separate multiple URLs with semicolons.
StartupMessage	string	(see below)	Message logged at Information level on startup. Supports placeholders; set to an empty string to disable.

Default StartupMessage: "Started in {time}, listening on {urls}, version {version}"

Urls Configuration

The Urls setting accepts multiple URLs separated by semicolons:

json

{
  "Urls": "http://localhost:8080;https://localhost:8443"
}

To listen on all interfaces:

json

{
  "Urls": "http://0.0.0.0:8080;https://0.0.0.0:8443"
}

Startup Message Placeholders

Customize the startup message with these placeholders:

Placeholder	Description
{time}	Startup time
{urls}	Listening URLs
{version}	Application version
{environment}	Environment name (from EnvironmentName)
{application}	Application name (from ApplicationName)

Example:

json

{
  "StartupMessage": "Started in {time}, listening on {urls}, version {version}, env: {environment}"
}

Related

• Config Section - Configuration file processing settings
• Comment Annotations Guide - How annotations work
• Configuration Guide - How configuration sources work

Next Steps

• Connection Settings - Database connection strings
• Server & SSL - Kestrel and HTTPS configuration