Self-hosted media pipeline: auto-identifies, transcodes, and organizes video into your library
1.6K
Ingest · Transcode · Organize
MediaForge is a self-hosted media ingest engine. Drop a file in the watch folder and MediaForge handles the rest — it detects the codec, identifies the title via TVDB/TMDB/OMDb, renames it to match your media server's conventions, and routes it straight to your library. H.264 files are automatically queued for hardware-accelerated HEVC encoding first. Nothing lands in your library until it's identified, named correctly, and fully processed.
MediaForge is not a media server — it feeds Plex, Jellyfin, Emby, or any other media server that watches a library folder.
docker run -d \
--name=mediaforge \
-p 8080:8080 \
-e PUID=99 -e PGID=100 \
-v /path/to/appdata/mediaforge:/config \
-v /path/to/incoming:/incoming \
-v /path/to/cache/staging:/staging \
-v /path/to/media/Movies:/media/Movies \
-v "/path/to/media/TV Shows:/media/TV Shows" \
--restart unless-stopped \
braydin72/mediaforge:latest
Then open http://[HOST-IP]:8080, add your TMDB/TVDB API keys in Settings, and point the watch folder at your incoming directory.
services:
mediaforge:
image: braydin72/mediaforge:latest
container_name: mediaforge
runtime: nvidia # remove if not using NVIDIA
environment:
- PUID=99
- PGID=100
- NVIDIA_VISIBLE_DEVICES=all # remove if not using NVIDIA
- NVIDIA_DRIVER_CAPABILITIES=all # remove if not using NVIDIA
ports:
- 8080:8080
volumes:
- /path/to/appdata/mediaforge:/config
- /path/to/incoming:/incoming
- /path/to/cache/staging:/staging
- /path/to/media/Movies:/media/Movies
- /path/to/media/TV Shows:/media/TV Shows
restart: unless-stopped
| Path | Purpose |
|---|---|
/config | App config, database, and logs (mediaforge.yaml) |
/incoming | Watch folder — drop new media here |
/staging | Working directory for in-progress transcodes (put on fast storage) |
/media/Movies | Movie library output |
/media/TV Shows | TV show library output |
MediaForge falls back to CPU encoding automatically if no GPU is configured.
--runtime=nvidia, set NVIDIA_VISIBLE_DEVICES=all and NVIDIA_DRIVER_CAPABILITIES=all--device=/dev/dri and set PGID to the group owning /dev/dri/renderD128 on the hostIf hardware encoding fails mid-job, MediaForge automatically falls back to the next available encoder.
Configuration lives at /config/mediaforge.yaml (most settings are also editable from the web UI). API keys required:
Content type
Image
Digest
sha256:1aca46605…
Size
260 MB
Last updated
24 days ago
docker pull braydin72/mediaforge