aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSimon Garrelou <simon@sixfoisneuf.fr>2023-05-24 21:56:31 +0200
committerSimon Garrelou <simon@sixfoisneuf.fr>2023-05-24 21:56:31 +0200
commit0df7459ab08acce1fb983f9e00026c4695e8fc19 (patch)
treee371d5fadcf37a53f368358bb9f2035e3e014963
parent39131d86821c7715281db7e10ea52d7323c23362 (diff)
downloadwgmgr-0df7459ab08acce1fb983f9e00026c4695e8fc19.tar.gz
wgmgr-0df7459ab08acce1fb983f9e00026c4695e8fc19.zip
Add usage to README
-rw-r--r--README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
index 0b5b06f..404febc 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,16 @@
4 4
5It handles client creation and removal, and will auto-generate the corresponding private and public keys. It can also generate the configuration file for each client. 5It handles client creation and removal, and will auto-generate the corresponding private and public keys. It can also generate the configuration file for each client.
6 6
7Be aware that the clients' private keys will be stored on the server in order to simplify the config file generation. This is par for the course for Wireguard managers, but it bears repeating.
8
9```
10$ wgmgr add my_new_laptop
11$ wgmgr ls
12my_new_laptop | 10.8.0.2
13$ wgmgr config --type split my_new_laptop
14<copy-paste the configuration to your laptop>
15```
16
7## Setting up 17## Setting up
8 18
9Create the application configuration file, at `/etc/wgmgr.toml`: 19Create the application configuration file, at `/etc/wgmgr.toml`:
@@ -24,6 +34,26 @@ ListenPort = 51820
24Address = 10.8.0.1/24 34Address = 10.8.0.1/24
25``` 35```
26 36
37## Usage
38
39```
40Usage: wgmgr [OPTIONS] <COMMAND>
41
42Commands:
43 ls List known clients
44 config Generate the configuration file for a client
45 add Add a new client to your VPN
46 rm Remove a client from your VPN
47 wg Run 'wg', but with the client names
48 help Print this message or the help of the given subcommand(s)
49
50Options:
51 -w, --wgconfig <WGCONFIG> Wireguard configuration file name
52 -c, --config <CONFIG> wgmgr configuration file path
53 -h, --help Print help
54 -V, --version Print version
55```
56
27## Reporting bugs 57## Reporting bugs
28 58
29Please report any bugs you find to [bugs+wgmgr@sixfoisneuf.fr](mailto:bugs+wgmgr@sixfoisneuf.fr). Contributions are welcomed, as long as they follow the [git send-email](https://git-send-email.io) format. 59Please report any bugs you find to [bugs+wgmgr@sixfoisneuf.fr](mailto:bugs+wgmgr@sixfoisneuf.fr). Contributions are welcomed, as long as they follow the [git send-email](https://git-send-email.io) format.