Skip to content

docs: document TrueNAS cross-dataset artwork issue#96

Merged
gantoine merged 2 commits into
mainfrom
posthog-code/truenas-cross-dataset-artwork
Jul 18, 2026
Merged

docs: document TrueNAS cross-dataset artwork issue#96
gantoine merged 2 commits into
mainfrom
posthog-code/truenas-cross-dataset-artwork

Conversation

@gantoine

Copy link
Copy Markdown
Member

Summary

Adds a TrueNAS troubleshooting entry for a case surfaced in the Discord #truenas channel: covers/artwork download successfully (visible on disk) but never render in the UI.

The root cause is that RomM can't link ROMs to their artwork when the Library and resources volumes live on different ZFS datasets, even with correct permissions on both. This commonly happens when ROMs are on a game/media dataset while resources point at a Docker-specific dataset.

The fix: keep library and resources on the same dataset. Includes working/non-working docker-compose volume examples, and notes the DB and config file can safely stay on a separate Docker dataset.


Created with PostHog Code

gantoine added 2 commits July 18, 2026 08:05
RomM can't link ROMs to their artwork when the library and resources
volumes live on different ZFS datasets, even with correct permissions
and art downloading fine. Add a troubleshooting entry with the fix.

Generated-By: PostHog Code
Task-Id: f91b5297-525b-418d-9e5d-ec18e94360ec
@gantoine
gantoine merged commit c4a5311 into main Jul 18, 2026
4 checks passed
@gantoine
gantoine deleted the posthog-code/truenas-cross-dataset-artwork branch July 18, 2026 18:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant