Help Home / Admin Web UI

Choose how the dashboard is reached

The Web UI can stay local to your Mac or be published safely behind TLS through Cloudflare Tunnel or your own reverse proxy.

The Admin Web UI mirrors key management surfaces in a browser, so trusted admins can check in when the Mac running SwiftBot is elsewhere. Start local, then publish it only when you need remote access.

Access modes

ModeReachable fromSupported
Local-onlyThe Mac running SwiftBot, at localhostYes, default
Cloudflare TunnelAnywhere over HTTPSYes, recommended
Custom reverse proxyWherever your proxy is reachableYes, with Override Public Base URL
Router port forwardingPublic internet directly to SwiftBotNo

Local-only access

  1. Open Web UI settings:

    Go to Settings > Web UI.

  2. Enable the Admin Web UI:

    Turn on Admin Web UI.

  3. Open it in a browser:

    Visit http://localhost:8090, or the port shown under Advanced.

Cloudflare Tunnel setup

  1. Add your domain to Cloudflare:

    Confirm the zone is active in your Cloudflare account.

  2. Create a scoped API token:

    Grant tunnel edit, DNS edit, zone read, and user read permissions.

  3. Open Internet Access:

    In SwiftBot, go to Settings > Web UI > Internet Access.

  4. Verify and enable:

    Paste the token, verify it, choose a subdomain, then enable Internet Access.

  5. Update Discord OAuth:

    Add https://your-bot.example.com/auth/discord/callback to your Discord OAuth redirects.

Don't expose the local port directly

Avoid router port forwarding to SwiftBot's local port. The local server is plain HTTP and expects a TLS-terminating tunnel or proxy for public access.

Custom reverse proxy

Forward your proxy to http://localhost:8090, terminate TLS at the proxy, then set Settings > Web UI > Advanced > Override Public Base URL to the public URL.