macOS
Homebrewverified · 100%
brew install edgevpnlocal Homebrew formula metadata
brew
Install edgevpn with Homebrew
Immutable, decentralized, statically built p2p VPN. Version 0.35.3 via Homebrew; verified 2026-07-07.
install
Additional install commands
overview
Package summary
Immutable, decentralized, statically built p2p VPN
Project links
Commands and aliases
- edgevpn
history
Project history and usage
EdgeVPN is a Go/libp2p tool for creating decentralized private networks, reverse proxies, and peer-to-peer file transfers using shared tokens or configuration files instead of a central VPN server.
Project history
The GitHub repository was created in May 2021. The README frames the project as an experiment with libp2p and as a more open, less-infrastructure alternative to ngrok-style tunneling.
By 2026, the project had an active release stream, with GitHub releases including v0.35.2 in June 2026. The README describes a broader scope than VPN alone: reverse proxying, p2p file transfer, a library interface, and an internal distributed ledger.
Adoption history
Official adoption evidence is strongest inside related cloud-native projects. The README says the Kairos CNCF project uses EdgeVPN as a layer for creating decentralized Kubernetes clusters, and that EdgeVPN powers LocalAI's P2P features.
Homebrew packaging gives workstation users a simple install path, while the upstream README primarily directs users to precompiled static releases and source usage.
How it is used
Users generate a config file with `edgevpn -g > config.yaml` or an encoded token with `edgevpn -g -b`, then share that network definition among peers. The README warns that exposing the file or token is equivalent to giving full control of the network.
Common uses include starting a VPN interface with per-node virtual addresses, exposing TCP services through the p2p network, sending files, and embedding EdgeVPN as a Go library.
Why package nerds care
EdgeVPN is interesting to package people because it bundles modern p2p networking into a single static CLI with very little central infrastructure. It lives in the same mental drawer as VPNs, tunnels, reverse proxies, and Kubernetes lab tooling.
The project also shows the current package-manager appetite for edge and homelab networking tools: install one binary, generate a token, and assemble an overlay network without running a coordinator service.
Timeline
- 2021-05: GitHub repository created.
- 2021: README screenshots and early documentation show dashboard and networking features.
- 2026-05: Release stream reaches v0.34.0.
- 2026-06: Release v0.35.2 published.
Related projects
- libp2p is the underlying p2p networking stack credited by the project.
- Kairos uses EdgeVPN for decentralized Kubernetes cluster networking.
- LocalAI uses EdgeVPN for P2P features.
- k3s appears in the README as an example Kubernetes cluster use case.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
config.yaml
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
config.yaml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
edgevpn | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version0.35.3
manager updated2026-07-07
local dataok
upstreamcurrent
latest detectedv0.35.3
https://github.com/mudler/edgevpn
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:edgevpn |
|---|---|
| Version | 0.35.3 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/edgevpn |
| Homepage | https://mudler.github.io/edgevpn |
| Repository | https://github.com/mudler/edgevpn |
| Upstream docs | https://mudler.github.io/edgevpn |
| License | Apache-2.0 |
| Source archive | https://github.com/mudler/edgevpn/archive/refs/tags/v0.35.3.tar.gz |
| Last updated | 2026-07-07T12:11:08Z |
| Pulse | updated |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | edgevpn |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment