Administration Overview
This section covers the administration features of streamarr.media. The admin area lives at /admin and is reachable via the user menu (top right) → Administration.
Who can access the admin area?
Only users with superuser privileges can open /admin. Regular permissions and groups control what users can see and play — they never grant admin access. See Users & Groups.
First Steps as Admin
After installation, the setup wizard at /install creates your admin account. From there, a typical setup order is:
- Configure metadata providers — TMDB/TVDB for movies and shows, IGDB for games, MusicBrainz/Spotify for music, OpenLibrary for books → Plugins
- Create libraries — at least one library per media type you want to serve → Libraries
- Add indexers — Newznab/Torznab sources for automated release searching → Indexers
- Set up download clients — SABnzbd, Deluge, or the built-in torrent/usenet/Spotify downloaders → Download Clients
- Review transcoding — containerized FFmpeg settings and playback profiles → Transcoding
- Invite users — create accounts, groups, permissions, and parental controls → Users & Groups
- Customize the experience — home page layouts, banners, curated content → Page Layouts
Admin Areas
The tables below follow the four sections of the admin sidebar.
Monitoring & Queues
| Menu item | What it does | Documentation |
|---|---|---|
| Dashboard | System health, active streams, downloads, user stats, library sizes, storage | Dashboard |
| Downloads | Live download queue with progress and speed | Download Clients |
| Active Sessions | Running transcoding/streaming sessions | Monitoring |
Libraries
Each library type (Movies, Shows, Games, Music, Books) has its own settings page, covering paths, metadata, quality profiles, and release scoring. New libraries are created via Create Library. See Libraries.
Users & Curation
| Menu item | What it does | Documentation |
|---|---|---|
| Users / Groups | Accounts, groups, permissions, parental controls | Users & Groups |
| Invites | Invitation-based registration | Users & Groups |
| Devices | Registered devices across all users | Users & Groups; user side: Devices, Casting & Offline |
| Lists | Browse and manage all user and system lists by type, visibility, and owner | Smart Collections & Overlays |
| Smart Collections | Rule-based lists populated automatically from external sources (Trakt, IMDb, Letterboxd, …) on a cron schedule | Smart Collections & Overlays |
| Poster Overlays | Composite badges (4K, HDR, streaming logos, …) onto posters via conditional templates | Smart Collections & Overlays |
| Mass Operations | Rule-based bulk metadata edits (genres, studios, sort titles, …) | Smart Collections & Overlays |
| Page Layouts | Configure home and library page sections | Page Layouts |
System
| Menu item | What it does | Documentation |
|---|---|---|
| Banners | System-wide announcements shown to users | Banners |
| Subscription Packages | Plans users can subscribe to via Stripe, with group assignments | Membership & Vouchers |
| Vouchers | Redeemable membership codes, batch creation and CSV export | Membership & Vouchers |
| Settings | Site name, OIDC SSO, subscription/invite/friends toggles, library toggles, favorites automation, global permission defaults, backup & restore | System Settings |
| Transcoding | FFmpeg transcoding configuration | Transcoding |
| Downloaders | Download client connections | Download Clients |
| Indexers | Newznab/Torznab indexer management | Indexers |
| Metadata | Metadata provider configuration | Plugins |
| Game Runtimes | Container images and environments that cloud-gaming sessions launch in | System Settings; hosting: Deployment |
| Tasks | Manually trigger background tasks and inspect run history | Maintenance & Backups |
| Logs | Transcoding session logs and filterable activity logs (event type, severity, entity, date) | Monitoring |
| Parties | Overview of active watch parties and connected users | Monitoring; user side: Watch Parties |
Some entries are conditional
Subscription Packages and Vouchers only appear in the sidebar while subscriptions are enabled under Settings → Subscriptions & Payments. When disabled, all users have unrestricted access and subscription UI is hidden.
Back up before bulk changes
Mass operations, overlay re-renders, and database restores affect many items at once. Export a settings or database backup first — see Maintenance & Backups.