Admin Panel
Inhalt
The admin panel provides full control over the instance — users, content, appearance, legal pages, and settings. It is accessible only to accounts with the Admin role.
Accessing Admin
Navigate to /admin while logged in as an Admin. If your account does not have the Admin role, you will see a "Kein Zugriff" (no access) notice with your current role instead of the panel. See Auth & Users — Admin Bootstrap for first-run setup.
Admin Sections
| Section | Path | Description |
|---|---|---|
| Dashboard | /admin |
Stats on users, videos, channels, views and theme changes |
| Users | /admin/users |
Search, roles, ban, delete, password reset mail |
| Videos | /admin/videos |
Full video list, change visibility, delete |
| Moderation | /admin/moderation |
Review reports, takedown or ignore |
| Theme | /admin/theme |
6-layer live theme editor |
| Page blocks | /admin/page-blocks |
Homepage layout blocks |
| Categories | /admin/categories |
Categories and icons |
| Pages | /admin/pages |
Impressum, Datenschutz, AGB and other static pages |
| System | /admin/system |
Database, migrations, queue counts, environment values |
| Settings | /admin/settings |
Site name, registration, video defaults, SMTP |
| Email templates | /admin/email-templates |
Texts of the system mails |
Theme Editor
The theme editor at /admin/theme provides a live, no-reload interface for customizing every visual property of the instance.
Quick workflow:
- Open
/admin/theme - Pick a built-in preset as your starting point (e.g.
itsweber-dark) - Use the colorpicker and sliders to adjust semantic tokens (brand color, background, text, radii)
- Switch to the Custom CSS tab for freeform overrides
- Rearrange homepage blocks on the separate page
/admin/page-blocks - Click Save — changes are live for all visitors immediately
For full documentation of the 6-layer system, token mappings, and logo filter presets, see Theming System.
Legal Templates
The instance's legal pages are editable from /admin/pages. Three pages are available:
| Page | Path | Description |
|---|---|---|
| Impressum | /impressum |
German legal imprint (required by law for DE instances) |
| Datenschutzerklarung | /datenschutz |
Privacy policy / GDPR statement |
| AGB | /agb |
Terms of service |
The starter templates in docs/legal-templates/ contain placeholders such as {{ANBIETER_NAME}}, {{ANBIETER_EMAIL}}, {{PLATTFORM_NAME}} or {{PLATTFORM_DOMAIN}}. They are not filled automatically and must be replaced by hand before going live.
Page content is edited and stored as HTML.
User Management
From /admin/users:
- Search for users
- Change role — promote to Moderator, Creator, or Admin; demote back to Viewer
- Ban — marks the account as banned and ends its sessions immediately. A check on the next login is not found in the code
- Password reset — send a reset mail to the user
- Delete account — permanently removes the user record, their videos are deleted along with it via cascade
Role changes take effect on the user's next request (no forced logout required — the session re-checks role on each privileged action).
Moderation Workflow
Reports submitted by users appear in /admin/moderation.
Report lifecycle:
- A viewer clicks "Report" on a video or comment
- They select one of seven reasons (spam, abuse, copyright, nudity, violence, dangerous, other)
- The report appears in the queue with status
OPEN - An Admin reviews it and chooses Takedown (video is set to private, comment is soft-deleted) or Ignore
- The report is marked
RESOLVED_TAKEDOWNorRESOLVED_IGNOREDwith resolver and timestamp