aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlex Auvolat <alex@adnab.me>2023-03-09 17:27:39 +0100
committerAlex Auvolat <alex@adnab.me>2023-03-09 17:27:39 +0100
commitc7dbb05be2440a067221c4cde41e341b4bc1fc57 (patch)
treeef9ce5968e22225b6b0469075ae797ce9676ebb8
parent8792b40061ef039e509431f3fa46d1670a5a7a0f (diff)
downloadwgautomesh-c7dbb05be2440a067221c4cde41e341b4bc1fc57.tar.gz
wgautomesh-c7dbb05be2440a067221c4cde41e341b4bc1fc57.zip
update readme
-rw-r--r--README.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/README.md b/README.md
index 129a34f..e8628c3 100644
--- a/README.md
+++ b/README.md
@@ -13,10 +13,16 @@ Features:
- does not assume all nodes are publicly reachable
- configuration very similar to `wg-quick`: each node needs a list of the credentials of all other nodes in the mesh
-- `wgautomesh` does not create a wireguard interface, it assumes it exists and merely configures the peers attached to it
- ultra simple encrypted gossip protocol over UDP (bincode encoding + xsalsa20poly1305 symmetric encryption)
- automatic discovery of nodes in a same LAN using UDP broadcast (if enabled, nodes will prefer connecting to one another using their LAN IP addresses when available)
- can automatically open ports in your router using IGD/UPnP
+- saves to disk known addresses of peers so that they can be reused on restart (usefull if all addresses have changed and the ones in the config file are no longer relevant)
+
+Remarks/limitations:
-**`wgautomesh` only tries to establish connectivity to the peers specified in its config file**,
+- `wgautomesh` does not create a wireguard interface, it assumes it exists and merely configures the peers attached to it
+- `wgautomesh` only tries to establish connectivity to the peers specified in its config file,
it does not provide facilities for dynamically adding more peers like many wireguard configuration tools do.
+
+`wgautomesh` was built for Deuxfleurs to integrate with our automated NixOS-based configuration management system.
+A preliminary NixOS module for `wgautomesh` can be found [here](https://git.deuxfleurs.fr/Deuxfleurs/nixcfg/src/branch/wgautomesh/nix/wgautomesh.nix)