tuliprox-vpn

Overview

Tuliprox with built-in OpenVPN support. Proxies and filters IPTV M3U playlists and EPG data through a VPN tunnel. Supports NordVPN, PIA, Surfshark, IPVanish, VyprVPN, ProtonVPN, and custom OpenVPN configs.

Requirements

OpenVPN credentials for your VPN provider. See https://github.com/brycelarge/openvpn-buildtools for setup instructions.

Runtime arguments

Web UI: http://[IP]:[PORT:8901]/
Network: bridge
Shell: bash
Privileged: false
Extra Params: --cap-add=NET_ADMIN --device=/dev/net/tun

Template configuration

Web UI PortPorttcp

Tuliprox web UI and API

Target: 8901
Default: 8901
Value: 8901

HDHomeRun Port 1Porttcp

HDHomeRun device port. Must match the port value set in config.yml hdhomerun.devices. Add additional port mappings for each extra device.

Target: 5004
Default: 5004
Value: 5004

Privoxy PortPorttcp

Privoxy HTTP proxy port (only needed if PRIVOXY_ENABLED=true)

Target: 8118
Default: 8118
Value: 8118

EPG Scraper PortPorttcp

EPG scraper guide server port (only needed if EPG_SCRAPER_ENABLED=true)

Target: 3002
Default: 3002
Value: 3002

ConfigPathrw

Tuliprox config directory. Place config.yml and source.yml here.

Target: /app/config
Default: /mnt/user/appdata/tuliprox-vpn/config
Value: /mnt/user/appdata/tuliprox-vpn/config

DataPathrw

Tuliprox runtime data and database

Target: /app/data
Default: /mnt/user/appdata/tuliprox-vpn/data
Value: /mnt/user/appdata/tuliprox-vpn/data

BackupPathrw

Tuliprox backup directory

Target: /app/backup
Default: /mnt/user/appdata/tuliprox-vpn/backup
Value: /mnt/user/appdata/tuliprox-vpn/backup

DownloadsPathrw

Video download directory

Target: /app/downloads
Default: /mnt/user/appdata/tuliprox-vpn/downloads
Value: /mnt/user/appdata/tuliprox-vpn/downloads

EPG DataPathrw

EPG scraper data directory. Contains channels.xml (your channel list) and the generated guide.xml. Only needed if EPG_SCRAPER_ENABLED=true.

Target: /app/epg
Default: /mnt/user/appdata/tuliprox-vpn/epg
Value: /mnt/user/appdata/tuliprox-vpn/epg

VPN EnabledVariable

Enable OpenVPN tunnel

Target: VPN_ENABLED
Default: true
Value: true

VPN ProviderVariable

VPN provider: NORDVPN, PIA, SURFSHARK, IPVANISH, VYPRVPN, PROTONVPN, CUSTOM

Target: OPENVPN_PROVIDER
Default: NORDVPN
Value: NORDVPN

VPN UsernameVariable

VPN service username (for NordVPN: use service credentials from my.nordaccount.com)

Target: OPENVPN_USERNAME

VPN PasswordVariable

VPN service password

Target: OPENVPN_PASSWORD

VPN ConfigVariable

Specific .ovpn config name to use (e.g. us9196.nordvpn.com.udp). Leave blank to use first available.

Target: OPENVPN_CONFIG

VPN ProtocolVariable

OpenVPN protocol: udp or tcp

Target: OPENVPN_PROTOCOL
Default: udp
Value: udp

Extra OpenVPN OptionsVariable

Additional OpenVPN CLI flags (optional)

Target: OPENVPN_OPTIONS

Local NetworkVariable

IMPORTANT: Set to your LAN subnet (e.g. 192.168.1.0/24) so the web UI stays accessible when VPN is connected. Comma-separated for multiple subnets.

Target: LOCAL_NETWORK

DNS ServersVariable

Comma-separated DNS servers to use inside the container (optional, e.g. 1.1.1.1,8.8.8.8)

Target: NAME_SERVERS

Privoxy EnabledVariable

Enable Privoxy HTTP proxy

Target: PRIVOXY_ENABLED
Default: false
Value: false

Privoxy Port (internal)Variable

Privoxy internal port

Target: PRIVOXY_PORT
Default: 8118
Value: 8118

PUIDVariable

User ID for file permissions (use Unraid's nobody: 99)

Default: 99
Value: 99

PGIDVariable

Group ID for file permissions (use Unraid's users: 100)

Default: 100
Value: 100

UMASKVariable

File creation umask

Default: 022
Value: 022

TimezoneVariable

Timezone (e.g. America/New_York)

Target: TZ
Default: UTC
Value: UTC

DebugVariable

Enable debug logging

Target: DEBUG
Default: false
Value: false

Links

Template Support Registry Project

Details

Repository

ghcr.io/brycelarge/tuliprox-vpn:latest

Registry

https://github.com/brycelarge/tuliprox-vpn/pkgs/container/tuliprox-vpn

Last Updated2026-06-01

First Seen2026-02-18

Run tuliprox-vpn on Unraid.

tuliprox-vpn is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS