Aspirerelease/13.6
Watch Aspire live streamsDocsTry Aspire
Watch Aspire live streamsDocsTry

Existing resource pattern

Definition

Term type
Pattern

Connects an application to a dependency that already exists instead of creating and managing a new instance.

Also known as
existing resource, AddConnectionString

For a dependency exposed through a connection string, use AddConnectionString in C# or addConnectionString in TypeScript to represent the configured value in the AppHost.

For a resource named db, Aspire reads ConnectionStrings:db from AppHost configuration, including the environment variable ConnectionStrings__db, and passes the value to referencing consumers.

This is useful for shared team resources or existing production services. The connection string resource does not create, migrate, or manage the database itself. Keep credentials in an appropriate secret store rather than source control.

Practical example

Supply a shared database's connection string in AppHost configuration and reference it from an API without starting another database container.