Installation Guide

Follow these steps to deploy the Muterconn agent on your system.

Windows Installation (Recommended)

To deploy on a Windows machine, open an elevated PowerShell console (Run as Administrator) and run:

Set-ExecutionPolicy Bypass -Scope Process -Force; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; irm https://muterconn.com/install.ps1 | iex

This one-liner will:

1. Temporarily bypass execution restrictions.
2. Silently install Npcap (if not present) for raw packet spoofing.
3. Scaffold C:\muterconn\ runtime directory.
4. Download the latest muterconn-proxy.exe.
5. Register and start the MuterconnProxy Windows service.

Linux Installation

To deploy on a standard Linux server, run the bootstrap script:

curl -fsSL https://muterconn.com/install.sh | sudo sh

This script will:

1. Download the compiled agent binary.
2. Install eBPF kernel headers.
3. Configure and start the muterconn-agent systemd service.

Verification

Windows

Verify service state:

Get-Service -Name MuterconnProxy

Linux

Verify service state:

sudo systemctl status muterconn-agent