Skip to main content

Error Codes

Error 100: UnknownError​

Unknown error — can occur under various circumstances.

Solution:

  • Restart the application.
  • Try clearing the application cache.
  • Try removing the server or protocol and reconnecting.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 101: InternalError​

Internal error — can occur due to incorrect operation of Qt libraries or for other reasons.

Solution:

  • Restart the application.
  • Check whether the application correctly detects the protocols already installed on the server. If the problem appeared after changing server settings, run a check of installed Amnezia services on the server in the Management tab in connection settings.
  • Try removing the server connection and adding it again.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 102: NotImplementedError​

Function not implemented — the error may occur when trying to restore AmneziaVPN settings from a backup file created in a newer version of AmneziaVPN.

Protocols configured in newer versions of AmneziaVPN may be incompatible with older versions and vice versa.

Solution:

Error 103: AmneziaServiceNotRunning​

Background service not running — the error may occur on Linux, Windows, or macOS. Check whether the service is running on your system. If it is stopped, start it and restart the application.

1. Open Task Manager with the Ctrl+Alt+Del key combination.

2. Go to the "Details" tab.

3. Enter amnezia in the search/filter field at the top of the window.

4. If the AmneziaVPN-service process is not found, go to the "Services" tab and check the status of the AmneziaVPN-service service.

5. If the AmneziaVPN-service service is stopped, try to start it.

6. If the AmneziaVPN-service service is running and the "Details" tab shows the AmneziaVPN-service.exe process, proceed to the next step.

7. Try to establish a connection in the AmneziaVPN app.

8. If you could not start AmneziaVPN-service from Task Manager or need additional diagnostics, open Services via "Services" (Management Console).

9. Find AmneziaVPN-service in the list of services and check its status and startup type. By default, the startup type should be automatic.

10. Try to start the AmneziaVPN-service from the Management Console.

11. If the service starts, its status will change to "Running". After that, try connecting again in AmneziaVPN.

If an error message appears when starting AmneziaVPN-service in the Management Console, use it to diagnose the cause.

On macOS, open System Preferences → General → Login Items and Extensions and allow background activity for Privacy Technologies OU.

If the error persists, email us at or ask for help in our Telegram community.

Error 200: ServerCheckFailed​

Server check failed — occurs when trying to add a new server.

Solution:

Error 201: ServerPortAlreadyAllocatedError​

Server port already used. Check for another software — this error means that the port required by the protocol in AmneziaVPN is already in use by other software.

Solution:

  • If the protocol allows, change the port:
    • For OpenVPN, a randomly selected port from the range 30000–50000 is used by default, but you can specify another if needed.
    • For WireGuard, a randomly selected port from the range 30000–50000 is used by default, but you can specify any other UDP port if needed.
    • IKEv2 uses ports 500 and 4500; they cannot be changed.
    • OpenVPN over Cloak uses port 443 by default. It can be changed, but we do not recommend it: port 443 corresponds to web traffic, and on other ports VPN traffic is easier to detect even when masked as a website.
    • For AmneziaWG, a randomly selected port is used by default. If needed, you can specify any other free UDP port.
  • Check that no other software on the server is using this port.
    • For Windows: press Win+R, enter cmd, press Enter, run the command netstat -a. The console will display a list of ports in use. To save the list: netstat -a > filename.txt (by default in C:\Users\Username\).
    • For Linux: run the command netstat -pnltu. If you do not have the netstat utility, install it with:
      • sudo yum install net-tools (RedHat, CentOS)
      • dnf install net-tools (Fedora 22+)
      • sudo apt-get install net-tools (Debian/Ubuntu)
      • Verify that the ports required by the selected protocol are open on the server (this is configured in the VPS control panel).
      • Connect to the server via SSH or open the console through the hosting website and run the command sudo apt install lsof psmisc, then retry the installation.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 202: ServerContainerMissingError​

Server error: Docker container missing — occurs when the application cannot find the VPN service container on the server. This can happen when changing settings or if the container was removed manually outside AmneziaVPN.

Solution:

  • Add the server connection again.
  • Verify that the required server ports are free and not used by other services.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 203: ServerDockerFailedError​

Server error: Docker failed — may occur when installing VPN on the server, changing protocol settings, or if the Docker container was removed manually.

Solution:

Error 204: ServerCancelInstallation​

Installation canceled by user — the error may occur if you interrupted VPN setup on the server.

