Aspire

Why developers choose Aspire

Code-centric control

Define your stack in code—type-safe and readable. Run locally, deploy anywhere without architectural changes.

Modular and extensible

Orchestrate frontends, APIs, containers, and databases with zero rewrites. Extend Aspire to fit your stack—deploy anywhere.

Observability from the start

Built-in OpenTelemetry delivers logs, traces, and health checks automatically—debug faster with zero setup.

Flexible deployments

Deploy anywhere—Kubernetes, cloud, or on-prem. Aspire adapts to your environment for consistent deployments without rewrites.

Your coding agents, supercharged

Aspire is the control plane for agentic dev. AI agents use your app model to understand, build, and operate your entire stack.

Get started quickly

Install the Aspire CLI, run aspire init in your repo, and fuel your agents with aspire agent init.

Define your stack in code

Aspire is modular, composable, and extensible. Configure relationships, deployment options, and dev-time flags in one place. Learn more about the AppHost.

Build your AppHost

Toggle different features on/off to see how Aspire defines different parts of your stack.

C#TypeScript

Front endDatabaseAPI serviceContainerDeployment options

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// This would be a rather boring AppHost ☹️...
// Toggle the options above to see what an AppHost might look like.
// For example, select "Front end" to add a frontend service.

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
    .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
    .WithHttpEndpoint(env: "PORT")
    .WithReference(api)
    .WithNpmPackageInstallation()
    .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .PublishAsAzureContainerApp();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddAzurePostgresFlexibleServer("db")
    .AddDatabase("appdata")
    .WithDataVolume()
    .RunAsContainer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
    .WithReference(postgres)
    .WaitFor(postgres)
    .PublishAsAzureContainerApp();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .WithHttpEndpoint(targetPort: 8080)
    .PublishAsKubernetes();

builder.Build().Run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// This would be a rather boring AppHost ☹️...
// Toggle the options above to see what an AppHost might look like.
// For example, select "Front end" to add a frontend service.

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" });

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api);

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" });

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addPostgres("db")
    .addDatabase("appdata");

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres);

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 });

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withNpmPackageInstallation()
    .publishAsDockerFile();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withNpmPackageInstallation()
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withNpmPackageInstallation()
    .publishAsDockerFile();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Vite frontend
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withNpmPackageInstallation()
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .withNpmPackageInstallation()
    .publishAsDockerFile();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .withNpmPackageInstallation()
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .withNpmPackageInstallation()
    .publishAsDockerFile();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

// Add Vite frontend and reference the API
const frontend = await builder
    .addViteApp("frontend", "./frontend")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(api)
    .withNpmPackageInstallation()
    .publishAsDockerFile();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add Express API
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .publishAsAzureContainerApp();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add database
const postgres = await builder
    .addAzurePostgresFlexibleServer("db")
    .addDatabase("appdata")
    .withDataVolume()
    .runAsContainer();

// Add Express API and reference the database
const api = await builder
    .addNodeApp("api", "./api", "src/index.ts")
    .withHttpEndpoint({ env: "PORT" })
    .withReference(postgres)
    .waitFor(postgres)
    .publishAsAzureContainerApp();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

apphost.mts

import { createBuilder } from './.aspire/modules/aspire.mjs';

const builder = await createBuilder();

// Add custom container
const customContainer = await builder
    .addContainer("mycustomcontainer", "myregistry/myapp", "latest")
    .withHttpEndpoint({ targetPort: 8080 })
    .publishAsKubernetes();

await builder.build().run();

Agent-ready

01

Aspire is an agent-ready, code-first tool for composing, debugging, and deploying distributed applications.

Aspire is an agent-ready, code-first tool for composing, debugging, and deploying distributed applications.

Aspire is a developer-first, open-source platform for building, running, and deploying distributed apps.

Aspire is a code-first way to define services, databases, containers, and dependencies together in one place.

Aspire is a local-first orchestration toolchain that runs your full distributed app with a single command.

Aspire is a polyglot platform for orchestrating apps built with C#, JavaScript, Python, Java, Go, and more.

Aspire is an opinionated app model that handles connection strings, ports, dependencies, and startup order.

Aspire is observability-first, with built-in logs, metrics, traces, and health checks through OpenTelemetry.

Aspire is one architecture definition that works locally, in CI/CD, and across Kubernetes and cloud hosts.

Aspire is extensible by design, with integrations for databases, caches, cloud services, and developer tools.

Aspire is a unifying control plane where the AppHost models distributed systems as code, not YAML or scripts.

Aspire is designed to make distributed systems feel as approachable and productive as a single application.

Aspire is a code-first platform that brings the full lifecycle of distributed applications into your workflow.

