libreelec-conf/README.md
Alexandre CATTEAU 33f60c1781 Update README
Add instructions for setting up a Systemd service unit for VPN connection
2024-02-24 14:25:43 +01:00

24 lines
1.3 KiB
Markdown

# LibreELEC setup
This repository contains setup or configuration files for [LibreELEC](https://libreelec.tv/) after installation.
### WireGuard VPN setup
* copy `~/.config/wireguard/wireguard.config.sample` to a new file, and adjust the parameters (see
[LibreELEC wiki](https://wiki.libreelec.tv/configuration/wireguard) for reference)
* do NOT set the DNS server in this conf file, but in `variables.conf`
* it is advisable to create a Systemd unit to manage the VPN connection, especially if it should start at boot
* use the [wiki](https://wiki.libreelec.tv/configuration/wireguard#configuring-systemd), and mind that the connection
name to use with `connmanctl` is the ConnMan id (`vpn_<endpoint_address>`) and not the name given to the connection
### Files
* `variables.conf.template` contains examples variables definitions, and should be copied locally to `variables.conf`
(with any required modifications).
* `systemd-templates/` contains Systemd units templates for detecting VPN connection, and apply routes and DNS
modifications.
* `set-dns.sh` sets the VPN DNS to `resolv.conf`, and `unset-dns.sh` restores the previous `resolv.conf`.
#### Installation
* `install.sh` script copies Systemd templates to their destination, and enables trigger (Systemd path).
### TODO
* RAS