SPDX-License-Identifier: GPL-3.0-only SPDX-FileCopyrightText: Copyright 2022 n2n contributors SPDX-FileCopyrightText: Copyright Hamish Coleman

n3n is a lightweight Peer-to-Peer VPN that creates virtual networks.

In order to start using n3n, two elements are required:

• A supernode: it allows edge nodes to announce and discover other nodes. It must have a port publicly accessible on internet.
• edge nodes: the nodes which will be a part of the virtual networks

A virtual network shared between multiple edge nodes in n3n is called a community. A single supernode can relay multiple communities and a single computer can be part of multiple communities at the same time (by running multiple edge daemons). An encryption key can be used by the edge nodes to encrypt the packets within their community.

n3n tries to establish a direct peer-to-peer connection via udp between the edge nodes when possible. When this is not possible (usually due to special NAT devices), the supernode is also used to relay the packets.

    [edge-A] ──────────────────── [edge-B]
          \      direct p2p        /
           \                      /
            └──── [supernode] ────┘
                (discovery + relay)

n3n was originally based on an older n2n project and hopes to keep protocol compatibility with that.

Note that some distributions have very old versions of n2n packaged that are incompatible with the protocol used by n3n. At the least, Debian has a n2n version 1.3.1 which uses a protocol from 2008 and has not been compatible with the stable releases of n2n for many years - thus will definitely not interoperate with n3n)

• License
• Quick Start Guides
• Building from Source
• Contributing

• Configure
• Answers to frequently asked questions (FAQ).
• Details about the internals in the Hacking guide.