Getting Started

Aspire hosting integration for Gluetun, a lightweight VPN client container supporting 30+ providers. Models Gluetun as a first-class Aspire resource and lets other containers route their traffic through the VPN tunnel.

GitHub
Downloads
Aspire AppHost

• Gluetun Wiki

Frameworks

.NET

Features

Feature	Description
First-class Aspire resource	Gluetun VPN container with NET_ADMIN capability and /dev/net/tun device access
Container routing	route any container’s traffic through the VPN with a single method call
VPN provider support	typed configuration for OpenVPN and WireGuard, with support for any Gluetun environment variable
Aspire parameter integration	use ParameterResource for secrets (private keys, passwords)
Docker Compose publish	routed containers automatically get network_mode: "service:<vpn>" and their ports are transferred to the Gluetun service

Quick Start

1. Install the package into your AppHost project

   

2. Add a Gluetun VPN container and route other containers through it

   var builder = DistributedApplication.CreateBuilder(args);
   
   var vpn = builder.AddGluetun("vpn")
       .WithVpnProvider("mullvad")
       .WithWireGuard(builder.AddParameter("wireguard-key", secret: true))
       .WithServerCountries("US", "Canada");
   
   var scraper = builder.AddContainer("scraper", "my-scraper")
       .WithHttpEndpoint(targetPort: 8080);
   
   vpn.WithRoutedContainer(scraper);
   
   builder.Build().Run();

AI Coding Assistant

Claude CodeGitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny@shiny

One plugin installs all 48 Shiny skills. Your agent loads only the skill relevant to what you're building, so there's no cost to having them all available.

Step 1 — Add the marketplace:

copilot plugin marketplace add https://github.com/shinyorg/skills

Step 2 — Install the plugin:

copilot plugin install shiny@shiny

One plugin installs all 48 Shiny skills. Your agent loads only the skill relevant to what you're building, so there's no cost to having them all available.

View shiny-aspire-orleans Skill

Requirements

• .NET 10
• .NET Aspire 13.1+