Skip to content

Reverse Proxy: Apache

Ben edited this page Nov 1, 2026 · 8 revisions

This template can be used when configuring Apache as a reverse proxy for the Homebridge UI.

The UI runs on port 8581 by default. If you changed the UI port, use your port instead of 8581 below.

# virtual host - adjust to suit
<VirtualHost *:80>
        ServerName homebridge.domain.com
        ServerAdmin me@domain.com
        DocumentRoot /var/www/html

        <Location />
            ProxyPass http://localhost:8581/
            ProxyPassReverse http://localhost:8581/
            RewriteEngine on
            RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
            RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
            RewriteRule .* ws://localhost:8581%{REQUEST_URI} [P]
        </Location>
</VirtualHost>
# Ensure these modules are loaded somewhere in your httpd.conf
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so

Installation

Homebridge Help

Homebridge UI Help

Versioning

Plugins

Raspberry Pi Image
Docker
Synology Package
HAP-NodeJS

Developers

Clone this wiki locally