Solution:

Error 205: ServerUserNotInSudo​

The user is not a member of the sudo group — the error occurs when the server user cannot run administrative commands. This usually appears when installing VPN on the server or when adding a configuration file.

Solution:

  • Add the user to the sudo group via visudo if the sudo package is already installed.
  • If the sudo package is not installed, install it and then add the user to the sudo group.
  • Try configuring the server as root instead of a regular user.
  • If allowed by security policy, allow running sudo commands without a password.
  • If the server is not administered by you, contact your hosting support.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 206: ServerPacketManagerError​

Server error: Package manager error — occurs when installing VPN on the server if the package manager is already running another task or is corrupted. The application usually receives it after several failed attempts to install the required packages.

Solution:

  • Wait for other package installation or updates to finish, then retry.
  • Connect to the server via SSH or through the web console and check whether the package manager responds, for example with the command sudo apt-get install <any_utility>.
  • If the package manager is frozen, try rebooting the server.
  • If the problem persists and there are signs of package manager corruption, contact your hosting support.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 300: SshRequestDeniedError​

SSH request was denied — the error occurs when the server connection data is incorrect, the server lacks resources, or an updated version of AmneziaVPN is required.

Solution:

  • Verify that the entered data is correct.
  • Verify that the server is accessible and has sufficient resources: free disk space, memory available, server is not frozen and responds over SSH.
  • Restart the server from the hosting panel, then retry.
  • Update the application to the latest version from the official download page (mirror).
  • If the error persists, email us at or ask for help in our Telegram community.

Error 301: SshInterruptedError​

SSH request was interrupted — occurs when adding a new server to the app, when connecting to an already added server, or when changing its settings.

Solution:

Error 302: SshInternalError​

SSH internal error — occurs for various reasons:

  • Amnezia VPN or Amnezia — the connection is created on an iOS device in an outdated AmneziaVPN app version 4.8.2.0 or lower
  • Self-hosted — the server IP is blocked by the ISP; the server was shut down by the hosting provider; the server connection data was entered incorrectly

Solution:

  • For Amnezia VPN or Amnezia:
  • For Self-hosted:
    • Fully restart the application and retry the action.
    • Try performing the same action from another network: via mobile internet, another provider, or if necessary through another VPN.
    • If the error occurs only on one network while the action succeeds from another, the issue is related to the server IP being blocked by the ISP. Changing the server IP or renting a server with a different IP will help.
    • If the error occurs for any server actions together with errors 300 or 305, additionally check SSH availability and server status.
  • If the error cannot be resolved, email us at or ask for help in our Telegram community.

Error 303: SshPrivateKeyError​

Invalid private key or invalid passphrase entered — occurs when adding a new server to the app, when connecting to an already added server, or when changing its settings.

Solution:

Error 304: SshPrivateKeyFormatError​

The selected private key format is not supported, use openssh ED25519 key types or PEM key types — occurs when adding a new server to the app, when connecting to an already added server, or when changing its settings.

Solution:

Error 305: SshTimeoutError​

Timeout connecting to server — the error may occur when connecting to the server or when changing its settings. Port 22 may be closed or blocked on the server, or the server may be inaccessible for some reason.

Solution:

  • Ensure the server is powered on and accessible over SSH.
  • Verify that the username, password, IP address, and server port (with colon) are specified correctly.
  • Ensure the same SSH port is specified on which the server actually accepts connections. You may have changed the port or the default port 22 may be blocked on the server.
  • Restart the server from the hosting panel.
  • Try repeating the action from another internet source.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 400: SshScpFailureError​

SCP error: Generic failure — usually occurs when installation is not run as root or the user has insufficient sudo privileges.

Solution:

  • Create a server connection as the root user and retry the action.
  • Add the user under whom the action should be performed to the sudo group and allow running sudo commands without a password.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 500: OpenVpnConfigMissing​

OpenVPN configuration missing — the error occurs when using the AmneziaVPN app on Windows, Linux, or macOS.

Solution:

Error 501: OpenVpnManagementServerError​

OpenVPN management server error — the error occurs when using the AmneziaVPN app on Windows, Linux, or macOS.

Solution:

Error 503: ConfigMissing​

Configuration missing. The error occurs when establishing a VPN connection in the desktop version of the app.

Solution:

Error 600: OpenVpnExecutableMissing​

