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

• 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 35 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 35 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 Skills Repository

Requirements

• .NET 10
• .NET Aspire 13.1+