Top-Level Settings

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

Application Settings

json

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

Settings Reference

Setting	Type	Default	Description
ApplicationName	string	null	Application identifier. Defaults to the top-level directory name if not set.
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 displayed on startup. Supports placeholders.

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