OpenVPN executable missing — the error may occur when connecting to VPN. This usually means that file installation failed, files were corrupted, or the system cannot find them.

Solution:

Error 601: ShadowSocksExecutableMissing​

Shadowsocks (ss-local) executable missing — usually means that file installation failed, files were corrupted, or the system cannot find them.

Solution:

Error 602: CloakExecutableMissing​

Cloak (ck-client) executable missing — usually means that file installation failed, files were corrupted, or the system cannot find them.

Solution:

Error 603: AmneziaServiceConnectionFailed​

Amnezia helper service error — usually means that the AmneziaVPN-service is corrupted, removed, or cannot be started.

Solution:

  • Reboot the device.
  • Reinstall the application.
  • On macOS, open System Preferences → General → Login Items and Extensions and verify that background activity is allowed for Privacy Technologies OU.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 604: ExecutableMissing​

Internal error — usually means that an executable file is missing.

Solution:

Error 700: OpenVpnAdaptersInUseError​

Can't connect: another VPN connection is active — the error may occur when connecting via OpenVPN if the OpenVPN adapter is already in use by another application.

Solution:

  • Check whether another VPN application connected to OpenVPN is enabled. Disable it.
  • Try rebooting the device.
  • Restart the application.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 701: OpenVpnUnknownError​

Internal error — occurs when connecting via OpenVPN.

Solution:

  • Check whether another VPN application connected to OpenVPN is enabled. Disable it.
  • Try rebooting the device.
  • Restart the application.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 702: OpenVpnTapAdapterError​

Can't setup OpenVPN TAP network adapter

Solution:

Error 703: AddressPoolError​

VPN pool error: no addresses available — the error means that there are no more available addresses for WireGuard and AmneziaWG configurations. AmneziaVPN supports up to 254 WireGuard configurations on a single server.

Solution:

  • If you are sure that fewer than 254 addresses are in use, try removing WireGuard or AmneziaWG and reconnecting.
  • If addresses have actually run out, use another server or another protocol.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 800: OpenSslFailed​

OpenSSL failed — may occur when connecting to VPN.

Solution:

Error 801: ShadowSocksExecutableCrashed​

Internal error — may occur when connecting to VPN due to a crash of the Shadowsocks executable.

Solution:

Error 802: CloakExecutableCrashed​

Internal error — may occur when connecting to VPN due to a crash of the Cloak executable.

Solution:

Error 900: ImportInvalidConfigError​

The config does not contain any containers and credentials for connecting to the server. The error occurs if the connection key pasted into AmneziaVPN was not copied completely, contains extra characters or spaces, or if the imported configuration or backup file is empty, corrupted, or has an unsupported format.

The error also occurs if you try to open an encrypted configuration or backup file in an outdated version of AmneziaVPN that does not support the Password and Encryption feature.

Solution:

  • Copy the connection key completely and without extra spaces or characters.
  • When transferring a key to Android TV in the LocalSend app, tap Copy, not Open.
  • Ensure that the configuration file you are using has one of the supported formats: .vpn, .conf, .ovpn, or .json.
  • Try reissuing the configuration file if the current one is empty or edited with errors.
  • Update the AmneziaVPN app if you are trying to import an encrypted file.
  • If you cannot resolve the issue, email us at or ask for help in our Telegram community.

Error 1000​

VPN connection error — the cause may be in either the Android system or the AmneziaVPN app.

The error often occurs when trying to use a configuration from a third-party source whose format AmneziaVPN does not support. For example, Outline keys with IPv6 or DNS server name instead of IPv4 address, or WireGuard and AmneziaWG configurations created manually without using AmneziaVPN or the Amnezia VPN Personal Dashboard.

Solution:

  • If the error occurs when trying to use a third-party configuration, ensure that the configuration file you are using has one of the supported formats: .vpn, .conf, .ovpn, or .json.
  • The imported connection key must start with vpn://... or ss://....
  • If the error persists, email us at or ask for help in our Telegram community.

Error 1100: ApiConfigDownloadError​

Error when retrieving configuration from API — the error means that the AmneziaVPN app could not connect to the server to retrieve the API configuration.

Possible causes:

  • no internet connection
  • internet fully or partially restricted by "whitelists"
  • expired subscription
  • active connection limit in Amnezia VPN subscription is full

