Remote and mobile access

Reach your own host from a private network and connect the native iOS client.

Private access with Tailscale

The service installers configure Tailscale Serve and print the private dashboard URL. Use the URL from your own installation on a device connected to the same tailnet.

The macOS installer uses HTTPS port 4317; the Linux installer uses Tailscale Serve’s default HTTPS port. Copy the printed URL, including its port when present.

ACPDash has no built-in login. Use a trusted private network or an authenticated reverse proxy. Do not expose the host directly to the public internet.

Direct LAN access

Bind the host to the network interface with separate free ports:

HOST=0.0.0.0 PORT=4340 ACPDASH_PREVIEW_PORT=4341 bun start

Open http://<host-LAN-IP>:4340 from the other device. Replace the placeholder with your host’s LAN address. localhost on a phone refers to that phone, not your server.

Configure previews

HTML and live previews use a separate origin. Configure ACPDASH_PREVIEW_BIND, ACPDASH_PREVIEW_PORT, and ACPDASH_PREVIEW_ORIGIN for an address reachable by the client.

The preview hostname must differ from the dashboard hostname. A second port alone is not enough. If the dashboard works but an HTML preview is blank on your phone, check whether the configured preview origin still points to loopback.

For a custom reverse proxy, route the dashboard and preview listener through separate hostnames. Use your own private addresses in configuration. This website does not embed an installation’s private DNS name.

Native iOS client

Open ios/ACPDash.xcodeproj in Xcode, choose your development team and device, then build and run. In the app’s Settings, enter the host’s LAN or private Tailscale URL.

For a signed Preview build from the repository root:

ios/scripts/build.sh Preview DEVELOPMENT_TEAM=YOUR_TEAM_ID CODE_SIGN_STYLE=Automatic

The output is ios/build/products/Preview-iphoneos/ACPDash.app. Preview uses the dev.acpdash.ios.preview bundle ID and does not enable push notifications. Native features can differ from the responsive web dashboard.

The iOS README covers provisioning, installation, notifications, and native verification.