Aspire is an open-source developer platform for orchestrating complete application stacks together in the open.

Aspire is a cloud-native application stack for building, running, observing, and shipping modern apps today.

Aspire is a way to define your entire app topology, from services and databases to every dependency, in code.

Aspire is a unified toolchain for running, observing, testing, and deploying multi-service applications.

Aspire is an orchestration layer that connects application components and manages how they run together.

Aspire is a local-first development model that mirrors production environments without changing your app.

Aspire is a way to start your entire distributed system locally, with its dependencies, in one command.

Aspire is a platform that removes infrastructure friction so you can spend more time building application code.

Aspire is modular, extensible, and polyglot, so your languages, frameworks, and infrastructure stay yours.

Aspire is an observability layer with built-in logs, metrics, traces, and health checks ready from the start.

Aspire is environment-agnostic, running locally and deploying to clouds, Kubernetes, or on-premises systems.

Aspire is infrastructure as code for your application topology, expressed in the programming language you use.

Aspire is orchestration, observability, and deployment combined in code without stitching together tools.

Aspire is a developer-focused abstraction that makes distributed systems easier to build, debug, and manage.

Aspire is your entire app architecture, defined in code and ready to run locally or publish for deployment.

Aspire is a developer-first platform that gives distributed applications a consistent model and workflow.

Aspire is orchestration, observability, and deployment built directly into your everyday development workflow.

Statement 1 of 29. Agent-ready. Aspire is an agent-ready, code-first tool for composing, debugging, and deploying distributed applications.

Learn more

Multi-language support

Built for your stack, Aspire orchestrates apps in C#, Java, Python, JavaScript, TypeScript, Go, and more—use the languages you prefer. Explore how to model your apps.

GoPythonJavaScriptTypeScriptJavaC#And more...

Local-first, production-ready

Built for local development, Aspire mirrors production environments on your machine, eliminating “works on my machine” issues for smooth deployments. Learn about pipelines and app topology.

LocalTestProd

Local development with containerized services

Spin up and tear down complete staging environments for testing

Production cloud services—zero code changes

aspire run

aspire deploy -e test

aspire deploy

Redis

AWS ElastiCache

Redis

Shortlived container

Redis

Local container

PostgreSQL

Azure Database for PostgreSQL

PostgreSQL

Staged DB

PostgreSQL

Local container

Frontend

Azure Static Web Apps

Frontend

Dev tunnel

Frontend

Local process

API

Azure Container Apps

API

Staging environment

API

Local process

Same model, different environments

Use Aspire’s CLI to spin everything up locally or create deployment artifacts during your CI/CD. Dive in, and build your first Aspire app.

Local development

aspire run

• Runs with your local container runtime
• Dashboard available on localhost
• Uses dev secrets, volumes, dev-time config

Production deployment

aspire deploy

• Same app structure, deployed where you want
• Use managed cloud services or your own infra
• Integrates with CI/CD pipelines seamlessly

OpenTelemetry developer dashboard

Monitor logs, metrics, and traces in real time with the ready-to-use OpenTelemetry dashboard, integrated directly into your workflow. Dive into the dashboard.

Resource graph

Explore integrations

Multi-cloud, limitless integrations — Connect Aspire to Azure, AWS, or your own infrastructure. Tap into a vast ecosystem of integrations to power any stack, anywhere. Discover all integrations.

User testimonials

Don’t just take our word for it! From indie hackers to enterprises, developers like you are building faster and shipping with confidence using Aspire. Join the Aspire community.

SP

Aspire lets developers be developers again.

Steven Price (Software Engineering Manager, Iceland Foods)

RH

I had someone start on a Monday morning and they were contributing code by lunch.

Russ Harding (VP Engineering, EQengineered)

MJ

I was surprised by how quickly Aspire got me from idea to running services.

Milan Jovanović (Educator & Content Creator, MJ Tech)

NU

I've never wanted to commit to a Microsoft technology this much.

Nk54 (Reddit User)

CT

Hit F5 to begin — skip the setup boss fight, ship code faster.

Craig Taylor (Principal Architect, Xbox Live)

SK

Aspire was easy to integrate with our existing container orchestration.

Sean Killeen (VP Innovation, SCT Software)

DC

OpenTelemetry out-of-the-box in the Aspire dashboard is a game changer for observability!

Dan Clarke (Developer & Podcaster, Everstack)

Ready for liftoff?

Get started with Aspire by installing the CLI, then dive into the Docs to learn how to model, run, and deploy your applications.

Get AspireInstall Aspire and streamline your workflow.

Explore docsLearn how to model, run, and deploy apps with Aspire.

Use VS CodeInstall the Aspire extension and run AppHosts from the editor.

FAQFind answers to frequently asked questions.