Product

Compatibility

Supported iOS versions, Apple devices, PostHog hosts, widget sizes, and practical network requirements.

Supported platforms

Operating system

iOS 17 or later.

Devices

iPhone and iPad device families.

Home Screen widget

Small and medium WidgetKit families.

Supported PostHog hosts

  • PostHog US Cloud at https://us.posthog.com.
  • PostHog EU Cloud at https://eu.posthog.com.
  • A custom or self-hosted HTTPS base URL reachable by the device.

A host-level connection can succeed while a specific view still lacks permission. Feature access depends on the selected project's data and the read scopes granted through OAuth or the personal API key fallback.

OAuth sign-in requires the selected host to publish valid OAuth metadata and support S256 PKCE. HogScope checks this before opening PostHog's sign-in page; a narrowly scoped personal API key remains available for deployments without compatible OAuth support.

Network requirements

Live data requires network access to the selected host. A self-hosted instance may also require a VPN, private DNS, firewall rules, or a certificate trust profile configured at the device level. Cached results do not guarantee the current state.

What is not supported

  • Android, Windows, macOS, and web app clients are not present in this repository.
  • PostHog write operations are disabled in the mobile client.
  • Widget refresh timing cannot be guaranteed because iOS controls WidgetKit scheduling.
  • Not every session recording contains the full snapshot or visual frames needed for playback.

Read the self-hosted connection guide