-
Notifications
You must be signed in to change notification settings - Fork 19
Server Groups
The GROUP environment variable filters the NordVPN server fleet by specialty. Each group is a separate set of servers with different capabilities. Only one group can be set at a time.
| Group | Identifier | Compatible Technologies | Availability |
|---|---|---|---|
| Standard VPN servers | legacy_standard |
openvpn_udp, openvpn_tcp
|
All countries |
| P2P | legacy_p2p |
openvpn_udp, openvpn_tcp
|
Most countries |
| Double VPN | legacy_double_vpn |
openvpn_udp, openvpn_tcp
|
Limited country pairs |
| Onion Over VPN | legacy_onion_over_vpn |
openvpn_udp, openvpn_tcp
|
Very limited (NL, SE, CH) |
| Obfuscated Servers | legacy_obfuscated_servers |
openvpn_xor_udp, openvpn_xor_tcp
|
Many countries |
| Dedicated IP | legacy_dedicated_ip |
openvpn_dedicated_udp, openvpn_dedicated_tcp
|
Subscription-dependent |
| Anti DDoS | legacy_anti_ddos |
openvpn_udp, openvpn_tcp
|
Limited |
| Europe | europe |
openvpn_udp, openvpn_tcp
|
Regional |
| The Americas | the_americas |
openvpn_udp, openvpn_tcp
|
Regional |
| Asia Pacific | asia_pacific |
openvpn_udp, openvpn_tcp
|
Regional |
| Africa, the Middle East and India | africa_the_middle_east_and_india |
openvpn_udp, openvpn_tcp
|
Regional |
You can also use the human-readable names (e.g., GROUP=Double VPN) or numeric IDs. The full list is in GROUPS.md.
When GROUP is not set, the API returns servers from the default recommended pool (equivalent to legacy_standard).
The default NordVPN fleet. General-purpose servers suitable for everyday use.
environment:
- TECHNOLOGY=openvpn_udp
# GROUP not needed — this is the default
- COUNTRY=United StatesAvailable in all countries and cities. This is what you get when GROUP is omitted.
Servers optimized for peer-to-peer traffic. These allow the incoming connections that BitTorrent and other P2P protocols require.
environment:
- TECHNOLOGY=openvpn_udp
- GROUP=legacy_p2p
- COUNTRY=NetherlandsUse when torrenting or file sharing. Available in most countries, though some countries where P2P is restricted by law may not have P2P servers.
Traffic is encrypted twice and routed through two VPN servers in different countries. The entry server re-encrypts your traffic and forwards it to the exit server.
environment:
- TECHNOLOGY=openvpn_udp
- GROUP=legacy_double_vpnServer names show both countries (e.g., ca-us75 = Canada entry → United States exit). You can filter by COUNTRY to select the exit country, but only pre-defined country pairs are available.
- Maximum privacy requirements (journalism, activism, whistleblowing)
- When you need two layers of encryption
- When you want your traffic to pass through two jurisdictions
- Higher latency than standard servers (traffic traverses two hops)
- Lower throughput due to double encryption
- Not compatible with P2P traffic
The VPN server routes your outbound traffic into the Tor network. No local Tor client is needed.
environment:
- TECHNOLOGY=openvpn_udp
- GROUP=legacy_onion_over_vpnAvailable in very few locations (Netherlands, Sweden, Switzerland at time of writing).
- Accessing
.onionsites without installing Tor - Adding a VPN layer before Tor for extra anonymity
- When you want your ISP to see only VPN traffic, not Tor traffic
Do not override DNS when using Onion Over VPN. The server pushes NordVPN's own DNS servers (103.86.96.100, 103.86.99.100) which route DNS queries through the Tor network. If you override DNS with external resolvers (e.g., Cloudflare 1.1.1.1), DNS queries will fail because Tor only carries TCP traffic and standard DNS uses UDP.
# CORRECT — let the server push its own DNS
environment:
- TECHNOLOGY=openvpn_udp
- GROUP=legacy_onion_over_vpn
- OPENVPN_OPTS=--mute-replay-warnings --ping-exit 60
# WRONG — this will break DNS resolution
environment:
- OPENVPN_OPTS=--pull-filter ignore "dhcp-option DNS" --dhcp-option DNS 1.1.1.1- Significantly slower than standard or Double VPN (Tor adds multiple hops)
- Not compatible with P2P traffic
- Some websites block Tor exit nodes
Servers that support XOR scrambling to disguise OpenVPN traffic, evading deep packet inspection (DPI).
environment:
- TECHNOLOGY=openvpn_xor_tcp
- GROUP=legacy_obfuscated_servers
- COUNTRY=United KingdomRequires an XOR technology (openvpn_xor_udp or openvpn_xor_tcp). Standard OpenVPN technologies will return no servers from this group.
See Technologies for XOR-specific details including multi-port behavior and custom port selection.
For NordVPN accounts with the Dedicated IP add-on. Provides a static IP address assigned exclusively to your account.
environment:
- TECHNOLOGY=openvpn_dedicated_udp
- GROUP=legacy_dedicated_ipRequires a dedicated technology (openvpn_dedicated_udp or openvpn_dedicated_tcp). The API returns Dedicated IP servers regardless of your subscription status, but you need an active Dedicated IP add-on for your NordVPN account to successfully authenticate and use these servers.
- IP whitelisting for remote access
- Services that block shared VPN IP addresses
- When you need a consistent public IP
Servers with DDoS protection.
environment:
- TECHNOLOGY=openvpn_udp
- GROUP=legacy_anti_ddosUseful for gaming or hosting services exposed through the VPN. This group may have limited server availability.
Broad geographic filters that return servers from an entire region rather than a specific country.
| Group | Identifier |
|---|---|
| Europe | europe |
| The Americas | the_americas |
| Asia Pacific | asia_pacific |
| Africa, the Middle East and India | africa_the_middle_east_and_india |
environment:
- TECHNOLOGY=openvpn_udp
- GROUP=europe
- RANDOM_TOP=10Use when you don't need a specific country — just a region. These work with standard OpenVPN technologies.
GROUP is sent to the NordVPN API as an AND filter alongside other parameters. All filters must match for a server to be returned.
| Parameter | Combines with GROUP? |
Notes |
|---|---|---|
COUNTRY |
Yes | Servers must match both group and country |
CITY |
Yes | Servers must match both group and city |
TECHNOLOGY |
Yes | Some groups require specific technologies (see table above) |
RANDOM_TOP |
Yes | Applied after filtering — picks randomly from top N results |
PORT |
Yes | Overrides the default port for the selected technology |
-
One group at a time. The API accepts a single group filter. You cannot combine
legacy_p2pwithlegacy_double_vpn, for example. -
Technology pairing matters. Obfuscated and Dedicated groups require their matching technologies. Standard groups work with
openvpn_udporopenvpn_tcp. -
Empty results. If the combination of
GROUP+COUNTRY+TECHNOLOGYhas no matching servers, the container falls back to default recommended servers (without the group filter).
The NordVPN API also lists groups that are not useful for this container:
| Group | Reason |
|---|---|
legacy_ultra_fast_tv (ID 5) |
Legacy streaming group — few or no servers |
legacy_netflix_usa (ID 13) |
Legacy streaming group — few or no servers |
legacy_socks5_proxy (ID 245) |
SOCKS5 protocol — not supported by this container |
anycast-dns, geo_dns, grafana, kapacitor, fastnetmon
|
NordVPN internal infrastructure |
Configuration
- Server Selection
- Server Groups
- Technologies
- IPv6 Configuration
- Automatic Reconnection
- Local Network Access
- VPN Gateway Mode
- OpenVPN Options
- Custom DNS
- Permissions
Security
Examples
Operations
Reference