# mullvad/mullvadvpn-app architecture

> Architecture diagram of the GitHub repository mullvad/mullvadvpn-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mullvad/mullvadvpn-app
- Repository: https://github.com/mullvad/mullvadvpn-app

## Overview

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: [`mullvad-daemon/src/main.rs`](https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-daemon/src/main.rs) (VPN daemon), [`android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/MainActivity.kt`](https://github.com/mullvad/mullvadvpn-app/blob/main/android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/MainActivity.kt) (Android app), [`android/lib/grpc/src/main/kotlin/net/mullvad/mullvadvpn/lib/grpc/ManagementService.kt`](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/grpc/src/main/kotlin/net/mullvad/mullvadvpn/lib/grpc/ManagementService.kt) (Management RPC), [`android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt`](https://github.com/mullvad/mullvadvpn-app/blob/main/android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt) (Android VPN service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client interfaces"]
  node_desktop_gui["Desktop GUI"]
  node_desktop_cli["Desktop CLI<br/>[main.rs]"]
  node_android_app["Android app<br/>[MainActivity.kt]"]
  node_ios_app["iOS app"]
  node_map["Relay map<br/>[Map.kt]"]
end

subgraph group_control["Connection control"]
  node_daemon["VPN daemon<br/>[main.rs]"]
  node_grpc["Management RPC"]
  node_connection["Connection proxy<br/>[ConnectionProxy.kt]"]
  node_relay["Relay selection<br/>[query.rs]"]
  node_ios_tunnel_manager["iOS tunnel manager"]
end

subgraph group_tunnel["Tunnel runtime"]
  node_android_vpn["Android VPN service"]
  node_talpid_vpn["Android TUN service"]
  node_wireguard["Tunnel engine<br/>[lib.rs]"]
  node_post_quantum["Key exchange"]
end

subgraph group_platform["Platform state"]
  node_settings[("iOS settings")]
  node_model["Tunnel state model<br/>[TunnelState.kt]"]
  node_api_endpoint["API endpoint"]
end

subgraph group_capabilities["VPN capabilities"]
  node_privacy["Traffic protection<br/>[route_manager.rs]"]
  node_obfuscation["Obfuscation modes<br/>[main.rs]"]
  node_billing["Android payments"]
end

node_user(("VPN user"))
node_service(("Mullvad service"))

node_user -->|"uses"| node_desktop_gui
node_user -->|"uses"| node_desktop_cli
node_user -->|"uses"| node_android_app
node_user -->|"uses"| node_ios_app
node_desktop_gui -->|"controls"| node_daemon
node_desktop_cli -->|"controls"| node_daemon
node_android_app -->|"uses shared service"| node_daemon
node_ios_app -.->|"manages"| node_ios_tunnel_manager
node_android_vpn -->|"initializes"| node_daemon
node_android_vpn -->|"obtains"| node_grpc
node_grpc -.->|"communicates"| node_daemon
node_android_app -.->|"controls tunnel"| node_connection
node_connection -.->|"uses"| node_grpc
node_ios_tunnel_manager -->|"uses"| node_settings
node_daemon -.->|"selects relays"| node_relay
node_android_vpn -.->|"establishes TUN"| node_talpid_vpn
node_talpid_vpn -.->|"supports tunnel"| node_wireguard
node_ios_tunnel_manager -.->|"negotiates keys"| node_post_quantum
node_grpc -.->|"maps tunnel state"| node_model
node_android_app -.->|"presents relays"| node_map
node_daemon -->|"enforces security"| node_privacy
node_daemon -->|"supports modes"| node_obfuscation
node_android_app -.->|"offers payments"| node_billing
node_daemon -->|"connects to"| node_service

click node_desktop_gui "https://github.com/mullvad/mullvadvpn-app/tree/main/desktop"
click node_desktop_cli "https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-cli/src/main.rs"
click node_android_app "https://github.com/mullvad/mullvadvpn-app/blob/main/android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/MainActivity.kt"
click node_ios_app "https://github.com/mullvad/mullvadvpn-app/blob/main/ios/MullvadVPN/Containers/Root/RootContainerViewController.swift"
click node_daemon "https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-daemon/src/main.rs"
click node_grpc "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/grpc/src/main/kotlin/net/mullvad/mullvadvpn/lib/grpc/ManagementService.kt"
click node_connection "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/repository/src/main/kotlin/net/mullvad/mullvadvpn/lib/repository/ConnectionProxy.kt"
click node_relay "https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-relay-selector/src/relay_selector/query.rs"
click node_ios_tunnel_manager "https://github.com/mullvad/mullvadvpn-app/blob/main/ios/MullvadVPN/TunnelManager/TunnelManager.swift"
click node_settings "https://github.com/mullvad/mullvadvpn-app/blob/main/ios/MullvadSettings/SettingsManager.swift"
click node_android_vpn "https://github.com/mullvad/mullvadvpn-app/blob/main/android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt"
click node_talpid_vpn "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/talpid/src/main/kotlin/net/mullvad/talpid/TalpidVpnService.kt"
click node_wireguard "https://github.com/mullvad/mullvadvpn-app/blob/main/talpid-wireguard/src/lib.rs"
click node_post_quantum "https://github.com/mullvad/mullvadvpn-app/blob/main/ios/PacketTunnel/PostQuantum/EphemeralPeerExchangingPipeline.swift"
click node_model "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/model/src/main/kotlin/net/mullvad/mullvadvpn/lib/model/TunnelState.kt"
click node_api_endpoint "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/endpoint/src/main/kotlin/net/mullvad/mullvadvpn/lib/endpoint/ApiEndpointOverride.kt"
click node_map "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/map/src/main/kotlin/net/mullvad/mullvadvpn/lib/map/Map.kt"
click node_privacy "https://github.com/mullvad/mullvadvpn-app/blob/main/talpid-routing/src/windows/route_manager.rs"
click node_obfuscation "https://github.com/mullvad/mullvadvpn-app/blob/main/tunnel-obfuscation/src/main.rs"
click node_billing "https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/billing/src/main/kotlin/net/mullvad/mullvadvpn/lib/billing/BillingPaymentRepository.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop_gui,node_desktop_cli,node_android_app,node_ios_app,node_map,node_user toneBlue
class node_daemon,node_grpc,node_connection,node_relay,node_ios_tunnel_manager toneAmber
class node_android_vpn,node_talpid_vpn,node_wireguard,node_post_quantum toneMint
class node_settings,node_model,node_api_endpoint toneRose
class node_privacy,node_obfuscation,node_billing,node_service toneIndigo
```

## Components

### Client interfaces

- [Desktop GUI](https://github.com/mullvad/mullvadvpn-app/tree/main/desktop): `desktop`
- [Desktop CLI](https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-cli/src/main.rs): `mullvad-cli/src/main.rs`
- [Android app](https://github.com/mullvad/mullvadvpn-app/blob/main/android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/MainActivity.kt): `android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/MainActivity.kt`
- [iOS app](https://github.com/mullvad/mullvadvpn-app/blob/main/ios/MullvadVPN/Containers/Root/RootContainerViewController.swift): `ios/MullvadVPN/Containers/Root/RootContainerViewController.swift`
- [Relay map](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/map/src/main/kotlin/net/mullvad/mullvadvpn/lib/map/Map.kt): `android/lib/map/src/main/kotlin/net/mullvad/mullvadvpn/lib/map/Map.kt`

### Connection control

- [VPN daemon](https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-daemon/src/main.rs): `mullvad-daemon/src/main.rs`
- [Management RPC](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/grpc/src/main/kotlin/net/mullvad/mullvadvpn/lib/grpc/ManagementService.kt): `android/lib/grpc/src/main/kotlin/net/mullvad/mullvadvpn/lib/grpc/ManagementService.kt`
- [Connection proxy](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/repository/src/main/kotlin/net/mullvad/mullvadvpn/lib/repository/ConnectionProxy.kt): `android/lib/repository/src/main/kotlin/net/mullvad/mullvadvpn/lib/repository/ConnectionProxy.kt`
- [Relay selection](https://github.com/mullvad/mullvadvpn-app/blob/main/mullvad-relay-selector/src/relay_selector/query.rs): `mullvad-relay-selector/src/relay_selector/query.rs`
- [iOS tunnel manager](https://github.com/mullvad/mullvadvpn-app/blob/main/ios/MullvadVPN/TunnelManager/TunnelManager.swift): `ios/MullvadVPN/TunnelManager/TunnelManager.swift`

### Tunnel runtime

- [Android VPN service](https://github.com/mullvad/mullvadvpn-app/blob/main/android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt): `android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt`
- [Android TUN service](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/talpid/src/main/kotlin/net/mullvad/talpid/TalpidVpnService.kt): `android/lib/talpid/src/main/kotlin/net/mullvad/talpid/TalpidVpnService.kt`
- [Tunnel engine](https://github.com/mullvad/mullvadvpn-app/blob/main/talpid-wireguard/src/lib.rs): `talpid-wireguard/src/lib.rs`
- [Key exchange](https://github.com/mullvad/mullvadvpn-app/blob/main/ios/PacketTunnel/PostQuantum/EphemeralPeerExchangingPipeline.swift): `ios/PacketTunnel/PostQuantum/EphemeralPeerExchangingPipeline.swift`

### Platform state

- [iOS settings](https://github.com/mullvad/mullvadvpn-app/blob/main/ios/MullvadSettings/SettingsManager.swift): `ios/MullvadSettings/SettingsManager.swift`
- [Tunnel state model](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/model/src/main/kotlin/net/mullvad/mullvadvpn/lib/model/TunnelState.kt): `android/lib/model/src/main/kotlin/net/mullvad/mullvadvpn/lib/model/TunnelState.kt`
- [API endpoint](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/endpoint/src/main/kotlin/net/mullvad/mullvadvpn/lib/endpoint/ApiEndpointOverride.kt): `android/lib/endpoint/src/main/kotlin/net/mullvad/mullvadvpn/lib/endpoint/ApiEndpointOverride.kt`

### VPN capabilities

- [Traffic protection](https://github.com/mullvad/mullvadvpn-app/blob/main/talpid-routing/src/windows/route_manager.rs): `talpid-routing/src/windows/route_manager.rs`
- [Obfuscation modes](https://github.com/mullvad/mullvadvpn-app/blob/main/tunnel-obfuscation/src/main.rs): `tunnel-obfuscation/src/main.rs`
- [Android payments](https://github.com/mullvad/mullvadvpn-app/blob/main/android/lib/billing/src/main/kotlin/net/mullvad/mullvadvpn/lib/billing/BillingPaymentRepository.kt): `android/lib/billing/src/main/kotlin/net/mullvad/mullvadvpn/lib/billing/BillingPaymentRepository.kt`

### Other components

- **VPN user**
- **Mullvad service**

## Connections

- VPN user → Desktop GUI: uses (evidence: `README.md`)
- VPN user → Desktop CLI: uses (evidence: `README.md`)
- VPN user → Android app: uses (evidence: `README.md`)
- VPN user → iOS app: uses (evidence: `README.md`)
- Desktop GUI → VPN daemon: controls (evidence: `README.md`)
- Desktop CLI → VPN daemon: controls (evidence: `README.md`)
- Android app → VPN daemon: uses shared service (evidence: `README.md`)
- iOS app → iOS tunnel manager: manages
- Android VPN service → VPN daemon: initializes (evidence: `android/app/src/main/kotlin/net/mullvad/mullvadvpn/app/service/MullvadVpnService.kt`)
- Android VPN service → Management RPC: obtains (evidence: `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 (evidence: `android/lib/repository/src/main/kotlin/net/mullvad/mullvadvpn/lib/repository/ConnectionProxy.kt`)
- iOS tunnel manager → iOS settings: uses (evidence: `ios/MullvadVPN/TunnelManager/TunnelManager.swift`)
- VPN daemon → Relay selection: selects relays
- Android VPN service → Android TUN service: establishes TUN (evidence: `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 (evidence: `README.md`)
- VPN daemon → Obfuscation modes: supports modes (evidence: `README.md`)
- Android app → Android payments: offers payments
- VPN daemon → Mullvad service: connects to (evidence: `README.md`)
