Skip to content
Login

Service Integrations

Quick-start guides for popular homelab and self-hosted services. All examples use --allow for SSO access control โ€” replace the email with your own or remove it to require login from the tunnel owner only.

Platform Guides


Home Automation

๐Ÿ  Home Assistant

Home automation platform. WebSocket required for full UI functionality including Lovelace dashboards and real-time entity updates. Install via the HA Add-on

Terminal window
hle expose --service http://localhost:8123 \
--label ha --websocket \
--allow alex@gmail.com

๐Ÿ”ด Node-RED

Visual automation platform. WebSocket needed for flow editorโ€™s live debugging.

Terminal window
hle expose --service http://localhost:1880 \
--label nodered --websocket \
--allow alex@gmail.com

๐Ÿก openHAB

Open-source home automation software.

Terminal window
hle expose --service http://localhost:8080 \
--label openhab

๐Ÿ˜๏ธ Domoticz

Home automation system.

Terminal window
hle expose --service http://localhost:8080 \
--label domoticz

๐Ÿ“ก Zigbee2MQTT

Zigbee to MQTT gateway. WebSocket needed for live device map.

Terminal window
hle expose --service http://localhost:8080 \
--label z2m --websocket

Media & Entertainment

๐ŸŽฌ Jellyfin

Open-source media system. WebSocket for real-time playback sync.

Terminal window
hle expose --service http://localhost:8096 \
--label jellyfin --websocket \
--allow google:alex@gmail.com

๐ŸŽฅ Plex

Closed-source media server.

Terminal window
hle expose --service http://localhost:32400 \
--label plex

๐Ÿ“บ Emby

Media server and streaming platform.

Terminal window
hle expose --service http://localhost:8096 \
--label emby

๐ŸŽต Navidrome

Open-source music streaming server.

Terminal window
hle expose --service http://localhost:4533 \
--label music

๐Ÿ“š Calibre-Web

Web interface for Calibre e-book library.

Terminal window
hle expose --service http://localhost:8083 \
--label books

๐Ÿ“ธ Immich

Open-source photo/video backup. Great for sharing photo albums with family.

Terminal window
hle expose --service http://localhost:2283 \
--label photos --websocket \
--allow google:mom@gmail.com

๐ŸŽง Audiobookshelf

Audiobook and podcast streaming server.

Terminal window
hle expose --service http://localhost:13378 \
--label audiobooks

๐ŸŽž๏ธ Overseerr

Plex/Emby request management.

Terminal window
hle expose --service http://localhost:5055 \
--label overseerr

Development & DevOps

๐Ÿ™ Gitea

Self-hosted Git service. Perfect for webhook ingress from GitHub/GitLab.

Terminal window
hle expose --service http://localhost:3000 \
--label git

๐Ÿ‹ Portainer

Docker management UI. Manage containers remotely with SSO protection.

Terminal window
hle expose --service http://localhost:9000 \
--label portainer \
--allow alex@gmail.com

๐Ÿ“Š Grafana

Monitoring and observability. WebSocket required for live dashboards.

Terminal window
hle expose --service http://localhost:3000 \
--label grafana --websocket \
--allow github:devops-lead

๐Ÿ“ˆ Uptime Kuma

Uptime monitoring. WebSocket needed for real-time status page.

Terminal window
hle expose --service http://localhost:3001 \
--label status --websocket

๐Ÿ’ป Code Server / VS Code

Browser-based VS Code. WebSocket required. Perfect for coding on the go.

Terminal window
hle expose --service http://localhost:8080 \
--label code --websocket \
--allow google:alex@gmail.com

โšก n8n

Workflow automation platform.

Terminal window
hle expose --service http://localhost:5678 \
--label n8n --websocket

๐Ÿ”ฅ Prometheus

Metrics and monitoring database.

Terminal window
hle expose --service http://localhost:9090 \
--label prom

Networking & Security

๐Ÿ›ก๏ธ Pi-hole

DNS ad-blocker and DHCP server.

Terminal window
hle expose --service http://localhost:80 \
--label pihole

๐Ÿšซ AdGuard Home

Ad-blocking DNS server.

Terminal window
hle expose --service http://localhost:3000 \
--label adguard

๐Ÿ” WireGuard UI

WireGuard configuration interface.

Terminal window
hle expose --service http://localhost:51821 \
--label wg

๐Ÿ”„ Nginx Proxy Manager

Reverse proxy and certificate manager.

Terminal window
hle expose --service http://localhost:81 \
--label npm

Productivity & Files

โ˜๏ธ Nextcloud

Cloud storage and collaboration platform. Share with family or team.

Terminal window
hle expose --service http://localhost:80 \
--label cloud --websocket \
--allow google:alex@gmail.com \
--allow google:partner@gmail.com

๐Ÿ“„ Paperless-ngx

Document management system.

Terminal window
hle expose --service http://localhost:8000 \
--label docs

๐Ÿ”‘ Vaultwarden

Password manager server. WebSocket required for live sync.

Terminal window
hle expose --service http://localhost:80 \
--label vault --websocket \
--allow alex@gmail.com

๐Ÿ“– Bookstack

Knowledge management wiki.

Terminal window
hle expose --service http://localhost:6875 \
--label wiki

๐Ÿณ Mealie

Recipe and meal planning application.

Terminal window
hle expose --service http://localhost:9925 \
--label recipes

๐Ÿ’ฐ Actual Budget

