wg-meshconf/README.md

85 lines
1.9 KiB
Markdown
Raw Normal View History

2018-10-14 00:57:04 +02:00
# WireGuard Mesh Configurator
2018-11-19 07:20:10 +01:00
## 1.1.6 (November 19, 2018)
2018-10-19 20:40:09 +02:00
2018-11-19 07:20:10 +01:00
1. Peers can now be deleted via the `DeletePeer` command.
1. Peers are now added one by one via the `AddPeer` command.
2018-10-15 19:13:01 +02:00
2018-10-14 00:57:04 +02:00
## Introduction
WireGuard mesh configurator is a tool that will help you generating peer configuration files for wireguard mesh networks. You generate configuration files for a large amount of peers easily and quickly via this tool.
## Gallery
2018-10-14 23:59:24 +02:00
![new_profile](https://user-images.githubusercontent.com/21986859/46922682-bb7aaf80-cfda-11e8-812e-b2458009302a.png)
*Creating a new mesh profile*
![save_load](https://user-images.githubusercontent.com/21986859/46922686-c9303500-cfda-11e8-9685-062a8a24ed27.png)
*Saving and Loading Profiles*
2018-10-14 00:57:04 +02:00
2018-10-15 18:30:53 +02:00
![generated_configs](https://user-images.githubusercontent.com/21986859/46964450-17464680-d076-11e8-9306-bfe69a88c858.png)
2018-10-14 00:57:04 +02:00
*Generated configuration files*
## Usages
2018-10-15 19:35:18 +02:00
### Installing WGC
2018-10-14 00:57:04 +02:00
Clone the repository and enter it.
```
$ git clone https://github.com/K4YT3X/wireguard-mesh-configurator.git
$ cd wireguard-mesh-configurator/
```
2018-10-15 19:35:18 +02:00
Run the tool.
2018-10-14 00:57:04 +02:00
```
2018-10-15 19:35:18 +02:00
$ python3 wireguard_mesh_configurator.py interactive
2018-10-14 00:57:04 +02:00
```
2018-10-15 19:35:18 +02:00
or
```
$ python3 wireguard_mesh_configurator.py int
```
### Creating a Profile
Run the `NewProfile` command to create a new profile.
```
[WGC]> NewProfile # Create new profile
```
Then the peer enrolling wizard will ask you for all the information needed for all the peers. Select `n` when being asked if you want to add a new peer to end the wizard.
### Generating Configurations
Run the following command to dump your currently-loaded profile into configuration files and export them to `output path`.
2018-10-14 00:57:04 +02:00
```
2018-10-15 19:35:18 +02:00
[WGC]> GenerateConfigurations [output path]
2018-10-14 00:57:04 +02:00
```
2018-10-15 19:35:18 +02:00
### Viewing All Peers
To view all the peers configurations in the current profile:
```
[WGC]> ShowPeers
```
### Saving / Loading Profiles
To save a profile:
```
[WGC]> SaveProfile [output path]
```
To load a profile:
```
[WGC]> LoadProfile [output path]
```