How mullvad/mullvadvpn-app works
Mullvad VPN is a multi-platform client for the Mullvad service. On desktop, users interact through the GUI or CLI with a shared daemon; Android has a dedicated frontend backed by that service, while iOS implements its tunnel client independently. The product spans account and settings management, relay selection, tunnel establishment, and traffic protection, with optional payments and advanced tunnel modes. The graph combines README architecture statements with sampled Android and iOS code; dashed links mark relationships whose wiring was not shown in the excerpts.
Main entry points: main.rs VPN daemon · MainActivity.kt Android app · ManagementService.kt Management RPC · MullvadVpnService.kt Android VPN service
Components 22
Client interfaces
- Desktop GUI
desktop - Desktop CLI
mullvad-cli/src/main.rs - Android app
android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/MainActivity.kt - iOS app
ios/MullvadVPN/Containers/Root/RootContainerViewController.swift - Relay map
android/lib/map/src/main/kotlin/net/mullvad/mullvadvpn/lib/map/Map.kt
Connection control
- VPN daemon
mullvad-daemon/src/main.rs - Management RPC
android/lib/grpc/src/main/kotlin/net/mullvad/mullvadvpn/lib/grpc/ManagementService.kt - Connection proxy
android/lib/repository/src/main/kotlin/net/mullvad/mullvadvpn/lib/repository/ConnectionProxy.kt - Relay selection
mullvad-relay-selector/src/relay_selector/query.rs - iOS tunnel manager
ios/MullvadVPN/TunnelManager/TunnelManager.swift
Tunnel runtime
- Android VPN service
android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt - Android TUN service
android/lib/talpid/src/main/kotlin/net/mullvad/talpid/TalpidVpnService.kt - Tunnel engine
talpid-wireguard/src/lib.rs - Key exchange
ios/PacketTunnel/PostQuantum/EphemeralPeerExchangingPipeline.swift
Platform state
- iOS settings
ios/MullvadSettings/SettingsManager.swift - Tunnel state model
android/lib/model/src/main/kotlin/net/mullvad/mullvadvpn/lib/model/TunnelState.kt - API endpoint
android/lib/endpoint/src/main/kotlin/net/mullvad/mullvadvpn/lib/endpoint/ApiEndpointOverride.kt
VPN capabilities
- Traffic protection
talpid-routing/src/windows/route_manager.rs - Obfuscation modes
tunnel-obfuscation/src/main.rs - Android payments
android/lib/billing/src/main/kotlin/net/mullvad/mullvadvpn/lib/billing/BillingPaymentRepository.kt
Other components
- VPN user
- Mullvad service
Connections 24
- VPN user → Desktop GUI: uses
README.md - VPN user → Desktop CLI: uses
README.md - VPN user → Android app: uses
README.md - VPN user → iOS app: uses
README.md - Desktop GUI → VPN daemon: controls
README.md - Desktop CLI → VPN daemon: controls
README.md - Android app → VPN daemon: uses shared service
README.md - iOS app → iOS tunnel manager: manages
- Android VPN service → VPN daemon: initializes
android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt - Android VPN service → Management RPC: obtains
android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt - Management RPC → VPN daemon: communicates
- Android app → Connection proxy: controls tunnel
- Connection proxy → Management RPC: uses
android/lib/repository/src/main/kotlin/net/mullvad/mullvadvpn/lib/repository/ConnectionProxy.kt - iOS tunnel manager → iOS settings: uses
ios/MullvadVPN/TunnelManager/TunnelManager.swift - VPN daemon → Relay selection: selects relays
- Android VPN service → Android TUN service: establishes TUN
android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt - Android TUN service → Tunnel engine: supports tunnel
- iOS tunnel manager → Key exchange: negotiates keys
- Management RPC → Tunnel state model: maps tunnel state
- Android app → Relay map: presents relays
- VPN daemon → Traffic protection: enforces security
README.md - VPN daemon → Obfuscation modes: supports modes
README.md - Android app → Android payments: offers payments
- VPN daemon → Mullvad service: connects to
README.md