Troubleshooting installation

Plugin Not Appearing After Installation

Check Installation Status:

1. Go to Dashboard → Plugins
2. Verify Jellyfin Enhanced is listed under Installed
3. Check that it's enabled (not disabled)

Run Startup Task:

1. Go to Dashboard → Scheduled Tasks
2. Under Jellyfin Enhanced, find the task: Jellyfin Enhanced Startup
3. Execute the task manually (click the button: ▶︎)
4. Refresh your browser Ctrl+F5

Clear Browser Cache:

1. Open menu:

   Windows/Linux: Ctrl+Shift+Del

   MacOS: Cmd+Shift+Del

2. Select "Cached images and files" (or similar)

3. Clear cache

4. Refresh browser Ctrl+F5

Restart Server:

1. In Jellyfin, go to: Dashboard → Restart
2. Wait for server to fully restart
3. Refresh browser Ctrl+F5

Scripts Not Loading

Check Scheduled Task:

1. Jellyfin: Dashboard → Scheduled Tasks
2. Look for the tasks under Jellyfin Enhanced — mainly Jellyfin Enhanced Startup
3. Jellyfin Enhanced Startup should have the trigger: On application startup
4. If missing, add the trigger manually

Check Browser Console:

1. Press F12 to open developer tools
2. Go to Console tab
3. Look for errors mentioning "Jellyfin Enhanced"
4. Report errors on GitHub if found

Update Not Working

Clean Update Process:

1. Go to Dashboard → Plugins → My Plugins
2. Find Jellyfin Enhanced
3. Click Uninstall
4. Restart server
5. Reinstall from Catalog
6. Restart server again
7. Clear browser cache Ctrl+F5

Permission Issues

If you see errors like this in a log file:

Access to the path '/jellyfin/jellyfin-web/index.html' is denied.

Common Solution:

• Install file-transformation plugin (recommended)

• Or, try platform-specific permission fixes

Platform-Specific Permission Issues

Docker

Example of a common error:

Bash

System.UnauthorizedAccessException: Access to the path '/jellyfin/jellyfin-web/index.html' is denied.

If you are not using the file-transformation plugin, you'll need to manually map the index.html file

1. Copy the index.html file from your container:

   Bash

   docker cp jellyfin:/jellyfin/jellyfin-web/index.html /path/to/your/jellyfin/config/index.html
   

2. Add volume mapping:

   Docker Run

   -v /path/to/your/jellyfin/config/index.html:/jellyfin/jellyfin-web/index.html
   

   or...
   Docker Compose

   services:
     jellyfin:
       volumes:
         # volume mapping
         - /path/to/your/jellyfin/config:/config
         - /path/to/your/jellyfin/config/index.html:/jellyfin/jellyfin-web/index.html
   

Warning

This method is not recommended and won't survive a jellyfin-web upgrade. The recommended method for Docker:

1. Install the File Transformation plugin
2. Follow the standard installation process

Windows

Known solution:

1. Navigate to your Jellyfin installation folder (usually C:\Program Files\Jellyfin\Server)
2. Right-click the folder → Properties → Security
3. Grant NETWORK SERVICE Read and Write permissions
4. Apply to all subfolders and files
5. Restart Jellyfin service

Linux

Known solution:

Bash

sudo chown -R jellyfin:jellyfin /usr/lib/jellyfin/
sudo chmod -R 755 /usr/lib/jellyfin/

Admin Config Page Tabs Not Switching

If clicking tabs in the plugin's admin configuration page (Elsewhere Settings, Jellyseerr Settings, arr Links, etc.) does nothing, this may be caused by Cloudflare* interfering with JavaScript execution when accessing Jellyfin through a Cloudflare tunnel or proxy.

Solution: Try disabling Cloudflare features that modify JavaScript behaviour for your Jellyfin domain:

1. Log in to the Cloudflare dashboard
2. Select your domain
3. Go to Speed → Optimization → Content Optimization
4. Toggle Rocket Loader off

If that doesn't help, try accessing the admin config page directly on your local network (bypassing Cloudflare) to confirm whether Cloudflare is the cause.

See GitHub issue #175 for more context.

Getting Help

If you encounter issues:

1. Check the FAQ for common solutions
2. GitHub Issues - Search existing issues - Create a new issue (please include log and details)
3. Join the Discord Community