playeronegameover/mediahub repository overview

⁠MediaHub

A self-hosted media dashboard for your Radarr and Sonarr libraries. Clean dark UI with multi-user support, MFA, and invite-based registration.

⁠Features

• Dashboard with recently added movies & series (sorted by actual import date) with trailer playback buttons, plus upcoming releases (next 180 days) with date, release type, and in-library indicator; trending strip shows a Requested badge for items already in Overseerr; "Show All" link opens a dedicated page with infinite scroll
• Background sync - media library stored locally in the database and refreshed automatically (configurable 5-60 min interval); pages load from DB instead of hitting Radarr/Sonarr on every request
• Optional sync log - rolling record of background sync results (0-14 day retention); admin-only page hidden when disabled
• Searchable, filterable media library grid with infinite scroll
• Search - real-time TMDb search across movies and TV shows with type filter, in-library / requested / rating badges, and state preserved when navigating back from a detail page
• Trending page - weekly TMDb trending titles with infinite scroll, in-library badge, and Requested badge for items queued in Overseerr
• Upcoming releases calendar
• Movie/series detail pages with tagline, trailer playback, cast/crew, in-library badge, and Requested badge for monitored items not yet downloaded
• Media requests - request movies and TV shows from the detail, trending, or search pages with a confirmation dialog for download location and quality profile. Requests go to Overseerr/Seerr first if configured, with fallback to Radarr/Sonarr
• Location-based permissions - admins can restrict which library locations each user can see; root folders in the request dialog are filtered to only show allowed locations
• Multi-user with administrator and user roles
• Invite-based registration (no email server required)
• Optional TOTP two-factor authentication (QR code generated locally - your secret never leaves the server)
• Fully responsive mobile-friendly UI
• Rate limiting on login: 5 attempts per IP per 15 minutes
• API keys masked in Settings with reveal toggle
• Light, dark, and system themes
• About page with version info and tech stack

⁠Quick Start

1. Create a data directory:

mkdir -p /home/docker/mediahub/data

2. Create a docker-compose.yml:

services:
  mediahub:
    image: playeronegameover/mediahub:latest
    container_name: mediahub
    restart: unless-stopped
    ports:
      - "3333:3333"
    volumes:
      - /home/docker/mediahub/data:/var/data
    environment:
      NODE_ENV: production
      HOST: 0.0.0.0
      PORT: 3333
      LOG_LEVEL: info
      TZ: UTC
      SESSION_DRIVER: cookie
      COOKIE_SECURE: "false"
      LIMITER_STORE: database
      DB_DATABASE: /var/data/mediahub.sqlite3
      UPLOADS_PATH: /var/data/uploads
      APP_KEY: ${APP_KEY}

3. Create a .env file alongside your docker-compose.yml:

APP_KEY=your-secret-key-here

Generate a secure key with:

docker run --rm playeronegameover/mediahub:latest node ace generate:key

4. Start:

docker compose up -d

5. Run migrations:

docker exec -it mediahub node ace migration:run --force

6. Create the admin user:

docker exec -it mediahub node ace db:seed --files="database/seeders/admin_user_seeder.ts"

Default login:

• Email: [email protected]
• Password: admin1234

7. Open: http://your-server-ip:3333

After logging in, go to Settings to configure your Radarr and Sonarr API connections.

⁠Updating

docker compose pull
docker compose up -d
docker exec -it mediahub node ace migration:run --force

⁠Environment Variables

⁠In-App Settings

All API integrations are configured via the Settings page after login (stored in the database, not environment variables).

⁠Reverse Proxy

Nginx:

server {
    listen 80;
    server_name mediahub.example.com;

    location / {
        proxy_pass         http://127.0.0.1:3333;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection 'upgrade';
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

IIS (requires URL Rewrite + ARR modules):

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Proxy to MediaHub" stopProcessing="true">
          <match url="(.*)" />
          <action type="Rewrite" url="http://localhost:3333/{R:1}" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

⁠Security