Happier Docs
hstack (local stack)

Remote access (Tailscale)

Use HTTPS secure context on phones/laptops via Tailscale Serve.

Remote access (Tailscale + phone)

Happier relies on “secure context” browser features (WebCrypto). Browsers treat http://localhost as a secure context, but not http://<lan-ip>:<port> or http://<tailscale-ip>:<port>.

For remote access (phone, another laptop, etc) you should use HTTPS.

The recommended approach is Tailscale Serve, which gives you an https://*.ts.net URL for your machine that is only accessible inside your tailnet.

Quickstart

  1. Install Tailscale and sign in on your computer.

  2. Enable Serve:

hstack tailscale enable
hstack tailscale url
  1. Open the URL from hstack tailscale url on another device (also signed into Tailscale).

Tip: on iOS, you can “Add to Home Screen” from Safari to use it like an app.

Automation

If Serve is already configured, hstack start will automatically prefer the https://*.ts.net URL for “public” links unless you explicitly set HAPPIER_STACK_SERVER_URL.

You can also ask hstack to enable Serve automatically at boot:

HAPPIER_STACK_TAILSCALE_SERVE=1 hstack start

Useful knobs:

  • HAPPIER_STACK_TAILSCALE_WAIT_MS
  • HAPPIER_STACK_TAILSCALE_BIN

Using the native mobile app (optional)

The Happier mobile app has an “API Endpoint” (or “Custom server URL”) setting in developer mode. Point it at the same HTTPS *.ts.net URL to use your local server.

However, the simplest option is usually the served web UI (no app updates needed).

Server flavors

Choose between happier-server-light (SQLite by default; optional PGlite) and happier-server (Docker-managed infra).

Remote daemon setup (SSH)

Install Happier on a remote host, pair credentials, and optionally install the daemon service.

On this page

Remote access (Tailscale + phone)QuickstartAutomationUsing the native mobile app (optional)