From 1e27df2aee49a19f0b2c492d74ed0821f94aee7f Mon Sep 17 00:00:00 2001 From: TC Date: Mon, 18 Sep 2023 14:10:19 +0000 Subject: [PATCH] Update BOOTSTRAP-SETUP.md --- BOOTSTRAP-SETUP.md | 142 +++++++++++++++++++++------------------------ 1 file changed, 66 insertions(+), 76 deletions(-) diff --git a/BOOTSTRAP-SETUP.md b/BOOTSTRAP-SETUP.md index f4dd3b5f..4aa08c0d 100755 --- a/BOOTSTRAP-SETUP.md +++ b/BOOTSTRAP-SETUP.md @@ -1,76 +1,66 @@ -# 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** - - ```shell -wget -O- https://packages.veilid.net/keys/veilid-packages-key.public | gpg --dearmor -o /usr/share/keyrings/veilid-packages-keyring.gpg -``` -```shell -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 -``` -```shell -apt update && apt install veilid-server veilid-cli -``` - -## Configure Veilid -**As root** - -### Stop the Veilid service -```shell -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** -```shell -sudo -u veilid /bin/bash -``` - -### Generate a new keypair -Copy the output to secure storage. -```shell -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. -```shell -veilid-server --set-node-id [PUBLIC_KEY] --delete-table-store -``` -### Generate the DNS TXT record -Copy the output to secure storage. -```shell -veilid-server --dump-txt-record -``` - -**Switch back to root** -### Start the Veilid service -```shell -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 | +# 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 +Follow instructions in [INSTALL.md](./INSTALL.md) + +## Configure Veilid +**As root** + +### Stop the Veilid service +```shell +systemctl stop veilid-server.service +``` + +### Setup the config +In _/etc/veilid-server/veilid-server.conf`_ ensure _bootstrap: ['bootstrap.']_ in the _routing_table:_ section + +**Switch to veilid user** +```shell +sudo -u veilid /bin/bash +``` + +### Generate a new keypair +Copy the output to secure storage. +```shell +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. +```shell +veilid-server --set-node-id [PUBLIC_KEY] --delete-table-store +``` +### Generate the DNS TXT record +Copy the output to secure storage. +```shell +veilid-server --dump-txt-record +``` + +**Switch back to root** +### Start the Veilid service +```shell +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 |