Personal budgeting application.

Terminal window
hle expose --service http://localhost:5006 \
--label budget

NAS & Storage

๐Ÿ’ฝ Synology DSM

NAS web interface. Expose NAS web UI without port forwarding.

Terminal window
hle expose --service http://localhost:5000 \
--label nas \
--allow alex@gmail.com

๐Ÿ—„๏ธ TrueNAS

FreeBSD-based NAS operating system.

Terminal window
hle expose --service http://localhost:80 \
--label truenas

๐Ÿ“ฆ OpenMediaVault

Open-source NAS solution.

Terminal window
hle expose --service http://localhost:80 \
--label omv

Home Network

๐Ÿ”ฅ pfSense / OPNsense

Open-source firewalls.

Terminal window
hle expose --service https://localhost:443 \
--label firewall

๐Ÿ“ถ UniFi Controller

WiFi and network management.

Terminal window
hle expose --service https://localhost:8443 \
--label unifi

๐Ÿ“ท IP Cameras

Expose any IP camera web interface.

Terminal window
hle expose --service http://192.168.1.100:8080 \
--label cam1 \
--allow alex@gmail.com

Advanced Integrations

Services that need extra configuration โ€” custom headers, trusted proxies, websocket paths, or docker-compose changes.

๐Ÿ“น Frigate NVR

Real-time AI object detection for cameras. WebSocket needed for live MJPEG streams and event notifications. Pair with --allow to check your cameras remotely.

Terminal window
hle expose --service http://localhost:5000 \
--label cameras --websocket \
--allow google:alex@gmail.com

๐Ÿ  Home Assistant + Companion App

Full HA setup including WebSocket for Lovelace and Companion App push. Set your tunnel URL as the External URL in HA > Settings > System > Network.

Terminal window
# Expose HA with websocket support
hle expose --service http://localhost:8123 \
--label ha --websocket \
--allow google:alex@gmail.com
# In HA: Settings > System > Network
# Set External URL to your HLE tunnel URL
# e.g. https://ha-x7k.hle.world

๐Ÿงช Jupyter Notebook / Lab

WebSocket required for kernel communication. You must configure Jupyter to accept the HLE tunnel hostname as an allowed origin.

Terminal window
# Start Jupyter with permissive origin (HLE handles auth)
jupyter lab --ip=0.0.0.0 --port=8888 \
--NotebookApp.allow_origin='*' \
--no-browser
# Expose it
hle expose --service http://localhost:8888 \
--label jupyter --websocket \
--allow google:alex@gmail.com

๐Ÿ”„ Syncthing

File sync with a web UI on port 8384. Syncthing binds to 127.0.0.1 by default โ€” no extra config needed. The GUI requires CSRF tokens, so use the same browser session.

Terminal window
hle expose --service http://localhost:8384 \
--label sync \
--allow google:alex@gmail.com

๐Ÿ”Œ ESPHome Dashboard

OTA firmware builder for ESP devices. WebSocket needed for live log streaming. Ideal for flashing devices when youโ€™re away from home.

Terminal window
hle expose --service http://localhost:6052 \
--label esphome --websocket \
--allow google:alex@gmail.com

๐Ÿ–ฅ๏ธ Proxmox VE Web UI

The Proxmox management interface runs on HTTPS port 8006 with a self-signed cert. HLE handles the TLS termination โ€” use https:// in the service URL. See the Proxmox guide for full setup.

Terminal window
hle expose --service https://192.168.1.10:8006 \
--label proxmox --websocket \
--allow google:alex@gmail.com

๐Ÿ™ Gitea + Webhooks

Self-hosted Git with webhook ingress. Expose Gitea so external services (GitHub, CI runners) can send webhooks to your instance. Set the ROOT_URL in app.ini to your tunnel URL.

Terminal window
# In gitea/conf/app.ini:
# ROOT_URL = https://git-x7k.hle.world/
hle expose --service http://localhost:3000 \
--label git --websocket \
--allow google:alex@gmail.com

๐ŸŽฅ Plex + Remote Access

Replace Plexโ€™s built-in remote access with HLE. In Plex > Settings > Network, set Custom server access URLs to your tunnel URL. Disable โ€œRemote Accessโ€ to avoid port conflicts.

Terminal window
hle expose --service http://localhost:32400 \
--label plex \
--allow google:alex@gmail.com \
--allow google:partner@gmail.com
# Plex Settings > Network:
# Custom server access URLs:
# https://plex-x7k.hle.world

๐Ÿค– Ollama + Open WebUI

Run LLMs locally with Ollama and expose the Open WebUI interface. WebSocket needed for streaming token output. Keep the Ollama API (11434) local โ€” only expose the web UI.

Terminal window
# Ollama API stays local (port 11434)
# Only expose Open WebUI
hle expose --service http://localhost:3000 \
--label ai --websocket \
--allow google:alex@gmail.com

๐ŸŽฎ Minecraft (Bedrock/Java via web map)

Expose BlueMap or Dynmap live world maps. Share a read-only map with friends โ€” no port forwarding on the game server needed.

Terminal window
# BlueMap web map (default port 8100)
hle expose --service http://localhost:8100 \
--label mc-map \
--allow google:alex@gmail.com \
--allow google:friend@gmail.com
# Dynmap (default port 8123 โ€” careful, same as HA)
hle expose --service http://localhost:8123 \
--label dynmap \
--allow google:alex@gmail.com