Repository navigation
Data Locations
Everything Moonbase writes goes into a single Moonfin folder inside your server's plugin configuration directory. User settings, bookmarks, notification preferences, Seerr sessions, uploaded themes, and the caches all live there.
Knowing where it is makes backups, resets, and support requests much easier.
Both plugins resolve the same way, as the server's plugin configuration path plus Moonfin.
| Server | Install type | Path |
|---|---|---|
| Jellyfin | Docker | /config/plugins/configurations/Moonfin/ |
| Jellyfin | Linux package | /var/lib/jellyfin/plugins/configurations/Moonfin/ |
| Jellyfin | Windows | %ProgramData%\Jellyfin\Server\plugins\configurations\Moonfin\ |
| Emby | Docker | /config/plugins/configurations/Moonfin/ |
| Emby | Linux package | /var/lib/emby/plugins/configurations/Moonfin/ |
| Emby | Windows | %AppData%\Emby-Server\programdata\plugins\configurations\Moonfin\ |
If your server uses a custom data directory, the folder follows it. Look for plugins/configurations/Moonfin under whatever path your server reports as its data directory on the dashboard.
One file per user, named with that user's id.
| Path | What it holds |
|---|---|
{userId}.json |
The user's settings envelope, which is what Settings Sync reads and writes |
notifications/{userId}.json |
Notification preferences and the user's notification history |
seerr-sessions/{userId}.json |
The user's Seerr session, so they stay signed in across clients |
Bookmarks/{userId}.json |
Audiobook bookmarks and notes |
calendar-reminders/{userId}.json |
The user's calendar reminders, up to 500. See Calendar |
collections/{userId}/{collection}.json |
Manual ordering for a collection |
saves/{userId}/{game}.{kind} |
Retro game saves and save states |
pins/{userId}.json |
The user's sign-in PIN as a salted hash, plus their wrong-guess count. A .bak beside it holds the previous hash |
romm-accounts/{userId}.json |
The RomM key for a user who linked their own RomM account. It never leaves the server |
Note: the user id is written two ways. Settings, notifications, Seerr sessions, bookmarks and calendar reminders use the dashed form (
0f8b...-...-....json). Collections, saves, PINs and RomM links use the compact form with no dashes. Both refer to the same user.
| Path | What it holds |
|---|---|
themes/ |
Uploaded custom themes and their index, shared by every user. See Themes |
emulatorjs/data/ |
The installed EmulatorJS runtime, when an admin chose to self-host the cores. See Retro Games |
gamemeta/{platform}.rdb |
Game metadata databases |
minigames/scores.json |
The top 3 for each After Hours game, one row per user, shared by every app on the server |
seerr-stuck-downloads.json |
The Radarr and Sonarr downloads the stuck download check is keeping an eye on, and which ones it already told people about. See Seerr Notifications |
livetv-incomplete-recordings.json |
Which recordings came out incomplete, which were kept as complete, and the later showings Moonbase is trying to record |
config-backup/Moonfin.Server.xml |
A spare copy of the admin configuration, used by the restore banner. On Emby it's config-backup/Emby.Plugins.Moonfin.xml. See below |
quarantine/ |
Files the repair task could not recover, kept under settings/, notifications/, and seerr-sessions/
|
These are rebuilt on demand and are safe to delete if you want to force a refresh.
| Path | What it holds |
|---|---|
mdblist_cache.json |
Cached MDBList ratings |
mdblist_lists_cache.json |
Cached MDBList official lists |
imdb_lists_cache.json |
Cached IMDb chart lists |
custom_rows_cache.json |
Cached custom row results. Rows fetched with a user's own TMDB or MDBList key are cached for that user only |
tmdb_ratings_cache.json |
Age ratings looked up on TMDB for custom row and seasonal row titles, kept for 30 days |
seasonal_keywords_cache.json |
Each movie's TMDB keywords for the seasonal row, refreshed every 180 days |
seasonal_suggestions_cache.json |
The seasonal row's TMDB suggestions per holiday and year, kept for 30 days and shared by every user |
anime_title_aliases.json |
English and romaji anime titles looked up on AniList, for libraries whose titles don't match AnimeFillerList. Kept for 30 days |
anime_markers_cache.json |
Cached filler, canon and recap classifications for anime |
anime_filler_catalog.json |
AnimeFillerList's list of shows, used for matching |
anime_id_mapping.json |
A table that links anime ids to MyAnimeList, used for recap lookups |
studio_logos/ |
Downloaded studio logo images |
game_thumbs/ |
Downloaded game box art |
smart-search/ |
The Smart Search model, the library and TMDB catalog indexes, and cached TMDB keywords and cast. About 135 MB with the English model, or about 535 MB with Multilingual. Deleting it means the next run downloads and indexes everything again, which takes a while on small servers |
The settings you set on the plugin config page are not in the Moonfin folder. The server persists them itself as an XML file one level up, in plugins/configurations/:
- Jellyfin:
Moonfin.Server.xml - Emby:
Emby.Plugins.Moonfin.xml
That file holds the server-wide values such as API keys, the Seerr URL, and the admin default settings. It is the file to keep if you want to preserve your server configuration without carrying over per-user data.
Moonbase also keeps a copy of it at Moonfin/config-backup/Moonfin.Server.xml, or Emby.Plugins.Moonfin.xml on Emby. The copy is refreshed at every startup, but only while your settings aren't all defaults, so a reset never overwrites the last good copy. If the live file ever comes back as defaults, the plugin page offers to restore it. See Common Problems.
-
Back up everything: copy the whole
Moonfinfolder plus the XML file next to it. -
Reset one user: stop the server, delete that user's
{userId}.json, and start it again. They fall back to the admin defaults and can re-sync from a client that still has their settings. -
Reset all user settings but keep admin config: delete the
{userId}.jsonfiles in the folder root and leave the XML alone. - Clear caches only: delete the cache files and folders listed above. Nothing user facing is lost.
Always stop the server before deleting files by hand, so nothing is mid-write when you do it.
Note: the anime marker debug log isn't in this folder. When it's turned on, it's written to the server's own log folder as
moonfin-anime-markers.log, so it shows up under Dashboard > Logs.
Note: files are written atomically, and a repair pass runs at startup to catch anything left truncated by an earlier crash. Anything it cannot recover is moved into
quarantine/rather than deleted. See Settings Sync for how that works.
For server admins
- Installation
- Admin Guide
- Seerr Setup
- Calendar
- Home Rows
- Smart Search
- Watch Parties
- Common Problems
- Retro Games
- Themes
Reference
For developers