Overlook for Homepage Support

Overlook for Homepage — Support

Overlook turns your self-hosted Homepage dashboard into a native app for iPhone, iPad and Apple Watch: the same groups, services, icons and widgets, with status dots, live figures, home screen widgets and alerts when a service goes down. It only needs your Homepage address — no API keys. Without a Homepage to connect to, it has nothing to show.

Overlook is an independent app, not made by or affiliated with the Homepage project.

Need help, found a bug, or have an idea?

Email overlook@alexandre-vazquez.com, or use Settings → Send feedback in the app. Please include:

  • What you were trying to do, and what happened instead
  • Your device and its iOS/iPadOS/watchOS version, and your Homepage version
  • The widget type, if the problem is with one service

Requirements

  • A running Homepage (tested with Homepage 1.x) that this device can reach: on your home network, or at a public address.
  • HOMEPAGE_ALLOWED_HOSTS: Homepage only answers its API for the host names it allows. Add the exact address you type in Overlook, with the port if it is not 80/443 — for example HOMEPAGE_ALLOWED_HOSTS=192.168.1.10:3000,home.example.com — and restart Homepage. Overlook detects this case and tells you which value to add.
  • Login in front of Homepage (Authentik, Authelia, other SSO or basic auth): Overlook reads Homepage’s API directly and cannot go through a login page. Use Homepage’s internal address (for example http://192.168.1.10:3000), or let /api/ through without authentication in your reverse proxy. Overlook recognises a login page and says so.
  • Local Network permission on iPhone and iPad (Settings → Privacy & Security → Local Network → Overlook) when Homepage is on your home network.

Getting started

  1. Open Overlook and type your Homepage address, for example http://192.168.1.10:3000.
  2. Overlook checks it and explains what to change if it cannot connect (host not allowed, login page, wrong port, certificate, network).
  3. Your dashboard appears with Homepage’s own groups and order. Tap a service to open it, as in Homepage; touch and hold it for its details.

Frequently asked questions

  • Do I have to enter my services’ API keys? No. Homepage keeps them on your server and adds them itself; Overlook never sees them.
  • Which widgets are supported? Dedicated layouts for the most common ones (Proxmox, Pi-hole, AdGuard, the *arr apps, Jellyfin, Immich, Nginx Proxy Manager, Gitea, Portainer, qBittorrent and more), plus a generic view for the rest of Homepage’s widget types. HTML (iframe) widgets are shown inside the card, as in Homepage.
  • “Homepage does not allow this address”. See HOMEPAGE_ALLOWED_HOSTS above.
  • “Could not connect”. Check that Homepage opens in Safari on the same device and network. Plain http:// addresses are allowed. A TLS certificate the device does not trust will fail.
  • A widget shows old data. Home screen widgets refresh when iOS allows it (usually every 15–30 minutes). Opening Overlook refreshes them at once.
  • How fast are down alerts? Overlook checks in the background when iOS gives it time, which can be from 15 minutes to a few hours. It is a convenience, not real-time monitoring.
  • Apple Watch. The watch gets your Homepage from the iPhone and refreshes on its own when it can reach Homepage. Complications show the number of services that need attention, or one service.
  • Is anything uploaded? No. Your dashboard goes from your Homepage to your devices and nowhere else. See the privacy policy below.

Free and Overlook Pro

Free: one Homepage with the full dashboard — every group, service, widget and figure, HTML widgets, search, light and dark mode, on iPhone and iPad.

Overlook Pro (monthly or annual subscription, or a one-time lifetime purchase; the annual plan may include a free trial for eligible accounts) adds:

  • Several Homepage instances, synced between your devices through your iCloud
  • Home screen, StandBy and Lock Screen widgets: summary, one service, several services
  • The Apple Watch app and its complications
  • Down and back-up alerts
  • Accent themes

Prices are shown in the app before you buy. Subscriptions renew automatically unless cancelled at least 24 hours before the end of the period; manage or cancel them in Settings → [your name] → Subscriptions. To restore Pro on a new device: Overlook → Settings → Restore Purchases. If a subscription ends, nothing is deleted: extra instances stay locked until you subscribe again.

Privacy

Overlook has no account and collects no data. See the Overlook Privacy Policy. Terms of use: Apple’s standard EULA.

Versión en español: Soporte de Overlook.