veilid/BOOTSTRAP-SETUP.md

Starting a Veilid Bootstrap Server

Instance Recommended Setup

CPU: Single RAM: 1GB Storage: 25GB IP: Static v4 & v6 Firewall: 5150/TCP/UDP inbound allow all

Install Veilid

As root

wget -O- https://packages.veilid.net/keys/veilid-packages-key.public | gpg --dearmor -o /usr/share/keyrings/veilid-packages-keyring.gpg

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/veilid-packages-keyring.gpg] https://packages.veilid.net/repos stable main" > /etc/apt/sources.list.d/veilid.list

apt update && apt install veilid-server veilid-cli

Configure Veilid

As root

Stop the Veilid service

systemctl stop veilid-server.service

Setup the config

In /etc/veilid-server/veilid-server.conf` ensure bootstrap: ['bootstrap.veilid.net'] in the routing_table: section

Switch to veilid user

sudo -u veilid /bin/bash

Generate a new keypair

Copy the output to secure storage.

veilid-server --generate-key-pair

Create new node ID and flush existing route table

Include the brackets [] when pasting the keys. Use the public key in the command. Secret key will be request interacitvly and will not echo when pasted.

veilid-server --set-node-id [PUBLIC_KEY] --delete-table-store

Generate the DNS TXT record

Copy the output to secure storage.

veilid-server --dump-txt-record

Switch back to root

Start the Veilid service

systemctl start veilid-server.service

REPEAT FOR EACH BOOTSTRAP SERVER

Enter DNS Records

Create the following DNS Records for your domain:

(This example assumes two bootstrap serves are being created)

Record	Value	Record Type
bootstrap	1,2	TXT
1.bootstrap	IPv4	A
1.bootstrap	IPv6	AAAA
1.bootstrap	output of --dump-txt-record	TXT
2.bootstrap	IPv4	A
2.bootstrap	IPv6	AAAA
2.bootstrap	output of --dump-txt-record	TXT