veilid/# Starting a Bootstrap.md
TC Johnson 09916efcf0
Add bootstrap setup instructions
Guide to setting up bootstrap servers
2023-09-18 08:57:26 -05:00

2.2 KiB
Executable File

Starting a Veilid Bootstrap Server

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