From 09916efcf0fdd17df1aac5e83033467028bb6348 Mon Sep 17 00:00:00 2001
From: TC Johnson <tc@veilid.org>
Date: Mon, 18 Sep 2023 08:57:26 -0500
Subject: [PATCH] Add bootstrap setup instructions

Guide to setting up bootstrap servers
---
 # Starting a Bootstrap.md | 76 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100755 # Starting a Bootstrap.md

diff --git a/# Starting a Bootstrap.md b/# Starting a Bootstrap.md
new file mode 100755
index 00000000..f4dd3b5f
--- /dev/null
+++ b/# Starting a Bootstrap.md	
@@ -0,0 +1,76 @@
+# 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         |