Configure .NET on TurboStack

Enable the .NET runtime for an application on TurboStack, pick a version, and optionally set a custom listen port for the app behind nginx.

Enable the .NET runtime for an application, choose a version, and let TurboStack run your app as a service behind nginx.

The .NET panel under Configure application > Technologies, enabled, showing the version selector and the Listen Port option defaulting to 5000
The .NET panel under Configure application > Technologies, enabled, showing the version selector and the Listen Port option defaulting to 5000

Where to configure it

.NET is configured per application. Open your host, go to an application's Configure application > Technologies > .NET, enable it, and select the runtime version. Saving updates the host YAML, provisions the runtime, and wires up the Nginx reverse proxy in front of your app.

YAML configuration

Required

Key Meaning
dotnet_version The .NET runtime version to install, for example "8.0" (or newer). Setting this key is what enables the .NET runtime for the application; there is no separate enable key.

Optional

Key Meaning
dotnet_port_enabled Set to true to use a custom local listen port instead of the default.
dotnet.listen_port The local port your app listens on, which Nginx forwards to. Defaults to 5000.
dotnet_version: "8.0"

# Optional: run the app on a custom local port behind nginx
dotnet_port_enabled: true
dotnet:
  listen_port: 5000