Migrate from Jellyseerr or Overseerr to Seerr (2026)
Seerr is the evolution of Jellyseerr and Overseerr, providing a fully-featured, secure, and modern media request platform. Migration is automatic on first startup, but following best practices ensures data integrity.
This guide covers:
- Automatic migration steps
- Backup recommendations
- Docker, Unraid, Windows, and Kubernetes setups
- Folder permissions
- Monitoring your Seerr instance with JellyWatch
1. Backup Your Existing Instance
Important: Always backup your current instance before migrating. This allows rollback if anything goes wrong.
Backup checklist:
- Stop your Jellyseerr/Overseerr container
- Copy your appdata folder to a safe location
- Verify backup integrity
2. Migration Overview
Seerr handles migration automatically:
- First startup triggers the migration
- Overseerr users have an additional configuration migration step
- Jellyseerr users migrate directly
No manual database intervention is required.
3. Docker Migration
Seerr provides a secure Docker image with all dependencies included.
Docker Compose Example (Linux/Unix)
services:
seerr:
image: ghcr.io/seerr-team/seerr:latest
init: true
container_name: seerr
environment:
- LOG_LEVEL=debug
- TZ=Asia/Tashkent
- PORT=5055
ports:
- 5055:5055
volumes:
- /path/to/appdata/config:/app/config
healthcheck:
test: wget --no-verbose --tries=1 --spider http://localhost:5055/api/v1/status || exit 1
start_period: 20s
timeout: 3s
interval: 15s
retries: 3
restart: unless-stopped
Notes
- The container runs as
node(UID 1000). - Ensure
/app/configis owned by UID1000:1000. - No init process by default; add
init: trueas shown.
4. Windows Docker Migration
services:
seerr:
image: ghcr.io/seerr-team/seerr:latest
init: true
container_name: seerr
environment:
- LOG_LEVEL=debug
- TZ=Asia/Tashkent
ports:
- 5055:5055
volumes:
- seerr-data:/app/config
healthcheck:
test: wget --no-verbose --tries=1 --spider http://localhost:5055/api/v1/status || exit 1
start_period: 20s
timeout: 3s
interval: 15s
retries: 3
restart: unless-stopped
volumes:
seerr-data:
external: true
5. Unraid Migration Steps
Instructions
- Stop your existing Jellyseerr or Overseerr container (do not delete appdata yet).
- Copy existing appdata to Seerr:
cp -a /mnt/user/appdata/overseerr /mnt/user/appdata/seerr
For Jellyseerr users:
# cp -a /mnt/user/appdata/jellyseerr /mnt/user/appdata/seerr
- Start the Seerr container and verify migration logs.
- Once confirmed, remove the old Jellyseerr/Overseerr container.
6. Kubernetes & Source Build
- All references to Jellyseerr/Overseerr are renamed to Seerr in manifests.
- Default
securityContextsupports non-root execution. - Build from source by restoring backups and starting Seerr.
- No additional manual migration steps are required.
7. Post-Migration Best Practices
- Verify all requests and user histories migrated correctly.
- Monitor Seerr logs during the first 24 hours.
- Use JellyWatch to monitor:
- Active users
- CPU/memory usage
- API errors or failed requests
- Plugin health and performance
- Keep Docker/Unraid images updated to the latest stable release.
FAQ
Do I need to manually migrate Overseerr or Jellyseerr? No. Seerr performs automatic migration on first startup.
Can I rollback if migration fails? Yes, if you have a backup of your previous appdata folder.
How do I fix folder permissions? Ensure /app/config is owned by UID 1000:1000:
docker run --rm -v /path/to/appdata/config:/data alpine chown -R 1000:1000 /data
Will Seerr overwrite my data? No. Migration preserves all existing requests, users, and settings.
9. Manage Your Seerr Instance with JellyWatch
🚀 Take full control of your Seerr instance with JellyWatch:
- Monitor requests, users, and server health in real time.
- Track API errors, plugin performance, and container logs.
- Get proactive alerts for downtime or misconfigurations.
Start using JellyWatch to manage Seerr.
10. Conclusion
Migrating from Jellyseerr or Overseerr to Seerr is simple, safe, and automatic.
Key steps:
- Backup your data.
- Check folder permissions.
- Monitor the process using tools like JellyWatch.
With proper setup, Seerr becomes a modern, secure, and fully-featured media request platform - ready for advanced users, teams, or large private libraries.
Manage your Seerr requests from your phone, without a browser. Download JellyWatch on Google Play - approve, reject, and track media requests natively on Android.




Comments 3
Migration was completely seamless. Backed up, swapped the Docker image, started Seerr, and all my requests were there. Took 10 minutes.
The folder permissions tip (UID 1000:1000) saved me. I was stuck for an hour before reading that section. Thank you!
Unraid migration steps worked perfectly. Copy appdata, change container, done. Easiest migration I've ever done.
Leave a comment