Amnezia. Managing users

This article covers operations on the VPN user list: how the list is organised, how to get a configuration for connecting, edit a user, temporarily disable or delete it, and purchase slots beyond the free quota. The minimum "install the module and connect the first device" scenario is described in Amnezia quick start; here we go into more detail.

The user list

The list opens on the Amnezia module page by default and contains every created user with its current state. Above the list, the number of free licence slots remaining is shown — it tells you whether there is room for a new user. A user is created with the Create user button; at the limit the button becomes inactive, and a tooltip explains why. Details on the limit and slots — in the User limit section.

Each user is an accordion row. In its collapsed form, it shows the name, optionally the email address, and an Enabled toggle for temporary deactivation. Per-user actions — issuing a configuration, sending it by email, editing, and deletion — appear when the row is expanded: click the row to expand it.

When there are no users yet

Right after install the list is empty: the panel shows a Nothing here yet card with a prompt to create the first user and a Create user button. Once the first user is created the card disappears, and the usual list takes its place.

Expanded user row

The expanded row is where the user gets a configuration for the device: two QR code formats, downloading the .conf file, sending it by email, and also editing and deleting the user.

QR codes

Right under the avatar, the row shows two QR codes — on the AmneziaVPN and AmneziaWG tabs. They hold different formats:

• AmneziaVPN — the "container" format for the multi-protocol client of the same name (Windows, macOS, Linux, Android, iOS).
• AmneziaWG — a plain AmneziaWG config for the client of the same name (Windows, Android, iOS).

Show the user the active QR code on the screen so it can be scanned with the device's camera — or save the image with the QR code button and send it however you like.

The .conf file

The Download .conf button saves the config in the AmneziaWG format — the file name matches the user name. On a computer, both clients — AmneziaVPN and AmneziaWG — import the file directly; on a smartphone you can open it via the app's file import.

Sending by email

The Email button sends the .conf file to the address from the user's card. It is available when SMTP is configured in the panel and the user has an email address. Otherwise the button is inactive — the tooltip says exactly what is missing: SMTP is not configured or the address is empty.

Editing and deletion

The Edit button opens the dialog with the user's settings (details in the Editing a user section). The Delete button starts deletion — details in the Deleting a user section.

Email and comment tiles

Below the buttons there are tiles with the user's email and comment (when they are filled in). The fields themselves are edited in the Edit user dialog.

When SMTP is not configured

When SMTP is off, the expanded row shows the note Email sending is not configured on the server. with a Go to settings link — it leads to the panel's system settings, where the SMTP relay is enabled. Until the relay is configured, the Email button stays inactive; downloading the .conf file and the QR codes work regardless. Details on configuring the relay — in How to set up an SMTP relay for sending email.

Creating a user

The minimum scenario is described in Amnezia quick start: open the dialog with the Create user button in the list header and fill in the Username, Email, Comment, User language fields; the Enabled toggle in the footer controls the user's state right after creation. The Create button is active as long as the form has no validation errors and there is a free slot in the licence (see User limit).

ℹ️ 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 (service packets that keep the connection alive through NAT and public Wi-Fi). You can change both values later in the edit dialog.

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

Editing a user

In the expanded row click Edit — the Edit user dialog opens with a reminder that after saving you will need to re-import the new settings into the client device: the old configuration in the app keeps working with the old parameters until it is reloaded.

The dialog lets you change:

• Email and Comment — edited under the same rules as on creation. To clear a value, leave the field empty and save: the panel will wipe it on the server.
• DNS server — the DNS that goes into the client config ([Interface] DNS = ...). A free-text field, 1.1.1.1 by default. Specifying a DNS server helps avoid leaking DNS queries to the provider's local network.
• Persistent keepalive — when enabled, the client sends a service packet every 25 seconds so the connection is not dropped on NAT and public Wi-Fi. When disabled, keepalive is not used.
• User language — the language of the configuration email. Default — English.
• Enabled — lets you temporarily disable the account without deleting it.

The username is read-only in this dialog — an existing user cannot be renamed. The Save button is active only when something in the form has changed compared to the current state.

Enabling and disabling a user

There is a toggle in the user row — one tap enables or disables the account without opening a dialog. A disabled user stays in the list, but cannot connect with its keys. The changes are applied right away — no service restart is required.

When re-enabled, the keys are not reissued: the same .conf file already saved in the client app works again.

Deleting a user

In the expanded row click Delete. The panel asks you to confirm the action in the Delete user dialog, with a note that active connections will be dropped and a new configuration will be needed to reconnect. After confirmation the licence slot is freed — another user can be created in its place.

‼️ Deleting a user is irreversible

After confirmation the account is deleted and the key pair is lost forever. The .conf file imported into the client app stops working. There is no way to restore the user "as it was" — even a new one with the same name will have different keys, and the client will have to import a new .conf.

User limit

ℹ️ The free licence allows one user

On the default plan the Amnezia module lets you create one VPN user — enough for a single device, for example a personal smartphone. For several devices or family members, you'll need to purchase additional slots.

What changes at different quota usage levels:

• Within the quota (N < M) — create new users freely.
• Limit reached (N = M) — no new users can be created. To go further — buy slots via the Buy slots link right in the tile, or delete the users you no longer need.
• Over the limit (N > M, for example after a plan downgrade) — the most recently created users stay in the list, but without a working configuration: the .conf file is not issued for them, and email sending and editing are unavailable too. To bring them back — buy slots or delete the excess users.

The Buy slots link goes to the Licence section — to issuing a new licence if you don't have one yet, or to changing the existing one with the slot count pre-filled. The licence stacks with the free quota: if the licence specifies, say, 5 slots, you will have 6 users in total (1 free + 5 from the licence). In the Licence section this capability is shown under the human-readable label Amnezia.

What's next

• Amnezia quick start — installing the module and the first connection.
• Amnezia. Managing the module — managing the service, module settings, updating, and uninstalling.
• How to set up an SMTP relay for sending email — so you can email users their .conf file.