CommunityToolkit.Aspire.Hosting.Ngrok
9.3.1-beta.253
Prefix Reserved
This is a prerelease version of CommunityToolkit.Aspire.Hosting.Ngrok.
dotnet add package CommunityToolkit.Aspire.Hosting.Ngrok --version 9.3.1-beta.253
NuGet\Install-Package CommunityToolkit.Aspire.Hosting.Ngrok -Version 9.3.1-beta.253
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="CommunityToolkit.Aspire.Hosting.Ngrok" Version="9.3.1-beta.253" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CommunityToolkit.Aspire.Hosting.Ngrok" Version="9.3.1-beta.253" />
<PackageReference Include="CommunityToolkit.Aspire.Hosting.Ngrok" />
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 CommunityToolkit.Aspire.Hosting.Ngrok --version 9.3.1-beta.253
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: CommunityToolkit.Aspire.Hosting.Ngrok, 9.3.1-beta.253"
#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.
#addin nuget:?package=CommunityToolkit.Aspire.Hosting.Ngrok&version=9.3.1-beta.253&prerelease
#tool nuget:?package=CommunityToolkit.Aspire.Hosting.Ngrok&version=9.3.1-beta.253&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
CommunityToolkit.Aspire.Hosting.Ngrok library
Provides extension methods and resource definitions for a .NET Aspire AppHost to configure a ngrok container.
Getting Started
Install the package
In your AppHost project, install the package using the following command:
dotnet add package CommunityToolkit.Aspire.Hosting.Ngrok
Example usage
Then, in the Program.cs file of app host, add a ngrok resource and add endpoints to be tunneled following methods:
var myService = builder.AddProject<Projects.MyService>();
var otherSevice = builder.AddProject<Projects.OtherService>();
var authToken = builder
.AddParameter("ngrok-auth-token", "your-ngrok-auth-token", secret: true);
builder.AddNgrok("ngrok", endpointPort: 59600) // omit endpointPort to use random port
.WithAuthToken(authToken)
.WithTunnelEndpoint(myService, "http", "<your-ngrok-domain>")
.WithTunnelEndpoint(otherSevice, "http"); // ngrok will generate a random domain for this service
Querying the ngrok tunneled endpoints
After the ngrok container has started, you can query the ngrok tunneled endpoints using api exposed by the ngrok container:
curl -H "Accept: application/json" -s http://localhost:59600/api/tunnels
This will return a JSON response with the ngrok tunneled endpoints.
{
"tunnels": [
{
"name": "my-http",
"ID": "5baa78f84cffb31a96cccf5bbe992451",
"uri": "/api/tunnels/my-http",
"public_url": "https://<your-ngrok-domain>",
"proto": "https",
"config": {
"addr": "http://host.docker.internal:5165",
"inspect": true
},
// ...
}, {
"name": "other-http",
"ID": "f7f1351d1307e3615ca7de310bf6bb61",
"uri": "/api/tunnels/other-http",
"public_url": "https://0849-94-134-176-242.ngrok-free.app",
"proto": "https",
"config": {
"addr": "http://host.docker.internal:3657",
"inspect": true
},
// ...
}
],
"uri": "/api/tunnels"
}
Additional Information
Feedback & contributing
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- Aspire.Hosting (>= 9.1.0)
-
net9.0
- Aspire.Hosting (>= 9.1.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last updated |
|---|---|---|
| 9.3.1-beta.253 | 111 | 5 days ago |
| 9.3.1-beta.252 | 87 | 10 days ago |
| 9.3.1-beta.250 | 89 | 10 days ago |
| 9.3.1-beta.249 | 86 | 10 days ago |
| 9.3.1-beta.248 | 87 | 10 days ago |
| 9.3.1-beta.247 | 88 | 10 days ago |
| 9.3.1-beta.244 | 437 | 12 days ago |
| 9.3.1-beta.242 | 436 | 12 days ago |
| 9.3.1-beta.241 | 110 | 18 days ago |
| 9.3.0 | 194 | 18 days ago |
| 9.3.0-beta.239 | 106 | 18 days ago |
| 9.2.2-beta.237 | 116 | 18 days ago |
| 9.2.2-beta.236 | 76 | 23 days ago |
| 9.2.2-beta.230 | 109 | 24 days ago |
| 9.2.2-beta.229 | 108 | 24 days ago |
| 9.2.2-beta.228 | 123 | a month ago |
| 9.2.2-beta.227 | 119 | a month ago |
| 9.2.2-beta.226 | 121 | a month ago |
| 9.2.2-beta.225 | 112 | a month ago |
| 9.2.2-beta.224 | 116 | a month ago |
| 9.2.2-beta.223 | 124 | a month ago |
| 9.2.2-beta.222 | 124 | a month ago |
| 9.2.2-beta.220 | 117 | a month ago |
| 9.2.2-beta.218 | 119 | a month ago |
| 9.2.2-beta.217 | 158 | a month ago |
| 9.2.2-beta.216 | 163 | a month ago |
| 9.2.2-beta.215 | 160 | a month ago |
| 9.2.2-beta.214 | 161 | a month ago |
| 9.2.2-beta.213 | 151 | a month ago |
| 9.2.2-beta.212 | 155 | a month ago |
| 9.2.2-beta.211 | 157 | a month ago |
| 9.2.2-beta.210 | 158 | a month ago |
| 9.2.2-beta.208 | 60 | a month ago |
| 9.2.1 | 109 | a month ago |
| 9.2.1-beta.207 | 79 | a month ago |
| 9.2.1-beta.206 | 53 | a month ago |
| 9.2.1-beta.205 | 55 | a month ago |
| 9.2.1-beta.204 | 52 | a month ago |
| 9.2.1-beta.203 | 50 | a month ago |
| 9.2.0 | 100 | a month ago |
| 9.2.0-beta.202 | 45 | a month ago |
| 9.2.0-beta.201 | 54 | a month ago |
| 9.2.0-beta.199 | 52 | a month ago |
| 9.2.0-beta.198 | 45 | a month ago |
| 9.1.1-beta.197 | 54 | a month ago |
| 9.1.1-beta.196 | 57 | a month ago |
| 9.1.1-beta.195 | 49 | a month ago |
| 9.1.1-beta.194 | 53 | a month ago |
| 9.1.1-beta.193 | 56 | a month ago |
| 9.1.1-beta.192 | 56 | a month ago |
| 9.1.1-beta.191 | 98 | a month ago |
| 9.1.1-beta.190 | 60 | 2 months ago |
| 9.1.1-beta.189 | 50 | 2 months ago |
| 9.1.1-beta.188 | 58 | 2 months ago |
| 9.1.1-beta.187 | 64 | 2 months ago |
| 9.1.1-beta.183 | 64 | 2 months ago |
| 9.1.1-beta.182 | 59 | 2 months ago |
| 9.1.1-beta.181 | 74 | 2 months ago |
| 9.1.1-beta.180 | 59 | 2 months ago |
| 9.1.1-beta.178 | 57 | 2 months ago |
| 9.1.1-beta.177 | 71 | 2 months ago |
| 9.1.1-beta.176 | 67 | 2 months ago |
| 9.1.1-beta.175 | 58 | 2 months ago |
| 9.1.1-beta.173 | 61 | 2 months ago |
| 9.1.1-beta.169 | 58 | 2 months ago |
| 9.1.1-beta.168 | 50 | 2 months ago |
| 9.1.1-beta.166 | 55 | 2 months ago |
| 9.1.1-beta.165 | 46 | 2 months ago |
| 9.1.1-beta.164 | 57 | 2 months ago |
| 9.1.1-beta.162 | 56 | 2 months ago |
| 9.1.1-beta.155 | 54 | 2 months ago |
| 9.1.1-beta.154 | 49 | 2 months ago |
| 9.1.1-beta.153 | 48 | 2 months ago |
| 9.1.1-beta.152 | 44 | 2 months ago |
| 9.1.1-beta.150 | 55 | 2 months ago |
| 9.1.1-beta.148 | 58 | 2 months ago |
| 9.1.1-beta.147 | 49 | 2 months ago |
| 9.1.1-beta.146 | 53 | 2 months ago |
| 9.1.1-beta.145 | 47 | 2 months ago |
| 9.1.1-beta.144 | 48 | 3 months ago |
| 9.1.1-beta.142 | 51 | 3 months ago |
| 9.1.1-beta.140 | 51 | 3 months ago |
| 9.1.1-beta.139 | 48 | 3 months ago |
| 9.1.1-beta.138 | 48 | 3 months ago |
| 9.1.1-beta.137 | 41 | 3 months ago |
| 9.1.1-beta.136 | 43 | 3 months ago |
| 9.1.1-beta.135 | 20 | 3 months ago |
| 9.1.1-beta.134 | 23 | 3 months ago |