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();

Free and open source

Aspire is a developer-first, always-free, open-source platform. Join a thriving community and help shape the future of modern development.

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.

Pause video

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.