CommunityToolkit.Aspire.Hosting.Ngrok
13.1.1
Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package CommunityToolkit.Aspire.Hosting.Ngrok --version 13.1.1
NuGet\Install-Package CommunityToolkit.Aspire.Hosting.Ngrok -Version 13.1.1
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="13.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CommunityToolkit.Aspire.Hosting.Ngrok" Version="13.1.1" />
<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 13.1.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: CommunityToolkit.Aspire.Hosting.Ngrok, 13.1.1"
#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 CommunityToolkit.Aspire.Hosting.Ngrok@13.1.1
#: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=CommunityToolkit.Aspire.Hosting.Ngrok&version=13.1.1
#tool nuget:?package=CommunityToolkit.Aspire.Hosting.Ngrok&version=13.1.1
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. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Aspire.Hosting (>= 13.1.0)
-
net8.0
- Aspire.Hosting (>= 13.1.0)
-
net9.0
- Aspire.Hosting (>= 13.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 |
|---|---|---|
| 13.1.2-beta.516 | 0 | 2/9/2026 |
| 13.1.2-beta.515 | 58 | 2/2/2026 |
| 13.1.2-beta.514 | 43 | 1/30/2026 |
| 13.1.2-beta.513 | 531 | 1/29/2026 |
| 13.1.2-beta.512 | 50 | 1/29/2026 |
| 13.1.2-beta.511 | 43 | 1/28/2026 |
| 13.1.2-beta.509 | 43 | 1/20/2026 |
| 13.1.2-beta.508 | 44 | 1/19/2026 |
| 13.1.2-beta.507 | 43 | 1/19/2026 |
| 13.1.2-beta.506 | 68 | 1/16/2026 |
| 13.1.2-beta.505 | 44 | 1/16/2026 |
| 13.1.2-beta.504 | 43 | 1/16/2026 |
| 13.1.1 | 1,565 | 1/16/2026 |
| 13.1.1-beta.502 | 48 | 1/16/2026 |
| 13.1.0 | 114 | 1/14/2026 |
| 13.1.0-beta.499 | 43 | 1/14/2026 |
| 13.0.1-beta.498 | 45 | 1/14/2026 |
| 13.0.1-beta.486 | 43 | 1/12/2026 |
| 13.0.1-beta.468 | 1,429 | 12/3/2025 |
| 13.0.1-beta.467 | 639 | 12/3/2025 |
| 13.0.0 | 3,972 | 11/25/2025 |
| 13.0.0-beta.462 | 152 | 11/25/2025 |
| 13.0.0-beta.456 | 158 | 11/23/2025 |
| 13.0.0-beta.454 | 106 | 11/23/2025 |
| 13.0.0-beta.453 | 129 | 11/22/2025 |
| 13.0.0-beta.450 | 127 | 11/22/2025 |
| 13.0.0-beta.448 | 123 | 11/22/2025 |
| 13.0.0-beta.444 | 420 | 11/17/2025 |
| 13.0.0-beta.443 | 293 | 11/17/2025 |
| 13.0.0-beta.440 | 106 | 11/15/2025 |
| 13.0.0-beta.439 | 381 | 11/12/2025 |
| 13.0.0-beta.438 | 243 | 11/12/2025 |
| 13.0.0-beta.436 | 244 | 11/12/2025 |
| 13.0.0-beta.435 | 249 | 11/11/2025 |
| 13.0.0-beta.433 | 168 | 11/10/2025 |
| 13.0.0-beta.432 | 165 | 11/10/2025 |
| 13.0.0-beta.431 | 151 | 11/6/2025 |
| 13.0.0-beta.430 | 158 | 11/6/2025 |
| 9.9.0 | 4,872 | 11/3/2025 |
| 9.9.0-beta.427 | 178 | 11/3/2025 |
| 9.8.1-beta.426 | 578 | 11/3/2025 |
| 9.8.1-beta.424 | 295 | 10/28/2025 |
| 9.8.1-beta.420 | 143 | 10/27/2025 |
| 9.8.1-beta.419 | 153 | 10/27/2025 |
| 9.8.1-beta.417 | 159 | 10/27/2025 |
| 9.8.1-beta.414 | 145 | 10/24/2025 |
| 9.8.1-beta.413 | 155 | 10/22/2025 |
| 9.8.1-beta.410 | 137 | 10/16/2025 |
| 9.8.1-beta.408 | 134 | 10/16/2025 |
| 9.8.1-beta.407 | 133 | 10/16/2025 |
| 9.8.1-beta.406 | 139 | 10/15/2025 |
| 9.8.0 | 2,132 | 9/26/2025 |
| 9.8.0-beta.405 | 152 | 10/15/2025 |
| 9.8.0-beta.404 | 142 | 10/13/2025 |
| 9.8.0-beta.402 | 144 | 9/29/2025 |
| 9.8.0-beta.401 | 144 | 9/29/2025 |
| 9.8.0-beta.399 | 140 | 9/26/2025 |
| 9.8.0-beta.398 | 149 | 9/25/2025 |
| 9.8.0-beta.397 | 151 | 9/25/2025 |
| 9.8.0-beta.395 | 151 | 9/24/2025 |
| 9.8.0-beta.394 | 146 | 9/23/2025 |
| 9.8.0-beta.393 | 151 | 9/23/2025 |
| 9.8.0-beta.392 | 149 | 9/23/2025 |
| 9.8.0-beta.389 | 277 | 9/18/2025 |
| 9.8.0-beta.388 | 292 | 9/16/2025 |
| 9.8.0-beta.386 | 227 | 9/15/2025 |
| 9.8.0-beta.385 | 231 | 9/15/2025 |
| 9.8.0-beta.384 | 80 | 9/13/2025 |
| 9.8.0-beta.376 | 161 | 9/8/2025 |
| 9.8.0-beta.375 | 88 | 9/6/2025 |
| 9.8.0-beta.373 | 162 | 9/5/2025 |
| 9.8.0-beta.372 | 162 | 9/4/2025 |
| 9.8.0-beta.370 | 152 | 9/2/2025 |
| 9.8.0-beta.364 | 143 | 9/1/2025 |
| 9.7.2 | 1,508 | 8/29/2025 |
| 9.7.2-beta.362 | 188 | 8/29/2025 |
| 9.7.2-beta.361 | 198 | 8/29/2025 |
| 9.7.2-beta.360 | 192 | 8/29/2025 |
| 9.7.2-beta.359 | 193 | 8/28/2025 |
| 9.7.2-beta.358 | 190 | 8/28/2025 |
| 9.7.2-beta.357 | 201 | 8/28/2025 |
| 9.7.1 | 467 | 8/27/2025 |
| 9.7.1-beta.355 | 200 | 8/27/2025 |
| 9.7.1-beta.354 | 195 | 8/27/2025 |
| 9.7.1-beta.353 | 190 | 8/27/2025 |
| 9.7.1-beta.352 | 189 | 8/27/2025 |
| 9.7.1-beta.351 | 190 | 8/27/2025 |
| 9.7.1-beta.348 | 198 | 8/14/2025 |
| 9.7.1-beta.344 | 106 | 8/10/2025 |
| 9.7.1-beta.343 | 223 | 8/8/2025 |
| 9.7.1-beta.342 | 230 | 8/7/2025 |
| 9.7.1-beta.341 | 225 | 8/6/2025 |
| 9.7.1-beta.340 | 205 | 8/5/2025 |
| 9.7.1-beta.339 | 204 | 8/5/2025 |
| 9.7.0 | 1,801 | 8/1/2025 |
| 9.7.0-beta.337 | 103 | 8/1/2025 |
| 9.7.0-beta.336 | 125 | 8/1/2025 |
| 9.7.0-beta.335 | 116 | 8/1/2025 |
| 9.7.0-beta.333 | 129 | 7/30/2025 |
| 9.6.1-beta.332 | 125 | 7/30/2025 |
| 9.6.1-beta.331 | 134 | 7/30/2025 |
| 9.6.1-beta.330 | 127 | 7/30/2025 |
| 9.6.1-beta.329 | 126 | 7/30/2025 |
| 9.6.1-beta.328 | 135 | 7/29/2025 |
| 9.6.1-beta.327 | 142 | 7/28/2025 |
| 9.6.1-beta.326 | 145 | 7/28/2025 |
| 9.6.0 | 757 | 7/10/2025 |
| 9.6.0-beta.324 | 140 | 7/10/2025 |
| 9.5.1-beta.323 | 151 | 7/10/2025 |
| 9.5.1-beta.322 | 144 | 7/10/2025 |
| 9.5.1-beta.321 | 149 | 7/10/2025 |
| 9.5.1-beta.320 | 150 | 7/9/2025 |
| 9.5.1-beta.319 | 154 | 7/8/2025 |
| 9.5.1-beta.318 | 163 | 7/2/2025 |
| 9.5.1-beta.317 | 151 | 6/30/2025 |
| 9.5.1-beta.315 | 152 | 6/26/2025 |
| 9.5.1-beta.314 | 155 | 6/23/2025 |
| 9.5.1-beta.313 | 131 | 6/20/2025 |
| 9.5.1-beta.312 | 143 | 6/20/2025 |
| 9.5.1-beta.311 | 182 | 6/18/2025 |
| 9.5.1-beta.310 | 164 | 6/17/2025 |
| 9.5.1-beta.309 | 173 | 6/17/2025 |
| 9.5.1-beta.308 | 149 | 6/17/2025 |
| 9.5.1-beta.307 | 163 | 6/16/2025 |
| 9.5.1-beta.306 | 322 | 6/11/2025 |
| 9.5.1-beta.305 | 123 | 6/7/2025 |
| 9.5.1-beta.304 | 136 | 6/6/2025 |
| 9.5.1-beta.303 | 139 | 6/4/2025 |
| 9.5.1-beta.302 | 171 | 6/4/2025 |
| 9.5.1-beta.301 | 186 | 6/2/2025 |
| 9.5.1-beta.300 | 151 | 5/28/2025 |
| 9.5.0 | 2,593 | 5/27/2025 |
| 9.5.0-beta.299 | 152 | 5/27/2025 |
| 9.5.0-beta.298 | 155 | 5/26/2025 |
| 9.5.0-beta.297 | 104 | 5/24/2025 |
| 9.5.0-beta.296 | 116 | 5/24/2025 |
| 9.5.0-beta.295 | 94 | 5/24/2025 |
| 9.4.1-beta.291 | 152 | 5/19/2025 |
| 9.4.1-beta.289 | 194 | 5/16/2025 |
| 9.4.1-beta.288 | 218 | 5/16/2025 |
| 9.4.1-beta.287 | 208 | 5/16/2025 |
| 9.4.1-beta.286 | 218 | 5/16/2025 |
| 9.4.1-beta.285 | 225 | 5/14/2025 |
| 9.4.1-beta.284 | 234 | 5/13/2025 |
| 9.4.1-beta.283 | 232 | 5/12/2025 |
| 9.4.1-beta.282 | 165 | 5/7/2025 |
| 9.4.1-beta.280 | 153 | 5/2/2025 |
| 9.4.1-beta.279 | 150 | 5/2/2025 |
| 9.4.1-beta.277 | 168 | 4/23/2025 |
| 9.4.1-beta.276 | 174 | 4/23/2025 |
| 9.4.1-beta.275 | 161 | 4/23/2025 |
| 9.4.1-beta.274 | 175 | 4/23/2025 |
| 9.4.1-beta.273 | 165 | 4/23/2025 |
| 9.4.1-beta.272 | 183 | 4/23/2025 |
| 9.4.1-beta.271 | 583 | 4/23/2025 |
| 9.4.1-beta.270 | 218 | 4/20/2025 |
| 9.4.0 | 956 | 4/20/2025 |
| 9.4.0-beta.269 | 167 | 4/20/2025 |
| 9.4.0-beta.268 | 182 | 4/20/2025 |
| 9.3.1-beta.267 | 188 | 4/20/2025 |
| 9.3.1-beta.266 | 104 | 4/19/2025 |
| 9.3.1-beta.265 | 192 | 4/15/2025 |
| 9.3.1-beta.264 | 191 | 4/15/2025 |
| 9.3.1-beta.263 | 197 | 4/15/2025 |
| 9.3.1-beta.262 | 192 | 4/15/2025 |
| 9.3.1-beta.260 | 159 | 4/10/2025 |
| 9.3.1-beta.259 | 161 | 4/8/2025 |
| 9.3.1-beta.258 | 198 | 4/8/2025 |
| 9.3.1-beta.257 | 170 | 4/8/2025 |
| 9.3.1-beta.256 | 171 | 4/8/2025 |
| 9.3.1-beta.255 | 170 | 4/8/2025 |
| 9.3.1-beta.254 | 187 | 4/8/2025 |
| 9.3.1-beta.253 | 159 | 4/1/2025 |
| 9.3.1-beta.252 | 140 | 3/27/2025 |
| 9.3.1-beta.250 | 162 | 3/27/2025 |
| 9.3.1-beta.249 | 150 | 3/27/2025 |
| 9.3.1-beta.248 | 143 | 3/27/2025 |
| 9.3.1-beta.247 | 145 | 3/27/2025 |
| 9.3.1-beta.244 | 492 | 3/25/2025 |
| 9.3.1-beta.242 | 488 | 3/24/2025 |
| 9.3.1-beta.241 | 162 | 3/19/2025 |
| 9.3.0 | 579 | 3/19/2025 |
| 9.3.0-beta.239 | 156 | 3/19/2025 |
| 9.2.2-beta.237 | 158 | 3/19/2025 |
| 9.2.2-beta.236 | 126 | 3/14/2025 |
| 9.2.2-beta.230 | 189 | 3/13/2025 |
| 9.2.2-beta.229 | 158 | 3/13/2025 |
| 9.2.2-beta.228 | 201 | 3/11/2025 |
| 9.2.2-beta.227 | 184 | 3/11/2025 |
| 9.2.2-beta.226 | 175 | 3/11/2025 |
| 9.2.2-beta.225 | 159 | 3/11/2025 |
| 9.2.2-beta.224 | 191 | 3/11/2025 |
| 9.2.2-beta.223 | 177 | 3/10/2025 |
| 9.2.2-beta.222 | 172 | 3/10/2025 |
| 9.2.2-beta.220 | 162 | 3/9/2025 |
| 9.2.2-beta.218 | 166 | 3/9/2025 |
| 9.2.2-beta.217 | 207 | 3/7/2025 |
| 9.2.2-beta.216 | 220 | 3/7/2025 |
| 9.2.2-beta.215 | 211 | 3/7/2025 |
| 9.2.2-beta.214 | 224 | 3/5/2025 |
| 9.2.2-beta.213 | 200 | 3/5/2025 |
| 9.2.2-beta.212 | 207 | 3/5/2025 |
| 9.2.2-beta.211 | 205 | 3/4/2025 |
| 9.2.2-beta.210 | 219 | 3/4/2025 |
| 9.2.2-beta.208 | 116 | 3/3/2025 |
| 9.2.1 | 351 | 3/3/2025 |
| 9.2.1-beta.207 | 126 | 3/2/2025 |
| 9.2.1-beta.206 | 98 | 3/1/2025 |
| 9.2.1-beta.205 | 106 | 2/27/2025 |
| 9.2.1-beta.204 | 115 | 2/26/2025 |
| 9.2.1-beta.203 | 92 | 2/26/2025 |
| 9.2.0 | 209 | 2/26/2025 |
| 9.2.0-beta.202 | 117 | 2/26/2025 |
| 9.2.0-beta.201 | 106 | 2/26/2025 |
| 9.2.0-beta.199 | 103 | 2/26/2025 |
| 9.2.0-beta.198 | 113 | 2/26/2025 |
| 9.1.1-beta.197 | 109 | 2/25/2025 |
| 9.1.1-beta.196 | 128 | 2/25/2025 |
| 9.1.1-beta.195 | 100 | 2/25/2025 |
| 9.1.1-beta.194 | 108 | 2/25/2025 |
| 9.1.1-beta.193 | 132 | 2/25/2025 |
| 9.1.1-beta.192 | 134 | 2/24/2025 |
| 9.1.1-beta.191 | 180 | 2/24/2025 |
| 9.1.1-beta.190 | 116 | 2/19/2025 |
| 9.1.1-beta.189 | 104 | 2/19/2025 |
| 9.1.1-beta.188 | 122 | 2/19/2025 |
| 9.1.1-beta.187 | 132 | 2/19/2025 |
| 9.1.1-beta.183 | 111 | 2/18/2025 |
| 9.1.1-beta.182 | 117 | 2/18/2025 |
| 9.1.1-beta.181 | 128 | 2/18/2025 |
| 9.1.1-beta.180 | 113 | 2/17/2025 |
| 9.1.1-beta.178 | 109 | 2/17/2025 |
| 9.1.1-beta.177 | 121 | 2/12/2025 |
| 9.1.1-beta.176 | 128 | 2/11/2025 |
| 9.1.1-beta.175 | 103 | 2/11/2025 |
| 9.1.1-beta.173 | 106 | 2/10/2025 |
| 9.1.1-beta.169 | 217 | 2/6/2025 |
| 9.1.1-beta.168 | 122 | 2/5/2025 |
| 9.1.1-beta.166 | 105 | 2/5/2025 |
| 9.1.1-beta.165 | 93 | 2/5/2025 |
| 9.1.1-beta.164 | 109 | 2/3/2025 |
| 9.1.1-beta.162 | 97 | 2/3/2025 |
| 9.1.1-beta.155 | 97 | 1/30/2025 |
| 9.1.1-beta.154 | 96 | 1/30/2025 |
| 9.1.1-beta.153 | 92 | 1/30/2025 |
| 9.1.1-beta.152 | 85 | 1/29/2025 |
| 9.1.1-beta.150 | 110 | 1/29/2025 |
| 9.1.1-beta.148 | 104 | 1/26/2025 |
| 9.1.1-beta.147 | 92 | 1/26/2025 |
| 9.1.1-beta.146 | 123 | 1/23/2025 |
| 9.1.1-beta.145 | 122 | 1/22/2025 |
| 9.1.1-beta.144 | 103 | 1/22/2025 |
| 9.1.1-beta.142 | 100 | 1/22/2025 |
| 9.1.1-beta.140 | 121 | 1/22/2025 |
| 9.1.1-beta.139 | 97 | 1/21/2025 |
| 9.1.1-beta.138 | 120 | 1/20/2025 |
| 9.1.1-beta.137 | 107 | 1/17/2025 |
| 9.1.1-beta.136 | 105 | 1/15/2025 |
| 9.1.1-beta.135 | 70 | 1/15/2025 |
| 9.1.1-beta.134 | 73 | 1/15/2025 |