Building

Linux

Requirements

• Git
• CMake 3.10+
• GNU Make
• GCC or Clang (C11)
• libevent 2.x
• Network access for the first build (BoringSSL is cloned from GitHub)

Quick Build

./build.sh            # builds BoringSSL, xquic, and mqvpn
./build.sh --clean    # full rebuild

Manual Build Steps

1. Build BoringSSL

cd third_party/xquic/third_party/boringssl
mkdir -p build && cd build
cmake -DBUILD_SHARED_LIBS=0 -DCMAKE_C_FLAGS="-fPIC" -DCMAKE_CXX_FLAGS="-fPIC" ..
make -j$(nproc) ssl crypto
cd ../../../../..

2. Build xquic

cd third_party/xquic
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DSSL_TYPE=boringssl \
      -DSSL_PATH=../third_party/boringssl \
      -DXQC_ENABLE_BBR2=ON ..
make -j$(nproc)
cd ../../..

3. Build mqvpn

mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release \
      -DXQUIC_BUILD_DIR=../third_party/xquic/build ..
make -j$(nproc)

Testing

ctest --test-dir build --output-on-failure  # C library unit tests
sudo ./scripts/ci_e2e/run_test.sh           # E2E (netns, requires root)
sudo ./scripts/run_multipath_test.sh        # multipath failover
(cd android && ./gradlew test)              # Android SDK unit tests

Windows (MSVC x64)

INFO

Only the client is supported on Windows. The server is Linux-only.

Prerequisites

Tool	Purpose	Install
Visual Studio 2022 Build Tools	C/C++ compiler (MSVC)	winget install Microsoft.VisualStudio.2022.BuildTools (select C++ workload)
CMake >= 3.10	Build system	winget install Kitware.CMake
Go	Required by BoringSSL	winget install GoLang.Go
NASM	Required by BoringSSL (assembly)	winget install NASM.NASM
Perl (Strawberry Perl)	Required by BoringSSL	winget install StrawberryPerl.StrawberryPerl
vcpkg	Install libevent	git clone https://github.com/microsoft/vcpkg && .\vcpkg\bootstrap-vcpkg.bat
Git	Source checkout	winget install Git.Git

Wintun

The TUN device is provided by Wintun. wintun.dll is a required runtime dependency on Windows.

You must install/provide wintun.dll before running mqvpn:

1. Download the official Wintun release package from the Wintun website.
2. Extract it and copy the x64 wintun.dll to the mqvpn executable directory (for example, build\Release\), or place it in a directory included in PATH.
3. Verify it is discoverable (build\Release\wintun.dll exists, or where wintun.dll resolves it).

wintun.dll is loaded dynamically at runtime, so build succeeds without it, but mqvpn client startup fails if it is missing.

Build Steps

Run all commands from a Developer Command Prompt for VS 2022:

call "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"

1. Install libevent

vcpkg install libevent:x64-windows-static

2. Build BoringSSL

cd third_party\xquic\third_party
git clone https://github.com/google/boringssl.git
cd boringssl
git checkout 9c95ec797c65fde9e8ddffc3888f0b8c1460fe4c

mkdir build && cd build
cmake -G "Visual Studio 17 2022" -A x64 -DBUILD_SHARED_LIBS=0 ..
cmake --build . --target ssl --config Release
cmake --build . --target crypto --config Release

3. Build xquic

cd third_party\xquic
mkdir build && cd build
cmake -G "Visual Studio 17 2022" -A x64 ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DSSL_TYPE=boringssl ^
  -DSSL_PATH=%cd%\..\..\xquic\third_party\boringssl ^
  -DXQC_ENABLE_BBR2=ON ..
cmake --build . --config Release

4. Build mqvpn

Replace VCPKG_ROOT with the path to your vcpkg clone.

mkdir build && cd build
cmake -G "Visual Studio 17 2022" -A x64 ^
  -DCMAKE_BUILD_TYPE=Release ^
  -DXQUIC_BUILD_DIR=..\third_party\xquic\build\Release ^
  -DBORINGSSL_BUILD_DIR=..\third_party\xquic\third_party\boringssl\build\Release ^
  -DCMAKE_TOOLCHAIN_FILE=%VCPKG_ROOT%\scripts\buildsystems\vcpkg.cmake ^
  -DVCPKG_TARGET_TRIPLET=x64-windows-static ..
cmake --build . --config Release

The binary is at build\Release\mqvpn.exe.

Android

Prerequisites

• Android SDK (including SDK command-line tools and the platform/build-tools required by Gradle)
• Android NDK (NDK r27d or newer recommended)
• JDK 17
• CMake and Ninja (or GNU Make)
• Git checkout with submodules (--recurse-submodules)
• BoringSSL source at third_party/xquic/third_party/boringssl

Build

# Set these in your shell profile (for example, ~/.bashrc)
export ANDROID_HOME=/path/to/android-sdk
export ANDROID_NDK_HOME=/path/to/android-ndk
export ANDROID_NDK="$ANDROID_NDK_HOME"

# Ensure submodules are present
git submodule update --init --recursive

# Prepare BoringSSL source
git clone https://github.com/google/boringssl.git third_party/xquic/third_party/boringssl

# Cross-compile native libraries (arm64-v8a)
scripts/build_android.sh --abi arm64-v8a

# Build Android SDK modules + demo app
(cd android && ./gradlew assembleDebug --no-daemon --stacktrace)

# Run Android unit tests
(cd android && ./gradlew test --no-daemon --stacktrace)

Module Structure

android/
├── sdk-native/    # JNI bridge → libmqvpn_jni.so
├── sdk-runtime/   # MqvpnPoller (tick-loop)
├── sdk-network/   # NetworkMonitor, PathBinder
├── sdk-core/      # MqvpnVpnService, MqvpnManager, TunnelBridge
└── app/           # Demo app (Jetpack Compose)

See Getting Started to test your build.