🔌 wireplug

Quick Start

$ brew install rust wireguard-go
$ cargo install --git https://github.com/alpn/wireplug --tag v0.1.0 wireplugd

# This requires root access to write the config file to /etc
$ sudo wireplugd wg0 --generate-config

$ sudo wireplugd wg0

$ cargo install --git https://github.com/alpn/wireplug --tag v0.1.0 wireplugd

# This requires root access to write the config file to /etc
$ sudo wireplugd wg0 --generate-config

$ sudo ip link add dev wg0 type wireguard

$ sudo wireplugd wg0

# TODO

$ cargo install --git https://github.com/alpn/wireplug --tag v0.1.0 wireplugd

$ doas ifconfig wg0 | grep 'wgpubkey' | cut -d ' ' -f 2

$ doas wireplugd wg0

Demo

FAQ

How Does It Work?

Each device on the network runs a lightweight background daemon that monitors network changes. When a change is detected, it updates other peers through a central coordination server. The daemon will handle connectivity hurdles like NAT traversal and will connect peers locally whenever they are on the same network. Network participants can roam freely between networks and geographic locations while maintaining their peer-to-peer connectivity.

How Is This Different From X?

Most existing projects in this space are run by VC-funded companies and have different goals. Some of them offer an open-source client, but not the server. All of them require creating an account which is subject to ever-changing terms and conditions. wireplug, on the other hand, sees itself as a foundational, free, internet infrastructure, more akin to Root DNS servers and IXPs than a startup company. Its goal is to allow individuals and small teams to use the internet as it was originally intended, in a distributed, peer-to-peer manner. It focuses on simplicity and understandability, very much in the spirit of WireGuard itself.

Who Is This For?

wireplug is geared toward WireGuard users who want to continue having full control over their keys and network topology, but also be able to roam freely between networks. wireplug makes this possible by handling NAT traversal and automatic endpoint updating.

Can I Self-Host It?

Of course. By default, wireplug connects to a coordination server run by wireplug.org. Users may choose to run their own instances, but a special effort has been made so they never have to. The protocol is deliberately simple and was designed so that clients share only the absolutely necessary information with the coordination server.

Stay updated

• @wireplug.org
• @wireplugorg
• Alternatively, email list@wireplug.org to subscribe and receive updates via email

Need More?

The service is free and open to use. For teams that require additional support, we offer paid consulting, training and workshops, and custom development to help fund ongoing development and maintenance. Contact us for details.