feat(settings): add endpoint and UI for switching media server

seerr-api.yml

@@ -718,6 +718,10 @@ components:
           format: uuid
           description: Instance Plex OAuth client identifier
           example: 6919275e-142a-48d8-be6b-93594cbd4626
+        jellyfinConfigured:
+          type: boolean
+          description: Whether a Jellyfin/Emby connection is configured.
+          example: true
     MovieResult:
       type: object
       required:
@@ -2298,6 +2302,47 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/JellyfinSettings'
+  /settings/switch-media-server:
+    post:
+      summary: Switch media server
+      tags:
+        - settings
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                targetServerType:
+                  type: string
+                  enum: [jellyfin, emby, plex]
+                  description: Target media server type. Required when switching from Plex (jellyfin or emby) or from Jellyfin/Emby (plex, jellyfin, or emby).
+              required:
+                - targetServerType
+      responses:
+        '200':
+          description: Media server cleared
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: 'Media server cleared. Restart or reload to configure a new server.'
+        '400':
+          description: No media server is configured
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: 'No media server is configured.'
+        '500':
+          description: Failed to switch media server
   /settings/jellyfin/library:
     get:
       summary: Get Jellyfin libraries
@@ -5155,6 +5200,44 @@ paths:
           description: Unlink request invalid
         '404':
           description: User does not exist
+  /user/{userId}/settings/linked-accounts/jellyfin/map:
+    post:
+      summary: Map a Jellyfin/Emby account to a user
+      description: Uses the configured Jellyfin/Emby connection to verify the selected server user, then maps that identity to the Seerr user without authenticating as the Jellyfin/Emby user or storing a user auth token. Requires administrator permissions.
+      tags:
+        - users
+      parameters:
+        - in: path
+          name: userId
+          required: true
+          schema:
+            type: number
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                jellyfinUserId:
+                  type: string
+                  description: Jellyfin/Emby user ID selected from the configured server user list.
+                  example: '0123456789abcdef0123456789abcdef'
+              required:
+                - jellyfinUserId
+      responses:
+        '204':
+          description: Mapping account succeeded
+        '400':
+          description: Mapping request invalid or Jellyfin/Emby connection is not configured
+        '403':
+          description: User does not have permission to map this account
+        '404':
+          description: Seerr user or Jellyfin/Emby user does not exist
+        '422':
+          description: Account already linked to a user
+        '500':
+          description: Unable to map account
   /user/{userId}/settings/notifications:
     get:
       summary: Get notification settings for a user

server/interfaces/api/settingsInterfaces.ts

@@ -25,6 +25,7 @@ export interface PublicSettingsResponse {
   jellyfinHost?: string;
   jellyfinExternalHost?: string;
   jellyfinServerName?: string;
+  jellyfinConfigured: boolean;
   jellyfinForgotPasswordUrl?: string;
   initialized: boolean;
   applicationTitle: string;

server/lib/settings/index.ts

@@ -204,6 +204,7 @@ interface FullPublicSettings extends PublicSettings {
   jellyfinExternalHost?: string;
   jellyfinForgotPasswordUrl?: string;
   jellyfinServerName?: string;
+  jellyfinConfigured: boolean;
   partialRequestsEnabled: boolean;
   enableSpecialEpisodes: boolean;
   cacheImages: boolean;
@@ -712,6 +713,7 @@ class Settings {
       mediaServerLogin: this.data.main.mediaServerLogin,
       jellyfinExternalHost: this.data.jellyfin.externalHostname,
       jellyfinForgotPasswordUrl: this.data.jellyfin.jellyfinForgotPasswordUrl,
+      jellyfinConfigured: !!this.data.jellyfin.ip,
       movie4kEnabled: this.data.radarr.some(
         (radarr) => radarr.is4k && radarr.isDefault
       ),

server/middleware/deprecation.ts

@@ -20,7 +20,7 @@ export const deprecatedRoute = ({
 }: DeprecationOptions) => {
   return (req: Request, res: Response, next: NextFunction) => {
     logger.warn(
-      `Deprecated API endpoint accessed: ${oldPath} → use ${newPath} instead`,
+      `Deprecated API endpoint accessed: ${oldPath} => use ${newPath} instead`,
       {
         label: 'API Deprecation',
         ip: req.ip,

server/routes/auth.ts

@@ -58,6 +58,47 @@ authRoutes.post('/plex', async (req, res, next) => {
     });
   }
 
+  const mediaServerType = settings.main.mediaServerType;
+
+  if (
+    mediaServerType === MediaServerType.JELLYFIN ||
+    mediaServerType === MediaServerType.EMBY
+  ) {
+    if (!req.user) {
+      return next({
+        status: 401,
+        message: 'Authentication required.',
+      });
+    }
+    if (!req.user.hasPermission(Permission.ADMIN)) {
+      return next({
+        status: 403,
+        message: 'Admin permissions required.',
+      });
+    }
+    try {
+      const plextv = new PlexTvAPI(body.authToken);
+      const account = await plextv.getUser();
+      const admin = await userRepository.findOneOrFail({
+        where: { id: 1 },
+      });
+      admin.plexToken = body.authToken;
+      admin.plexId = account.id;
+      admin.plexUsername = account.username;
+      await userRepository.save(admin);
+      return res.status(200).json({ email: admin.email });
+    } catch (e) {
+      logger.error('Failed to store Plex token for settings', {
+        label: 'API',
+        errorMessage: (e as Error).message,
+      });
+      return next({
+        status: 500,
+        message: 'Unable to validate Plex token.',
+      });
+    }
+  }
+
   if (
     settings.main.mediaServerType != MediaServerType.NOT_CONFIGURED &&
     (settings.main.mediaServerLogin === false ||
@@ -410,9 +451,7 @@ authRoutes.post('/jellyfin', async (req, res, next) => {
       settings.jellyfin.apiKey = apiKey;
       await settings.save();
       startJobs();
-    }
-    // User already exists, let's update their information
-    else if (account.User.Id === user?.jellyfinUserId) {
+    } else if (account.User.Id === user?.jellyfinUserId) {
       logger.info(
         `Found matching ${
           settings.main.mediaServerType === MediaServerType.JELLYFIN
@@ -431,6 +470,10 @@ authRoutes.post('/jellyfin', async (req, res, next) => {
       );
       user.avatar = getUserAvatarUrl(user);
       user.jellyfinUsername = account.User.Name;
+      user.userType =
+        settings.main.mediaServerType === MediaServerType.JELLYFIN
+          ? UserType.JELLYFIN
+          : UserType.EMBY;
 
       if (user.username === account.User.Name) {
         user.username = '';