Dashboard

TSDProxy includes a built-in web dashboard that displays all your proxies in real time. Each proxy is shown as a card with its status, URL, icon, and port information. The dashboard updates automatically via Server-Sent Events (SSE) as proxies start, stop, or change status.

Accessing the dashboard

The dashboard is served on the HTTP port configured in your tsdproxy.yaml (default 8080, bound to 127.0.0.1). To access it locally:

http://localhost:8080

To access the dashboard from your Tailscale network, you need to expose it as a proxy — just like any other service.

Exposing via Tailscale

services:
  tsdproxy:
    image: almeidapaulopt/tsdproxy:2
    # ... other config ...
    labels:
      tsdproxy.enable: "true"
      tsdproxy.name: "dash"
      tsdproxy.port.1: "443/https:8080/http"

docker compose restart

dash:
  ports:
    443/https:
      targets:
        - http://127.0.0.1:8080

curl https://dash.FUNNY-NAME.ts.net

Dashboard configuration

Customize how each proxy appears on the dashboard using labels (Docker) or the dashboard section (Lists).

Docker labels

Example:

labels:
  tsdproxy.enable: "true"
  tsdproxy.name: "nas"
  tsdproxy.dash.label: "File Server"
  tsdproxy.dash.icon: "si/synology"
  tsdproxy.dash.category: "Storage"

Lists provider

Use the dashboard section in your proxy list entry:

nas:
  ports:
    443/https:
      targets:
        - http://nas.local:5001
  dashboard:
    visible: true
    label: "File Server"
    icon: "si/synology"

Viewer and Admin Roles

The dashboard has two access tiers:

• Viewers — all tailnet users who can reach the dashboard. They can view proxy status, health, uptime, browse with search/filter/group, and manage their own preferences. The Actions and Logs tabs are hidden.
• Admins — users in the admins list or authenticated via API key. They see the full dashboard including the Actions tab (restart, pause, resume, reauth) and Logs tab (live access log streaming).

See Admin Allowlist for configuration details.

Dashboard Features

Real-time updates

The dashboard uses Server-Sent Events (SSE) via htmx hx-sse to stream updates. Proxy cards, status badges, and action panels update in real time without page reloads.

Views

Toggle between grid (card) and list views. The list view shows proxies in a compact row layout for monitoring many proxies at once. Switch views using the view toggle in the toolbar — your preference is persisted per-user.

Sorting, filtering, and grouping

• Sort by name, status, or health
• Filter by status (Running, Stopped, Error, Paused) and health (Up, Down)
• Group by category using the tsdproxy.dash.category label

All sorting, filtering, and grouping is server-side. Click a toolbar button to change the view — the server returns pre-rendered HTML fragments.

Search

Type in the search bar to filter proxies by name or label. Search is transient (per-session) and not persisted across browser sessions.

Per-user preferences

Preferences are persisted per Tailscale user at {DataDir}/dashboard/preferences/{userID}.json and sync across browser sessions:

Proxy detail modal

Click a proxy card to open the detail modal with tabs:

• Info — proxy configuration, ports, Tailscale settings, target provider
• Actions — restart, pause, resume, reauth (admin only)
• Logs — live access log stream (admin only)

The modal persists across dashboard list refreshes — it is rendered outside the proxy list DOM so SSE updates don’t close an open modal.

Status timeline and uptime

Each proxy card shows the current uptime duration. The detail modal displays a status change timeline with timestamps.

Browser notifications

Enable browser notifications to receive alerts when proxies change status (Running, Stopped, Error). Click the notification bell icon in the toolbar to enable — your browser will prompt for permission.

Version display

The running TSDProxy version is shown in the dashboard footer.

Keyboard Shortcuts

Architecture

The dashboard frontend is built with:

• htmx 4 with hx-sse extension for real-time updates
• templ for server-side rendered HTML components
• Server-Sent Events for streaming proxy status updates
• DaisyUI for styling with dark/light theme support

The previous Datastar-based frontend has been removed. If you had custom CSS or JS overrides targeting Datastar internals, you will need to update them.