isle/docs/admin/adding-a-host-to-the-network.md

44 lines
1.3 KiB
Markdown
Raw Normal View History

# Adding a Host to the Network
This document guides an admin through adding a single host to the network. Keep
in mind that the steps described here must be done for _each_ host the user
wishes to add.
## Step 1: Choose Hostname
The user will need to provide you with a name for their host. The name should
conform to the following rules:
* It should only contain lowercase letters, numbers, and hyphens.
* It should begin with a letter.
* It should end with a letter or number.
2022-10-30 00:22:03 +00:00
## Step 2: Choose IP
The admin should choose an IP for the host. The IP you choose for the new host
2024-07-07 11:37:26 +00:00
should be one which is not yet used by any other host and is in a subnet which
was configured when creating the network.
## Step 3: Create a `bootstrap.json` File
To create a `bootstrap.json` file for the new host, the admin should perform the
following command from their own host:
```
isle hosts create \
2022-11-05 11:34:49 +00:00
--hostname <name> \
2022-10-30 00:22:03 +00:00
--ip <ip> \
> bootstrap.json
```
2024-07-07 11:37:26 +00:00
The resulting `bootstrap.json` file should be treated as a secret file and
shared only with the user it was generated for. The `bootstrap.json` file should
2024-07-07 11:37:26 +00:00
not be re-used between hosts.
The user can now proceed with calling `isle network join`, as described in the
[Getting Started][getting-started] document.
2024-07-07 11:37:26 +00:00
[getting-started]: ../user/getting-started.md