Install Mediarium

You need a computer or NAS that runs Docker. The steps below take about five minutes.

1. Make two folders

One for Mediarium's own settings, and one place for your downloads and media. On a NAS, create a shared folder for your media if you do not have one. Put downloads and media inside the same folder, so finished files move into your library instantly.

2. Start Mediarium

Save this as docker-compose.yml and change the folders on the left of each : to yours.

services:
  mediarium:
    image: ghcr.io/rdborg/mediarium:latest
    container_name: mediarium
    restart: unless-stopped
    security_opt:
      - no-new-privileges:true
    ports:
      - "8264:8264"
      - "58264:58264/tcp"
      - "58264:58264/udp"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DOWNLOADS_DIR=/data/downloads
      - MOVIES_DIR=/data/movies
      - TV_DIR=/data/tv
    volumes:
      - ./config:/config
      - ./data:/data

Then run docker compose up -d. Keep the restart: unless-stopped line: Mediarium uses it to restart after an update.

3. Open it

Go to http://your-server:8264. The setup takes you through your account, your folders, a Usenet provider and an indexer, and the quality you want.

Guides for your device

It is the same image everywhere, so every platform uses the same compose file or the same few fields. Pick yours:

• Docker and Docker Compose on any 64-bit Linux server (Intel/AMD or ARM)
• Linux and Raspberry Pi (a Pi 3, 4 or 5 with a 64-bit system)
• Synology (Container Manager, DSM 7.2 or newer, step by step)
• QNAP (Container Station)
• Unraid (Docker tab, Add Container)
• TrueNAS SCALE, CasaOS and ZimaOS, Portainer, OpenMediaVault: paste the same compose file into their Docker screen
• Windows and Mac through Docker Desktop

Windows and Mac: Docker Desktop works and is fine for trying Mediarium out. For a machine that runs day and night, a NAS or Linux server is better, because sharing Windows or Mac folders with Docker is slower and hardlinks may not work there. There are no separate Windows or Mac versions and no app-store entries for now: what runs where has the details.

Good to know

• The ports. 8264 is the web page. 58264 is for torrents; leave it out if you only use Usenet.
• A VPN. A WireGuard VPN is built in for torrents. It needs no extra container permissions.
• The Cloudflare helper. Some torrent sites sit behind a browser check. The latest-full image has a helper for that built in.
• On the internet. Do not open port 8264 to the internet. Put it behind HTTPS with a reverse proxy, and read the security guide first.
• Updates. Mediarium tells you when a new version is out, and can install it for you.