Skip to main content
Use this when you want to access AoA over Tailscale (or a private LAN/VPN) instead of only localhost.

1. Start AoA in private authenticated mode

This configures:
  • AOA_DEPLOYMENT_MODE=authenticated
  • AOA_DEPLOYMENT_EXPOSURE=private
  • AOA_AUTH_BASE_URL_MODE=auto
  • HOST=0.0.0.0 (bind on all interfaces)
Equivalent flag:

2. Find your reachable Tailscale address

From the machine running AoA:
You can also use your Tailscale MagicDNS hostname (for example my-macbook.tailnet.ts.net).

3. Open AoA from another device

Use the Tailscale IP or MagicDNS host with the AoA port:
Example:

4. Allow custom private hostnames when needed

If you access AoA with a custom private hostname, add it to the allowlist:

5. Verify the server is reachable

From a remote Tailscale-connected device:
Expected result:

Troubleshooting

  • Login or redirect errors on a private hostname: add it with aoa allowed-hostname.
  • App only works on localhost: make sure you started with --tailscale-auth (or set HOST=0.0.0.0 in private mode).
  • Can connect locally but not remotely: verify both devices are on the same Tailscale network and port 3100 is reachable.