I am building a Wireguard VPN network, in which I want to add and remove peers on the server without restarting the service or losing connections with existing peers. Tried searching for the results, but I found nothing that can suit my needs (all the solutions will cause a few second freeze or will require clients to redo handshake with server). Is it possible to implement this with Wireguard and if yes, how?


3 Answers 3


I'm working on a similar project, and my conclusion is that you're better off keeping all configuration inside your own database, and completely skipping wireguard config files for the peer setup. You might still want to use the wireguard config file for the [Interface] section, which my example below uses. But you could do that programmatically too, should you need to.

So, assuming we have an interface called wg0, defined in /etc/wireguard/wg0.conf

ListenPort = 51820
Address =
PrivateKey = <your private key>

In the above config, there are zero peers.

Add a new peer:

wg set wg0 peer "K30I8eIxuBL3OA43Xl34x0Tc60wqyDBx4msVm8VLkAE=" allowed-ips
ip -4 route add dev wg0

Remove a peer:

wg set wg0 peer "K30I8eIxuBL3OA43Xl34x0Tc60wqyDBx4msVm8VLkAE=" remove
ip -4 route delete dev wg0

As far as I know, this will not cause downtime for other peers.

The technique I used to figure out the ip -4 route ... commands to run, is simply by using wg-quick up wg0 and taking note of the commands that it spits out.

  • Thanks! Exactly the answer I needed!
    – Anton2319
    Oct 12, 2022 at 18:42
  • 1
    If anyone else is doing this on FreeBSD, the route command is route add -iface wg0
    – kontextify
    Dec 12, 2023 at 13:25
  • Great ans! How do I add postUp and Post down? any command like wg set wg0 postup
    – Emeka Mbah
    Feb 13 at 13:38

You can use wg conjointly with wg-quick. wg is a lower-level command, actually the one used by wg-quick to really do WireGuard-specific configuration on the interface (along various ip xxx commands for the base networking parts).

Its subcommand wg syncconf used conjointly with wg-quick strip is intended to update settings without disruption for current peer communication with changed settings in the configuration file as documented in wg-quick and wg's manpages:

Use strip to output a configuration file with all wg-quick(8)-specific options removed, suitable for use with wg(8).

The strip command is useful for reloading configuration files without disrupting active sessions:

# wg syncconf wgnet0 <(wg-quick strip wgnet0)

syncconf <interface> <configuration-filename>

Like setconf, but reads back the existing configuration first and only makes changes that are explicitly different between the configuration file and the interface. This is much less efficient than setconf, but has the benefit of not disrupting current peer sessions. The contents of must be in the format described by CONFIGURATION FILE FORMAT below.

So to repeat the example, if the configuration for interface wg0, usually used with wg-quick is in /etc/wireguard/wg0.conf (or any other Distribution-specific place) and a [Peer] section was just added (resp. removed) to this file, to make this peer available (resp. not available anymore) without disrupting communication with already configured peers, then run as root in a bash shell:

wg syncconf wg0 <(wg-quick strip wg0)

Some parts will have to be completed manually, since they are not handled by wg, as described in wg-quick's CONFIGURATION section: additional routes, iptables rules...

  • Thanks for the answer, but will wg-strip work with wg addconf? First I want to modify config with wg addconf newpeer.conf, then I want to syncconf and apply those changes. Is it possible?
    – Anton2319
    May 21, 2022 at 17:07
  • I did answer your question. If you have an other question, please submit an other one properly, with the correct context.
    – A.B
    May 21, 2022 at 17:59
  • Very nice answer. This should be the accepted answer.
    – cdhowie
    Dec 8, 2022 at 17:06

If wireguard is started by systemd, there is a command to ask wireguard to reload the configuration:

systemctl reload wg-quick@wg0

Should reload the configuration for the wg0 adapter without restarting the service, and without disrupting current connections.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .