Agregarr (bitr8 fork)¶
Already running Agregarr? Swap one line and you're on the fork.
Run docker compose up -d and you're sorted. The fork uses your existing config folder, so your collections, overlays, and settings stay put. You don't need to export, import, or set anything up again.
Still running agregarr/agregarr? Switch to this image.
Upstream's :latest (v2.4.2, March 2026) includes youtube-search-without-api-key, a package npm pulled and flagged as malicious (MAL-2026-18270), and runs on Node 20. Releases from this fork remove that package and include security updates for Node, Express, axios, sharp, and Next.js. See v2.12.1 and v2.12.3.
What is this fork?¶
Upstream Agregarr has been quiet since April 2026. I've carried it on from there, adding fixes, new features, and a release every few weeks. The official Agregarr documentation still covers installation, basic setup, source types, and the UI. These docs cover the bits added by the fork.
Which image tag¶
| Tag | What it tracks |
|---|---|
:latest |
Stable releases. The one to run. |
:2.13.1 (etc.) |
Pinned to one release. |
:develop |
Builds on every push. For testing, not day-to-day use. |
Starting from scratch? The README has the full Compose example.
Feature overview¶
Collections¶
- Collection Presets: 12 preset configs, including Trending Movies Today, IMDb Top 250, and Netflix Top 10 Movies
- Library Essentials: automatically builds smart collections by genre, decade, resolution, or content rating
- Separator Collections: visual dividers that organise long collection rows
- Label Collections: collections built from Plex labels
- Per-User Targeting: limits a collection to one Plex user
- Sort Title: controls where a collection sorts
- Filtered Hubs: recently added and released hubs that leave out placeholders, including individual episodes
- More Sources and Options: TVDB lists, IMDb Bottom 100, random lists, label exclusion, and more
- Export/Import: moves collection configs between instances
Overlays¶
- Overlays: overlay templates, canvas size, and the sync dashboard
- Conditional Elements: shows or hides individual elements based on media properties
- Color Scale: interpolates tile colours from numeric values, such as an IMDb rating gradient
- Maintainerr Countdown: deletion countdown shown on posters
- Episode Media Scanning: resolution and HDR badges read from episode files
- Template Variables: variables available in overlay templates
System¶
- Health Checks: 18 diagnostic checks, with an option to mute the ones you don't need
- Integrations: Cloudflare solver support for FlareSolverr, Byparr, or Trawl, used with FlixPatrol and other protected sources, plus the other services Agregarr connects to
- Settings: general, Plex, sources, downloads, and jobs settings
Under the hood¶
- Placeholders: how Agregarr creates and cleans up placeholder items
- Performance: how syncs avoid doing the same work again
- Cycle Lists: one row that moves to the next list each time it syncs
Help improve these docs¶
Found a mistake or a step that's missing? Every page has an edit button at the top right. See Contributing.