Amnezia quick start

The Amnezia module in the BeAdmin panel runs your own VPN on the server, based on AmneziaWG — a WireGuard fork with traffic obfuscation. The masking keeps the connection resilient to deep packet inspection (DPI) and preserves access where plain WireGuard no longer gets through. Obfuscation parameters are generated automatically — the panel sets up the server side, the keys, and the network interface on its own.

This article walks through the minimum scenario: install the module, create the first user, and connect a client device.

ℹ️ Note

Your own VPN server pays off compared with commercial services: bandwidth is not split between hundreds of clients, and the obfuscation parameters are unique to each server — which lowers the risk of falling under mass blocking.

⚠️ 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.

You'll need a server with BeAdmin — our partners ship a ready‑to‑use VPS the moment you order.

Proven over 15 years in hosting. Your VPS with BeAdmin is ready to go out of the box.

• Germany
• Netherlands
• Sweden
• Switzerland
• Spain
• USA

Select server

European reliability made simple. Launch BeAdmin with your VPS in just one click.

• Germany
• Netherlands
• Sweden
• Estonia
• Romania
• Switzerland
• Spain
• United Kingdom
• USA

Sign up

Installing the module

In the side menu open VPN → Amnezia and click Install — the module installs right away, without a dialog, and is ready to use. Amnezia accepts connections on UDP port 443 — masking works best there — if the port is free: neither Nginx nor Apache is installed and no other BeAdmin module holds it. If 443 is taken, the panel picks 51720.

To set the port yourself (for example, 80 or 8443), click the gear button next to Install (tooltip Custom installation) — the Installation settings dialog opens with a Port field. It already contains 443: keep it or enter another number and click Launch. If 443 is taken by another BeAdmin module, a conflict warning appears under the field right away: you can still install, but the service won't start until the port is freed.

When installation finishes, the panel takes you straight to the Users page — the module's main screen. Installation usually takes a few minutes; you can follow the progress via the Log button on the install card.

After installation

The page header exposes the core module actions — start, stop, and restart. The three-dot menu groups the rest: module settings, update check and run, reinstall, and uninstall.

To get started, create the first user.

Creating the first user

An Amnezia user is a separate account with its own key pair and configuration file. We recommend creating a separate user per device that will connect: that way you can revoke access for a single device without touching the others.

1. On the Users page click Create user.
2. Fill in the fields:
   • Identifier — 2 to 32 characters: Latin letters, digits, and hyphens. The field is prefilled and adjusts to Name until you edit it by hand. The identifier must be unique and can't be changed after creation.
   • Name — an optional field of up to 64 characters: for example, "John Smith". The list shows the user under this name, or under the identifier if no name is set.
   • Email — optional. Useful if SMTP is configured in the panel and you want to email the user their configuration; the address is not needed for the connection itself.
   • Comment — an optional label up to 64 characters: for example, "Anna's iPhone" or "work laptop". Helps you navigate the list.
   • User language — the language of the configuration email. Default — English.
3. By default the user is created enabled — turn off the Enabled toggle in the dialog footer if you want to create it disabled.
4. Click Create.

The user appears in the list. The server generates a key pair and assembles the configuration — you can grab it right away.

ℹ️ Limit on the free plan

The free licence allows one Amnezia user — enough to try the service out and see whether it fits. When you need more, purchase additional slots. Details — in Amnezia. Managing users.

ℹ️ Default DNS and keepalive

When a user is created, the panel sets DNS to 1.1.1.1 from Cloudflare and the persistent keepalive interval to 25 seconds. You can change these values later in the edit dialog — details in Amnezia. Managing users.

Connecting a client device

1. In the users list click a row — QR codes and config file download buttons appear.
2. In the expanded row you have:
   • QR codes — on the AmneziaVPN and AmneziaWG tabs. AmneziaVPN uses the "container" format for the multi-protocol client of the same name; AmneziaWG uses the plain AmneziaWG config for AmneziaWG clients.
   • Download .conf — downloads the file in the AmneziaWG format. The file name matches the user's identifier.
   • Email — sends the same .conf file to the user's address (if SMTP is configured in the panel and the address is set).
3. Install the client app on the device — AmneziaVPN or AmneziaWG — and import the right QR code or .conf file: which app to pick and what to tap inside it — see the steps for every platform in Amnezia. Setting up client apps.

⚠️ Which QR to scan

The QR codes on the AmneziaVPN and AmneziaWG tabs are different: they hold different configuration formats. If you scan the wrong one, the app will either refuse to accept it or the connection won't work. Match the QR to the active tab.

To confirm the VPN is working, open any IP-check page in your browser, for example myip.com. If everything is set up right, it will show your server's country.

What's next

• Amnezia. Managing users — adding users, editing, emailing the configuration, purchasing slots beyond the free quota.
• Amnezia. Managing the module — starting and stopping the service, changing the UDP port, updating, and uninstalling the module.