Solution:

  • Amnezia: if the connection was created with a key from the bot, try creating the connection through the VPN by Amnezia option in the AmneziaVPN app, or vice versa. Also try resetting the API configuration in Amnezia connection settings.

    For more details: Can't connect to Amnezia.

  • Amnezia VPN: ensure that you are using a key from an active subscription that has an available slot. You can check your subscription in the Personal Dashboard (mirror). If the active connection limit is exhausted, unlink an unused device or revoke an unneeded configuration file, then retry.

    For more details: Can't connect to Amnezia VPN.

  • Switch your internet source, for example by connecting to home Wi-Fi or another mobile connection. Then retry the connection.

  • If the same connection works on other devices and the error occurs only on one, the issue is likely local to that device: restart the app, try a full reset in app settings, and create the connection again.

  • Try resetting the API configuration (guide).

  • If the error persists, email us at or ask for help in our Telegram community.

Error 1101: ApiConfigAlreadyAdded​

This config has already been added to the application — this error occurs when trying to create an Amnezia connection if another Amnezia connection already exists in the app. The existing Amnezia connection may have been created either with a key from the bot or through the VPN by Amnezia option in the AmneziaVPN app.

You can have two Amnezia connections only if one of them was created through VPN by Amnezia and the other was added with a key from the bot. The order matters: first create the connection through VPN by Amnezia, and only then add the connection with a key from the bot.

You cannot create two Amnezia connections through the VPN by Amnezia option inside the app, regardless of the order.

Solution:

  • If you need only one Amnezia connection, use the existing connection or delete it before creating another one.
  • If you need to have two Amnezia connections, delete all Amnezia connections. Then first create the Amnezia connection through the VPN by Amnezia option in the app, and after that add the second Amnezia connection using a key from the bot.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 1102: ApiConfigEmptyError​

In the response from the server, an empty config was received

Solution:

  • If you connected using a key, verify that you copied it correctly and retry.
  • If the connection was via QR code, try scanning it again.
  • If you connected via file, try regenerating it and retry the connection.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 1103: ApiConfigTimeoutError​

Server response timeout on api request — the error means that the AmneziaVPN app could not connect to the server to retrieve the API configuration.

Possible causes:

  • no internet connection
  • internet fully or partially restricted by "whitelists"
  • expired subscription
  • active connection limit in Amnezia VPN subscription is full

Solution:

  • Amnezia: if the connection was created with a key from the bot, try creating the connection through the VPN by Amnezia option in the AmneziaVPN app, or vice versa. Also try resetting the API configuration in Amnezia connection settings.

    For more details: Can't connect to Amnezia.

  • Amnezia VPN: ensure that you are using a key from an active subscription that has an available slot. You can check your subscription in the Personal Dashboard (mirror). If the active connection limit is exhausted, unlink an unused device or revoke an unneeded configuration file, then retry.

    For more details: Can't connect to Amnezia VPN.

  • Switch your internet source, for example by connecting to home Wi-Fi or another mobile connection. Then retry the connection.

  • If the same connection works on other devices and the error occurs only on one, the issue is likely local to that device: restart the app, try a full reset in app settings, and create the connection again.

  • Try resetting the API configuration (guide).

  • If the error persists, email us at or ask for help in our Telegram community.

Error 1104: ApiConfigSslError​

SSL error occurred. Possible causes:

  • mobile internet operating in restricted "whitelist" mode
  • incorrect time set on the device

Solution:

  • Switch your internet source, for example by connecting to home Wi-Fi or another mobile connection. Then retry the connection.
  • Synchronize system time.
  • If the error persists, email us at or ask for help in our Telegram community.

Error 1108: ApiConfigLimitError​

The limit of allowed configurations per subscription has been exceeded — the subscription has exhausted the total limit of active connections. For details on counting rules: Personal Dashboard: Subscription.

This limit includes both devices where a connection was created with the vpn:// key and issued configuration files. Each issued configuration file occupies 1 slot, even if no device is currently connected through it.

When all 7 slots are occupied, you will not be able to issue a new configuration file for another location or connect a new device with the vpn:// key.

Solution:

Error 1200: OpenError​

QFile error: The file could not be opened — may occur in AmneziaVPN right after installing the app when performing the following actions:

  • connecting to your own VPN server
  • configuring VPN on the server
  • managing guest connections to the server

Solution:

  • Go to AmneziaVPN settings (⚙️ icon on the bottom bar) → tap Close application → launch AmneziaVPN again and retry the action.
  • If the error persists, email us at or ask for help in our Telegram community.