Guide · Open source
How to use Seerr: install, connect your media server and handle requests
Updated · written with AI from the project's own documentation and checked against our catalogue data
Seerr is a free, open-source web application for managing requests for a media library. It connects to Jellyfin, Plex or Emby, so people sharing a server can ask for new movies and TV shows and an admin can track and approve them. This guide explains what you need before installing, how the main parts fit together, and where to find the detailed install instructions.
Seerrseerr-team/seerr · ★ 13.1k · MIT Install options & downloads Quick start
- 1Check your media server. Confirm Jellyfin, Plex, or Emby is running, since Seerr is designed to integrate with one of them.
- 2Install Docker. Docker is the listed prerequisite. Install it on the machine that will run Seerr.
- 3Clone the repository. Run git clone https://github.com/seerr-team/seerr.git to get the source.
- 4Follow the install guide. Use the instructions at docs.seerr.dev/getting-started to install and run Seerr.
- 5Connect your media server. Link Seerr to Jellyfin, Plex, or Emby so users can sign in and the library scan can run.
- 6Add Sonarr or Radarr. Optionally connect them so approved requests are passed along.
- 7Set permissions. Decide what each user can request and approve requests from the management interface.
What you need before you install Seerr
Seerr is built for people who already run a media server. The project describes it as integrating with Jellyfin, Plex, or Emby, so you need one of those servers running first.
The README lists Docker as the install prerequisite, and the repository topics include docker. Seerr also works with services such as Sonarr and Radarr, which it can pass approved requests to.
- A running Jellyfin, Plex, or Emby media server
- Docker installed on the machine that will host Seerr
- Optional: Sonarr (TV) and Radarr (movies) if you want approved requests passed along
Get the Seerr source code
The README gives a clone command for the repository. Run it in the folder where you want the project to live. The docs site at docs.seerr.dev has the full install instructions, so follow those for the exact container setup.
git clone https://github.com/seerr-team/seerr.gitConnect Seerr to your media server
Seerr integrates with your media server for authentication and user import and management. It can also run a library scan so it knows which titles are already available and does not ask for them again.
Once connected, Seerr can use your existing users, so people sign in with the accounts they already have on the server.
- Authentication with user import and management for Jellyfin, Emby, and Plex
- Library scan to track titles that are already available
- Support for movie, show, and mixed libraries
Connect Sonarr and Radarr for approved requests
Seerr currently supports Sonarr and Radarr. Connecting them lets approved requests move on to those services rather than being handled by hand.
Check the docs for the exact settings, as the README does not list them.
Set permissions and manage requests
Seerr has a granular permission system, so you can decide what each user is allowed to request. Requests can be approved from the request management interface, which the project describes as simple enough to approve recent requests without digging through the app.
Users can request individual seasons or whole movies. The interface is mobile-friendly, so an admin can approve requests from a phone.
- Granular permissions per user
- Request individual seasons of a show or whole movies
- Watchlisting and blocklisting of media
- Notification agents for updates
Find the API docs and get help
A local install serves API documentation at the address below. Before asking for help, the README suggests checking the Seerr documentation, then the Discord server, GitHub Discussions, or GitHub Issues for bug reports.
- Documentation: https://docs.seerr.dev
- Discord: https://discord.gg/seerr
- Bug reports and feature requests: GitHub Issues
http://localhost:5055/api-docsWhat people use it for
- Family members requesting new movies on a shared Jellyfin server
- A group of friends on a Plex library asking for specific seasons of a show
- An admin approving requests from a phone while away from home
- Keeping track of which titles are already in the library so duplicates are not requested
Frequently asked questions
Is Seerr free?
Yes. The README describes Seerr as free and open source software, and the repository is licensed under MIT.
Do I need a media server to use Seerr?
Yes. The project describes Seerr as integrating with Jellyfin, Plex, or Emby, so it is built to sit on top of an existing server.
What do I need to install Seerr?
The README lists Docker as the prerequisite and points to the docs at docs.seerr.dev for install details.
Does Seerr work with Sonarr and Radarr?
Yes. The README says Seerr currently supports Sonarr and Radarr, so approved requests can be passed to them.
What is the difference between Seerr, Overseerr and Jellyseerr?
Overseerr and Jellyseerr are comparable projects. The README includes a migration guide for moving from Overseerr or Jellyseerr to Seerr, so existing users have a documented upgrade path.
Where do I get help if something breaks?
The README suggests checking the Seerr documentation first, then asking on Discord, in GitHub Discussions' Help category, or filing a bug in GitHub Issues.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Seerr suits households and groups who already run Jellyfin, Plex, or Emby and want a simple request queue with per-user permissions. It is less suitable if you have no media server or do not want to self-host and maintain one, since requests still need admin work.
Install options & downloads