# Install edgevpn with Homebrew

Immutable, decentralized, statically built p2p VPN. Version 0.35.3 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:edgevpn
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install edgevpn
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:edgevpn
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/edgevpn>
- **Version:** 0.35.3
- **Source summary:** Immutable, decentralized, statically built p2p VPN
- **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
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- edgevpn (cli)
- edgevpn (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.35.3
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://github.com/mudler/edgevpn
- Upstream latest detected: v0.35.3 (current)
## 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

- <https://raw.githubusercontent.com/mudler/edgevpn/master/README.md>
- <https://api.github.com/repos/mudler/edgevpn>
- <https://api.github.com/repos/mudler/edgevpn/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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

- Unix: config.yaml

## Credential files

- Unix: config.yaml
## 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:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [dsvpn](https://www.automicvault.com/pkg/brew/dsvpn/) - Shares av.db curated category or tags: cli, networking, vpn.
- [macosvpn](https://www.automicvault.com/pkg/brew/macosvpn/) - Shares av.db curated category or tags: cli, networking, vpn.
- [sstp-client](https://www.automicvault.com/pkg/brew/sstp-client/) - Shares av.db curated category or tags: cli, networking, vpn.
- [tinc](https://www.automicvault.com/pkg/brew/tinc/) - Shares av.db curated category or tags: cli, networking, vpn.
- [boringtun](https://www.automicvault.com/pkg/brew/boringtun/) - Shares av.db curated category or tags: cli, networking, vpn.
- [fastd](https://www.automicvault.com/pkg/brew/fastd/) - Shares av.db curated category or tags: cli, networking, vpn.
- [headscale-cli](https://www.automicvault.com/pkg/brew/headscale-cli/) - Shares av.db curated category or tags: cli, networking, vpn.
- [nebula](https://www.automicvault.com/pkg/brew/nebula/) - Shares av.db curated category or tags: cli, networking, vpn.

## Combined YAML source

View the package source record on GitHub. [combined/edgevpn.yml](https://github.com/automic-vault/db/blob/main/combined/edgevpn.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
