Search Results

In this Chapter you will gain some knowledge on the design decisions and background surrounding this project.

Networking Setup

In this chapter, you will gain the know-how to set up wireguard and BIRD to share routes across the network.

Formalities

Documentation Design/Background

This chapter explains the formalities of the network, including the registration process.

This project is inspired by the likes of DN42, PeerIX, and EFTI (which faltered in the early stages). The primary purpose of this project is to create an Internet-Lite environment where participants are able to employ Internet technologies in a private, learni...

Technologies

This page will outline the technologies in use on the network. Border Gateway Protocol The Border Gateway Protocol will be used by participants to exchange routes between routers on the network. Domain Name System The Domain Name System will be used by partici...

Address Space

Documentation Design/Background

IPv4 Similar to other pre-existing projects, NX3 will use an RFC-1918 private address network to assign public IP addresses to clients. As to not interfere with DN42, ChaosVPN, or any other well known projects, NX3 will use the 172.24.0.0/14 network. This spa...

Autonomous Systems

Documentation Design/Background

All Autonomous System Numbers (ASNs) will be chosen arbitrarily in the NX3 ASN space. This space will be defined as the 4266030000 through 4266033999 ASN range. Should AS numbers be exhausted, future expansion will be considered. This range was chosen as it is...

Introduction

Documentation Networking Setup

Welcome to the NX3 Project! An Internet overlay network that uses real world technologies to create an inter-connected network!

Initial Setup

For the purpose of this guide, I will assume that you are using an Ubuntu 22.04 based virtual machine with a public IP address that is routeable across the internet. Instructions for other systems are similar, but may be slightly more involved. Pre Setup Bef...

ROA Setup

Documentation Networking Setup

By default, BIRD inherently trusts all routes that have been announced to it by its' peers. This means that a bad actor would be able to enter the network, and announce routes that it doesn't actually own. To partially solve this problem, you can use ROA (Rout...

Requirements

To participate in the NX3 network, there are several requirements: You have at least one router running 24/7. Any Linux or BSD Box can be turned into a router. If your home router runs OpenWRT, you might consider using it for NX3. Your router is abl...

Register

In order to get started, you need to create several objects in the NX3 registry: https://git.brettb.xyz/nx3/registry. The registry is a git repository. You create objects by forking the main repository, making your changes, and then submitting a pull request ...

Finishing Up

Get Some Peers In NX3, there is no distinction between peering and transit. In most cases, everybody serves as an upstream provider to all of their peers. If you have very slow connectivity to the internet, you may want to avoid providing transit between peer...

Quick Connect

Are you only looking to quickly connect to the NX3 network? You can use ZeroTier to gain transit into the network. Download and Install ZeroTier First, you'll want to download & install ZeroTier. You can do so at this page. Join the Network Next, you'll wa...

Caddy

To host websites on NX3, Caddy is highly recommended due to its' easy configuration, and the ability to automatically acquire SSL certificates for your websites using a different directory URL. Install Caddy To install Caddy it is recommended to follow the i...

Run a Service On Another IP

Documentation Provided Services

Want to run your service on an IP other than your machine's main NX3 IP? You can do that! All you need to do is create a dummy interface on your machine by creating 2 files in /etc/systemd/network First up is the dummy device itself: /etc/systemd/network/10...

Registry Explorer

The NX3 Registry Explorer is essentially the DN42 Registry Explorer created by Burble, slightly modified and re-branded as the NX3 Registry Explorer. This documentation does not include how to containerize or make the modifications to branding/returning full ...

Certificate Authority

Documentation Provided Services

For more information on the Step Certificate Authority and how to install it, it is highly recommended to check out their own documentation. These instructions are intentionally short as security considerations are often changing, and information provided her...

ErgoIRC

Want to start an IRC Server, because why not? Go for it! Quick Start Download the latest release from this page: https://github.com/ergochat/ergo/releases/latest Extract it into a folder, then run the following commands: cp default.yaml ircd.yaml vim ircd...

Gitea