Seerr Setup

Seerr Setup

Seerr lets you and your users browse trending movies and shows and request them from inside any Moonfin app. This page walks through connecting it, start to finish. It takes about five minutes and there's nothing technical to it.

The short version: you tell Moonbase where Seerr lives, once, on the server. After that, each person just signs in from their app. Nobody ever types a URL or an API key into a TV.

Before you start

You need three things:

1. Moonbase installed on your Jellyfin or Emby server. The README covers that.
2. A running Seerr instance. If you don't have one yet, see seerr.dev. Older Jellyseerr installs work too.
3. Admin access to your server dashboard, for step 1 only.

Step 1: point Moonbase at Seerr

This is done once, by the server admin:

1. Open your server dashboard and go to Plugins > Moonbase.
2. Find the Integrations section and turn Seerr on.
3. Enter your Seerr address in Seerr URL. Use the same address you open Seerr with in your own browser.
4. Make sure Moonbase Sync is on. The Seerr integration needs it.
5. Save.

The one thing that goes wrong here: the URL has to be reachable from your server, not just from your computer. If Seerr and your media server run in separate Docker containers, localhost points at the wrong container, so use your machine's LAN address or the container name instead.

Step 2: sign in from the app

Each person does this once, on any of their devices:

1. Open a Moonfin app and go to Settings > Integrations > Seerr.
2. Turn it on.
3. Sign in. Pick Jellyfin (or Emby) to use the same account you already sign in to Moonfin with, or Local if you have a separate Seerr account.

Done. The sign-in is stored on the server and follows you to your other devices, so your TV, phone, and desktop are all connected now.

On Roku the menu is Settings > Moonfin Plugin > Seerr, and on Samsung and LG TVs it's Settings > Plugin. Their wiki pages have the details: Roku, Smart TV.

What you get

• Trending, popular, and upcoming rows, and Seerr results in global search.
• Requesting in HD or 4K right from the detail screen, with smart season selection for shows.
• A requests screen showing what you asked for and where it stands.
• Optional NSFW filtering, and optional notifications when requests are approved or arrive.

When something doesn't work

Seerr doesn't show up in the app at all. Check step 1: the plugin is installed, Seerr is on, and Moonbase Sync is on. Then check the app's own Seerr toggle from step 2.

Sign-in fails. Two usual causes. Either the Seerr URL is wrong (test it: can you open that exact address in a browser on the same machine your server runs on?), or your account doesn't exist in Seerr yet. For Jellyfin sign-in to work, Seerr has to have imported your Jellyfin user. Ask whoever runs Seerr to add you.

Browsing works but requests fail. Your Seerr user doesn't have permission to request. That's granted inside Seerr, under its user settings.

It works on your home network but not away from home. Your reverse proxy isn't forwarding the plugin's paths. See the advanced section below.

Advanced: how it works, and running behind a reverse proxy

The plugin acts as a server-side proxy. Your device talks only to your Jellyfin or Emby server, and the server talks to Seerr on its behalf. That's why nothing is configured on the client, why Seerr can stay on an internal network the TV can't see, and why signing in once with your media server account is enough (the plugin exchanges it for a Seerr session and keeps that session on the server).

If your server sits behind a reverse proxy, the proxy has to forward every /Moonfin/ path through to the server, including /Moonfin/Seerr/Api/ and /Moonfin/Seerr/Webhook, and pass auth headers along. Reverse Proxy and Seerr covers this, and API Reference lists the endpoints.