CloudPub for Home Assistant: remote access without a public IP

AlfaHost Powerful VPS
Hosting Dedicated resources, full root access and 99.8% uptime NVMe Root 99.8% Choose a plan Fast · Reliable · Transparent

CloudPub Client is an unofficial Home Assistant add-on that gives you remote access to HA and other local services without a public (white) IP. It opens a tunnel to CloudPub and you get an HTTPS URL like https://….cloudpub.ru.

A practical alternative to KeenDNS, Dataplicity, Ngrok, Cloudflared and similar tools — especially when your ISP puts you behind NAT and port forwarding is not an option.

What you get

• access to Home Assistant from the internet without a public IP;
• HTTPS on the CloudPub side;
• the HA web UI usually works on the free CloudPub plan;
• optional publication of other local services (MQTT, RTSP, etc. — often on PRO).

The add-on is unofficial and not affiliated with CloudPub: black-roland/hassio-addon-cloudpub.

Add the repository in Home Assistant

1. Open Settings → Add-ons → Add-on store.
2. Menu (three dots) → Repositories.
3. Add:
   https://github.com/black-roland/hassio-addon-cloudpub
4. Refresh and install CloudPub Client (stable; Canary is for testing only).

Allow the reverse proxy in Home Assistant

Without this you often get 400: Bad Request — HA does not trust proxy headers by default.

1. Go to Settings → System → Network.
2. Under HTTP server → Reverse proxies enable Use X-Forwarded-For.
3. Add trusted proxy: 172.30.33.0/24.
4. Save.

API key and Home Assistant publication

1. Sign up in the CloudPub dashboard and copy the API key.

2. In the add-on open Configuration, paste the key and add a publication for Home Assistant.

In most cases use port 8123 — the default HA UI port. If yours differs, use that:

name: homeassistant
type: http
local_addr: homeassistant:8123

3. Save and start the add-on (enable Start on boot).

Where to find the external URL

Look for the remote Home Assistant URL in the add-on logs: CloudPub Client → Log tab. After a successful start you will see a public URL like https://….cloudpub.ru.

Minimal config example

token: YOUR_API_KEY
clo_log_level: info
services:
  - name: homeassistant
    type: http
    local_addr: homeassistant:8123

Details: cloudpub/DOCS.md.

Summary

Add the repo → install CloudPub Client → allow the proxy in HA network settings → paste the API key → publish homeassistant:8123 (or your port) → copy the URL from the add-on log. Remote access without a public IP is ready.