diff options
author | Simon Garrelou <simon@sixfoisneuf.fr> | 2023-05-24 21:56:31 +0200 |
---|---|---|
committer | Simon Garrelou <simon@sixfoisneuf.fr> | 2023-05-24 21:56:31 +0200 |
commit | 0df7459ab08acce1fb983f9e00026c4695e8fc19 (patch) | |
tree | e371d5fadcf37a53f368358bb9f2035e3e014963 | |
parent | 39131d86821c7715281db7e10ea52d7323c23362 (diff) | |
download | wgmgr-0df7459ab08acce1fb983f9e00026c4695e8fc19.tar.gz wgmgr-0df7459ab08acce1fb983f9e00026c4695e8fc19.zip |
Add usage to README
-rw-r--r-- | README.md | 30 |
1 files changed, 30 insertions, 0 deletions
@@ -4,6 +4,16 @@ | |||
4 | 4 | ||
5 | It 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. | 5 | It 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 | ||
7 | Be 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 | ||
12 | my_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 | ||
9 | Create the application configuration file, at `/etc/wgmgr.toml`: | 19 | Create the application configuration file, at `/etc/wgmgr.toml`: |
@@ -24,6 +34,26 @@ ListenPort = 51820 | |||
24 | Address = 10.8.0.1/24 | 34 | Address = 10.8.0.1/24 |
25 | ``` | 35 | ``` |
26 | 36 | ||
37 | ## Usage | ||
38 | |||
39 | ``` | ||
40 | Usage: wgmgr [OPTIONS] <COMMAND> | ||
41 | |||
42 | Commands: | ||
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 | |||
50 | Options: | ||
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 | ||
29 | Please 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. | 59 | Please 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. |