veilid/BOOTSTRAP-SETUP.md
TC Johnson 618b092e8b
Add private or dev network setup docs
Guides and config templates for use in setting up private
Veilid networks for independent or development needs.
2023-09-21 08:24:09 -05:00

2.3 KiB
Executable File

Starting a Generic/Public Veilid Bootstrap Server

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

Install Veilid

Follow instructions in INSTALL.md

Configure Veilid as Bootstrap

Stop the Veilid service

sudo systemctl stop veilid-server.service

Setup the config

In /etc/veilid-server/veilid-server.conf` ensure bootstrap: ['bootstrap.<your.domain>'] in the routing_table: section

If you came here from the dev network setup guide, this is when you set the network key.

Switch to veilid user

sudo -u veilid /bin/bash

Generate a new keypair

Copy the output to secure storage such as a password manager. This information will be used in the next step and can be used for node recovery, moving to a different server, etc.

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 requested interactively 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. This information will be use to setup DNS records.

veilid-server --dump-txt-record

Start the Veilid service

Disconnect from the Veilid user and start veilid-server.service.

exit
sudo systemctl start veilid-server.service

Optionally configure the service to start at boot sudo systemctl enable 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