LibreELEC setup

Set up TekLan VPN on LibreELEC

Use LibreELEC's built-in WireGuard support with a converted profile, or choose a VPN router for the simpler route.

Setup steps

Advanced direct setup

Convert a WireGuard profile for LibreELEC

LibreELEC includes a WireGuard client, but it cannot import the standard .conf file directly. ConnMan requires a different .config format, so the values must be transferred carefully.

Before you begin

  • Update LibreELEC and enable SSH in the LibreELEC settings add-on.
  • Create a separate WireGuard profile for this LibreELEC device.
  • Keep local access to the device while testing. A routing mistake can interrupt network access.

Get the Dashboard profile

  • Download profile: save the WireGuard .conf file on the computer used to administer LibreELEC.
  • Email: select Send profile, then Send email. The Dashboard sends the .conf attachment to your account email address; open it on a computer to copy the values.
  • Device access code: select Send profile, then Get code. Open dash.teklanvpn.com/get, enter the code and download the profile. The code expires after 15 minutes and works once.
WireGuard selected for a LibreELEC profile
Create a WireGuard profile for LibreELEC.
WireGuard profile ready for LibreELEC conversion
Download the profile, then convert its values.

Steps

  1. Open the downloaded .conf file in a text editor. Do not upload it to a conversion website.
  2. Connect to LibreELEC over SSH and create /storage/.config/wireguard/teklan.config.
  3. Follow the official LibreELEC WireGuard field mapping. Transfer the interface address, private key, DNS, peer public key, preshared key where present, endpoint port and allowed IPs.
  4. For Host, use the endpoint IP address. LibreELEC ConnMan does not accept a hostname in this field. If the server’s address changes, create a new profile in the Dashboard and update this value.
  5. Remove any optional field that is absent from the Dashboard profile rather than leaving it blank.
  6. Save the file, then run connmanctl services and identify the new VPN service.
  7. Run connmanctl connect SERVICE_NAME, replacing SERVICE_NAME with the service shown by ConnMan.

Check the connection

  1. Run connmanctl services again and confirm the VPN service is connected.
  2. Open Kodi and test network access.
  3. Check the public IP address from a browser or another device temporarily assigned to the same route.

If it does not connect

  • Recheck every value copied from the Dashboard file, especially the endpoint port and key fields.
  • Confirm Host contains an IP address rather than a hostname.
  • If the direct conversion is unsuitable, use the compatible-router guide and assign the LibreELEC device to the router VPN policy.
  • Do not reuse the same WireGuard profile on another connected device.

Still stuck? See the help articles, or open a support ticket with the exact error you see.

Helpful answers

TV and streaming
Fire StickFire OS or Vega OS app from the Amazon Appstore Fire TVFire OS or Vega OS app from the Amazon Appstore Android TVInstall the TekLan app from Google Play or by APK Google TVInstall the TekLan app from Google Play or by APK Chromecast with Google TVInstall the TekLan Android app Nvidia ShieldInstall the TekLan Android app

All setup guides