veilid/BOOTSTRAP-SETUP.md

90 lines
2.3 KiB
Markdown
Raw Normal View History

# Starting a Generic/Public Veilid Bootstrap Server
2023-09-18 10:10:19 -04:00
## Instance Recommended Setup
2023-09-18 10:10:19 -04:00
CPU: Single
RAM: 1GB
Storage: 25GB
IP: Static v4 & v6
Firewall: 5150/TCP/UDP inbound allow all
## Install Veilid
2023-09-18 10:10:19 -04:00
Follow instructions in [INSTALL.md](./INSTALL.md)
## Configure Veilid as Bootstrap
### Stop the Veilid service
```shell
sudo systemctl stop veilid-server.service
2023-09-18 10:10:19 -04:00
```
### Setup the config
2023-09-18 10:10:19 -04:00
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](./dev-setup/dev-network-setup.md) guide, this is when you set the network key.
2023-09-18 10:10:19 -04:00
**Switch to veilid user**
2023-09-18 10:10:19 -04:00
```shell
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.
2023-09-18 10:10:19 -04:00
```shell
veilid-server --generate-key-pair VLD0
2023-09-18 10:10:19 -04:00
```
### 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.
2023-09-18 10:10:19 -04:00
```shell
veilid-server --set-node-id [PUBLIC_KEY] --delete-table-store
```
2023-09-18 10:10:19 -04:00
### Generate the DNS TXT record
Copy the output to secure storage. This information will be use to setup DNS records.
2023-09-18 10:10:19 -04:00
```shell
veilid-server --dump-txt-record
```
### Start the Veilid service
Disconnect from the Veilid user and start veilid-server.service.
```shell
exit
```
```shell
sudo systemctl start veilid-server.service
2023-09-18 10:10:19 -04:00
```
Optionally configure the service to start at boot `sudo systemctl enable veilid-server.service`
2023-09-18 10:10:19 -04:00
_REPEAT FOR EACH BOOTSTRAP SERVER_
## Enter DNS Records
2023-09-18 10:10:19 -04:00
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 |