DavHau/clan-core
1
0
Fork 0
forked from clan/clan-core
Code Pull Requests Activity

docs: improve docs

Browse Source
This commit is contained in:
Johannes Kirschbauer 2024-04-26 11:20:43 +02:00
parent 152a908dc9
commit 94449a02d5
Signed by: hsjobeki
SSH Key Fingerprint: SHA256:vX3utDqig7Ph5L0JPv87ZTPb/w7cMzREKVZzzLFg9qU
1 changed files with 21 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
docs/site/getting-started/networking.md
View File

@ -26,7 +26,7 @@ peers. Once addresses are allocated, the controller's continuous operation is no
1. **Designate a Machine**: Label a machine as the VPN controller in the clan, 1. **Designate a Machine**: Label a machine as the VPN controller in the clan,
referred to as `<CONTROLLER>` henceforth in this guide. referred to as `<CONTROLLER>` henceforth in this guide.
1. **Add Configuration**: Input the following configuration to the NixOS 2. **Add Configuration**: Input the following configuration to the NixOS
configuration of the controller machine: configuration of the controller machine:
```nix ```nix
clan.networking.zerotier.controller = { clan.networking.zerotier.controller = {
@ -34,7 +34,7 @@ peers. Once addresses are allocated, the controller's continuous operation is no
public = true; public = true;
}; };
``` ```
1. **Update the Controller Machine**: Execute the following: 3. **Update the Controller Machine**: Execute the following:
```bash ```bash
$ clan machines update <CONTROLLER> $ clan machines update <CONTROLLER>
``` ```
@ -56,22 +56,25 @@ To introduce a new machine to the VPN, adhere to the following steps:
$ clan machines update <NEW_MACHINE> $ clan machines update <NEW_MACHINE>
``` ```
Replace `<NEW_MACHINE>` with the designated new machine name. Replace `<NEW_MACHINE>` with the designated new machine name.
1. **Retrieve the ZeroTier ID**: On the `new_machine`, execute:
```bash !!! Note "For Private Networks"
$ sudo zerotier-cli info 1. **Retrieve the ZeroTier ID**: On the `new_machine`, execute:
``` ```bash
Example Output: $ sudo zerotier-cli info
```{.console, .no-copy} ```
200 info d2c71971db 1.12.1 OFFLINE Example Output:
``` ```{.console, .no-copy}
, where `d2c71971db` is the ZeroTier ID. 200 info d2c71971db 1.12.1 OFFLINE
1. **Authorize the New Machine on the Controller**: On the controller machine, ```
execute: , where `d2c71971db` is the ZeroTier ID.
```bash 2. **Authorize the New Machine on the Controller**: On the controller machine,
$ sudo zerotier-members allow <ID> execute:
``` ```bash
Substitute `<ID>` with the ZeroTier ID obtained previously. $ sudo zerotier-members allow <ID>
1. **Verify Connection**: On the `new_machine`, re-execute: ```
Substitute `<ID>` with the ZeroTier ID obtained previously.
2. **Verify Connection**: On the `new_machine`, re-execute:
```bash ```bash
$ sudo zerotier-cli info $ sudo zerotier-cli info
``` ```