Quick Start Guide

Updated on July 29, 2025

Welcome to VeilNet Conflux, the all-in-one binary for secure, post-quantum overlay networking. This guide will get you up and running with your own node in minutes.

 

🚀 What is VeilNet Conflux? #

VeilNet Conflux allows you to access a decentralized, post-quantum secure overlay network, aka your personal Dark Web. It combines clients and exit nodes (Rifts and Portals) into a single binary.

  • 🔐 Post-Quantum Encryption (Kyber KEM and Dilithium)

  • 🧠 Smart Routing via Software-Defined Network and Reinforcment Learning

  • ⚙️ Scalable, Modular Microservices, Deploy as many as you want!

  • 🕶️ Fully Decentralized & Anonymous

For more, visit veilnet.org or the GitHub repository.

 

✅ Requirements #

  • Linux, Windows, or macOS (⚠️ macOS is experimental)

  • Admin/root access

  • A VeilNet Console account

  • A valid Conflux token from the Guardian service

 

🧱 2. Install VeilNet Conflux #

Option A: Native Binary #

  1. Download the binary for your OS from Releases

  2. Make it executable:

chmod +x veilnet-conflux

📝 3. Register a New Conflux #

Use this if you want to register from CLI:

./veilnet-conflux register \
  --email <your_email> \
  --password <your_password> \
  --name <conflux_name> \
  --plane <plane_name> \
  --tag <any>

This will register a new conflux with given name and tag, and returns a unique token to you. Pleae keep the token safe because it is reusable as long as this conflux is not unregistered, and it will only be displayed once!

📡 4. Connect to VeilNet #

To run as Portal:

sudo ./veilnet-conflux up -t <your-conflux-token> -p

It is recommended to run Portal on host you are intended to use as a gateway to local networks or services.

For example, deploy VeilNet conflux before deploying Home Assistant. Then, as long as you on any other machine with VeilNet conflux deployed, you will be able to access your Home Assitant from any where by the VeilNet virtual IP! Even if it does not have a public IP address!

Of course, you can deploy VeilNet conflux (Portal Mode) on multiple hosts belonging to different cloud, and create a cross-region Kubernetes cluster! Be gone Tailscale!

To run as Rift mode, aka using as a VPN client, simply remove the “-p” flag. Please note that conflux in Rift mode will be emphemeral, meaning when it is disconnected, all information including the token related to it will be gone forever.