How to Host a .NET Application on Vertra Cloud

​

Requirements

• .NET SDK 10 installed locally
• Account on Vertra Cloud
• An ASP.NET Core or console project with a .csproj

​

Project Structure

my-server-dotnet/
├── Program.cs
├── MyServer.csproj
└── vertracloud.config

​

Configuration

​

MyServer.csproj

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

</Project>

​

vertracloud.config

MAIN=MyServer.csproj
VERSION=recommended

​

Example: Minimal API

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => Results.Json(new { message = ".NET on Vertra Cloud", version = "1.0.0" }));
app.MapGet("/health", () => Results.Json(new { status = "healthy", service = "dotnet-api" }));

app.Run();

​

Deploy

vertra deploy
vertra logs -f

​

Available Versions

​

Notes

• Build: the project is published with dotnet publish in Release mode during deployment, so the first deploy can take a few minutes. Give the build enough memory
• Exclude from the zip: bin and obj folders
• Environment variables: read them with Environment.GetEnvironmentVariable("KEY") or through builder.Configuration
• Logging: use ILogger or Console.WriteLine() for logs that appear in real time
• Keep TargetFramework at net10.0

​

Common Errors

• Project file not found: MAIN must point to the .csproj, relative to the root of the zip.
• Site doesn’t open: the app must listen on the port in ASPNETCORE_HTTP_PORTS (80). Remove any port you hardcoded in code, so the app follows ASPNETCORE_HTTP_PORTS.
• Build runs out of memory: raise the application’s memory and deploy again. See Common Errors.