SharpCoreDB.Aspire.Hosting 2.1.2

.NET 11.0 This package targets .NET 11.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package SharpCoreDB.Aspire.Hosting --version 2.1.2
                    


                    

                
NuGet\Install-Package SharpCoreDB.Aspire.Hosting -Version 2.1.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="SharpCoreDB.Aspire.Hosting" Version="2.1.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="SharpCoreDB.Aspire.Hosting" Version="2.1.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="SharpCoreDB.Aspire.Hosting" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add SharpCoreDB.Aspire.Hosting --version 2.1.2
                    


                    

                
#r "nuget: SharpCoreDB.Aspire.Hosting, 2.1.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package SharpCoreDB.Aspire.Hosting@2.1.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=SharpCoreDB.Aspire.Hosting&version=2.1.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=SharpCoreDB.Aspire.Hosting&version=2.1.2
                    


                            Install as a Cake Tool

SharpCoreDB.Aspire.Hosting

.NET Aspire hosting integration for the SharpCoreDB network server container image (ghcr.io/mpcoredeveloper/sharpcoredb-server).

Quick start

var builder = DistributedApplication.CreateBuilder(args);

var db = builder.AddSharpCoreDB("db")
    .WithServerContainer()
    .WithImageTag("2.1.0")
    .WithJwtSecret("replace-with-a-secret-of-at-least-32-characters");

builder.Build().Run();

The server container exposes two HTTPS endpoints (TLS 1.2+ is enforced, plain HTTP is not supported):

Endpoint name Container port Purpose
grpc 5001 Primary gRPC protocol (HTTP/2)
https 8443 HTTPS REST API + /health

The resource implements IResourceWithConnectionString; the connection string points at the grpc endpoint (Host=…;Port=…;SSL=True).

Extension methods

  • AddSharpCoreDB(name) — adds the container resource.
  • WithServerContainer() — documentation alias for the container-based hosting intent.
  • WithJwtSecret(secret) — forwards Server__Security__JwtSecretKey (min. 32 chars).
  • WithImageTag(tag) — pick a published image tag instead of latest.

Prerequisites

  • The image is published to ghcr.io/mpcoredeveloper/sharpcoredb-server by the repository Docker workflow on every v* tag (linux/amd64 + linux/arm64).

Development notes (TLS)

In local Aspire development the container keeps enforcing TLS. Trust the Aspire development certificate in the consuming app, or connect over the Aspire network with certificate validation disabled for the grpc endpoint. See docs/server/ASPIRE_INTEGRATION.md for the full guide.

Product Compatible and additional computed target framework versions.
.NET net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on SharpCoreDB.Aspire.Hosting:

Package Downloads
SCDMS.Aspire.Hosting

.NET Aspire hosting integration for the SCDMS web studio - registers the SCDMS container and links it to a SharpCoreDB server container over gRPC

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.4 53 11/13/2026
2.1.3 48 11/13/2026
2.1.2 123 10/26/2026
2.1.1 106 10/25/2026
2.1.0 114 10/10/2026
2.1.0-RC.3 71 9/17/2026
2.0.0.3 189 9/12/2026
2.0.0.2 196 9/5/2026

v2.1.2 (2026-10-26): patch release with no API changes - a bound text parameter is no longer re-scanned as SQL text, so a value holding an apostrophe, a doubled quote, a backslash, a comma or a parenthesis now round-trips exactly instead of landing in the neighbouring column or failing with "Mismatched parentheses in VALUES clause"; full detail in docs/CHANGELOG.md. Previous: v2.1.1 (2026-10-25): patch release with no API changes. A float[] parameter now reaches a VECTOR(n) column as a vector instead of the literal text "System.Single[]", and ORDER BY vec_distance_*() LIMIT k now reaches the vector index instead of a full scan. Previous: v2.1.0 (2026-10-10): .NET Aspire hosting package for SharpCoreDB.Server - container image ghcr.io/mpcoredeveloper/sharpcoredb-server with HTTPS gRPC (5001) and HTTPS REST API (8443) endpoints. Full details: https://github.com/MPCoreDeveloper/SharpCoreDB/blob/master/docs/server/ASPIRE_INTEGRATION.md