WireGuard. Managing the module

This article continues from WireGuard quick start. If you have not installed the module and created the first user yet, start there. The topics here cover operations on the module itself: starting and stopping the service, updating, and uninstalling. VPN user management is covered in a separate article — WireGuard. Managing users.

Managing the service

In the top-right corner of the module page, three service controls are available for the WireGuard service: "Start", "Stop", and "Restart".

• "Start" — brings the service up from a stopped state. The button is active only when the service is currently down.
• "Stop" — shuts the service down. All active VPN connections are dropped, and new ones cannot be established.
• "Restart" — stops the service and immediately starts it again. Open connections are dropped. Used if the service has become unstable.

The server applies user list changes on the fly, without restarting the service: adding, disabling, or deleting a user is picked up immediately. However, if the client DNS or persistent keepalive has changed in the user profile, the .conf file on the device needs to be re-imported — see the details in Managing users.

⚠️ Stopping the service drops every VPN connection

While the service is down, no user can connect. Plan stops and restarts for a maintenance window, or notify users in advance.

While the module is being updated or uninstalled, the service controls are temporarily unavailable.

ℹ️ Port

WireGuard runs on UDP port 51820.

⚠️ ISP restrictions

Traffic encryption makes a VPN a reliable way to protect a connection, but in some countries and regions internet providers actively interfere with VPN protocols. Because of this, full availability of the service cannot be guaranteed — regardless of the connection type. If one protocol does not work for you, try another VPN module available in the panel. If none of them work on your network, contact support and we will issue a refund for the license.

SMTP-not-configured alert

The module page header may show an "Email sending not configured" banner with a "Set up" link. It means the panel has no working SMTP — the .conf file cannot be emailed to users. The VPN itself keeps working: the banner concerns email sending only, and downloading the .conf and the QR code in the "Connection settings" dialog stay available. SMTP setup is described in How to set up an SMTP relay for sending emails.

Updating the module

In the module action menu next to the "WireGuard" title, choose "Update WireGuard". The panel pulls the latest WireGuard version from the repository and installs it over the current one. The user list and their keys are preserved.

The update has no confirmation prompt — the action starts right away. While it is running, the header shows an "Updating WireGuard" indicator, and the service controls and menu items are unavailable.

Reinstalling the module

In the module action menu, choose "Reinstall WireGuard". A confirmation dialog opens — click "Confirm". The panel installs the same WireGuard version over the current one and restarts the service. While the reinstall is running, the header shows a "Reinstalling WireGuard" indicator. Use it if the module is running unstably.

ℹ️ Data is preserved

The user list and their active connections stay in place — there is no need to re-import the .conf file on devices. This is what makes a reinstall different from uninstalling and installing the module from scratch.

ℹ️ If a connection doesn't recover

If a user cannot reconnect after the reinstall, disable them in the list, enable them again, and re-import the .conf on the device. If the errors persist, the last resort is to fully uninstall the module and install it again.

Uninstalling the module

In the module action menu, choose "Uninstall WireGuard". The panel asks you to confirm and warns that all user connection settings will be removed together with the module; the module can be installed again afterwards.

‼️ Uninstalling the module wipes every VPN user

The action is irreversible: along with the module, all WireGuard users, their keys, and the generated .conf configuration files are deleted. Already imported client configurations will not be able to connect afterwards. After a reinstall, the module and the users have to be created from scratch; new keys will be issued, and clients will need to re-import their .conf.

After confirmation, the panel starts the uninstall; the process is shown as an "Uninstalling WireGuard" indicator in the header. When it finishes, the module page returns to its initial state with the "Install" button.

Task log

The module page header has a link to the module task log. It records every lifecycle operation triggered on the module — install, update, uninstall — along with their statuses and execution logs. Useful when an installation or update fails and you need to find the cause.

Useful links

• WireGuard quick start — installing the module and the first connection.
• WireGuard. Managing users — creating, editing, and deleting users.