Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Web UI

The Web UI is mostly self-explanatory so this is just a quick tour, plus the handful of things that are only reachable through it (that is, not exposed to Subsonic clients).

Public homepage

Your configured http://<host>:<port>/ (or your external_hostname) shows a public homepage.

Note: The “Login” button will only show up on the host allowed by admin_hostname if this setting is set.

If public_now_playing is enabled, a card displays the currently playing track (off by default).

🖼️ Screenshot: public homepage

Public shares

TODO

Admin dashboard

The dashboard is organized into tabs. Most settings are editable live, while some require a server restart to take effect. A setting that’s already pinned by a CLI flag, environment variable, or config.yaml shows as locked/disabled here — see Configuration reference for the precedence rules.

Users

Create/update/delete users, toggle their roles, regenerate an API key, and manage avatars.

Server

Every Server & Network related setting.

🖼️ Screenshot: Server settings page

Library

Every Library & Metadata related setting.

🖼️ Screenshot: Library settings page

Audio

Every Audio & Jukebox related setting.

🖼️ Screenshot: Audio settings page

Security

Live view of the current IP allow/deny lists and rate-limit state (see Security). Allows adding/removing entries, and clearing rate-limit buckets.

🖼️ Screenshot: Security tab

Podcasts & radio

Add/refresh/delete podcast subscriptions and internet radio stations server-wide including radio station discovery when enable_radio_discovery is on.

🖼️ Screenshot: Radios

🖼️ Screenshot: Podcasts

Shares

View and revoke any active public share.

Chat moderation

View the full chat log, edit/delete any user’s message for moderation, or post server announcements.

🖼️ Screenshot: chat moderation panel

Beets

Interact with the Beets installation: view/update Beets’ config.yaml, trigger a Beets library rescan and view its output log.

Maintenance

Trigger a library health scan (see Encoding errors detection & self-healing streams), cleanup BeetstreamNext’s database, clear disk caches, and view the server logs.