Skip to content

Migration from old versions

StudioNirin edited this page Jan 5, 2026 · 2 revisions

When you have overwritten the old script files with the new files from V2.0, you simply need to re-run the setup.py file. This will check for an existing settings.json and ask you to make your choices for any of the missing settings. Those will then be added to your existing settings file, and a new file will be created to flag your install as being fully migrated to v2.

The list of files you should end up with after the automatic migration are as follows:

Here's the file breakdown for v2:

Core Application Files (required)

File Purpose
plexcache_app.py Main application
plexcache_setup.py Interactive setup wizard
config.py Configuration management
file_operations.py File moving logic
plex_api.py Plex API interactions
logging_config.py Logging setup
system_utils.py System utilities
requirements.txt Python dependencies

Generated at Runtime (created/managed by app)

File Purpose
plexcache_settings.json User configuration (created by setup)
plexcache_timestamps.json Cache timestamp tracking
plexcache_watchlist_tracker.json Watchlist retention tracking
plexcache_user_tokens.json Cached user tokens
plexcache_mover_files_to_exclude.txt Unraid mover exclude list
plexcache_rss_cache.json RSS feed cache (fallback)
unraid_mover_exclusions.txt Unraid mover exclusions
plexcache_migration_v2.complete Migration flag (indicates v2 migration done)
logs/ Log directory

Anything outside of these files can be deleted.

Clone this wiki locally