How‐To Importing Custom WireGuard Configurations

If you want to use a VPN provider that is not built into the addon by default, you can easily use the Custom mode. This allows you to import any existing .config file directly into the addon.

---

Step 1: Set up the Addon Menu

1. Open the addon settings.
2. Under the VPN Provider list, select Custom (Import .config file).
3. An import button will appear directly below it. Click on it to browse your local storage and select your .config file.

---

Step 2: Preparing your Custom .config file

Before importing your file, make sure it is saved with a .config extension (for example: belgium.config) and matches the official ConnMan platform layout.

💡 The LibreELEC Speed & Freeze Fix

To prevent your custom connection from freezing, dropping out, or lagging during network speed tests, do not use the standard 0.0.0.0/0 range.

Instead, split the internet traffic in half by using 0.0.0.0/1, 128.0.0.0/1. This tells the system that the VPN has absolute priority, eliminating all freezes while keeping your local network shares (Samba/SMB) working perfectly.

Example: belgium.config

You can use this exact template for your custom profile. Just swap out the IP addresses and your keys:

[provider_wireguard]
Type = WireGuard
Name = Custom_Belgium
Host = 146.70.55.43
WireGuard.Address = 10.5.0.2/32
WireGuard.ListenPort = 51820
WireGuard.MTU = 1420
WireGuard.PrivateKey = YOUR_PRIVATE_KEY_HERE_======================
WireGuard.PublicKey = VSa6XYcD279ahd3IuEiUH6VpXn0+h+kWrD4OcN1ExUs=
WireGuard.DNS = 103.86.96.100, 103.86.99.100
WireGuard.AllowedIPs = 0.0.0.0/1, 128.0.0.0/1
WireGuard.EndpointPort = 51820
WireGuard.PersistentKeepalive = 25

Step 3: Import and Run

Once you select and import this file through the addon settings, click OK to save your settings menu. Open the addon launcher, select your newly imported custom profile, and you are ready to roll!

---

🚀 Does this routing trick improve network speed?

While splitting the traffic into 0.0.0.0/1, 128.0.0.0/1 does not magically increase your raw fiber or cable internet bandwidth, it provides massive indirect speed and performance advantages across your entire system (NordVPN, PIA, and Custom profiles alike).

Here is exactly how it makes your device feel much faster:

1. Instant Connection Startup (Zero DNS Hangs)

Without this fix, the Linux kernel spends critical milliseconds hesitating and trying to send data over both your regular network cable and the VPN interface simultaneously. This causes internal search timeouts.

• The Benefit: By splitting the subnets, the kernel instantly knows exactly where to send data packages within a microsecond. You will notice this because your streams will start significantly faster, and initial buffering delays disappear.

2. Rock-Solid Throughput (No More Speed Drops)

When network paths conflict under the old 0.0.0.0/0 setup, data packets collide, causing the tunnel to freeze up or drop speed drastically for a few seconds (which is exactly why speed tests and download tools time out).

• The Benefit: The split ensures your data flows smoothly in a single lane. Your download speed stays completely stable, consistent, and locked at its absolute peak performance without sudden, unexplained drops.

3. Maximum Local Speed for Samba/SMB Streaming

Because your local home network traffic completely bypasses the VPN tunnel thanks to this priority rule, your internal network transfers remain entirely untouched.

• The Benefit: Streaming high-bitrate 4K Blu-ray rips from your local NAS or PC over Samba still runs at your full Gigabit hardware line speed (1000 Mbps). Because the Raspberry Pi 5 does not waste processor cycles encrypting local household video traffic, 100% of its CPU power is saved to keep your external public VPN download speeds as fast as humanly possible.