docs(unraid): improve unraid migration guide #2470
docs(unraid): improve unraid migration guide #2470fallenbagel merged 3 commits intoseerr-team:developfrom
Conversation
### 1. Create the config directory :::note Seerr is now rootless. Unraid typically runs Docker containers as `nobody:users` (UID 99, GID 100), but Seerr now runs internally as UID 1000, GID 1000. This creates a permission mismatch. ::: :::info **If migrating**: Copy your existing Seerr files to the new folder, then apply the permissions below. ::: Open the Unraid terminal and run: ```bash mkdir -p /mnt/user/appdata/seerr chown -R 1000:1000 /mnt/user/appdata/seerr ```
📝 WalkthroughWalkthroughThis PR updates the Unraid guide to note Seerr now runs rootless as UID:GID 1000:1000, documents the UID/GID mismatch with Unraid’s nobody:users (99:100), adds migration instructions to copy existing Jellyseerr/Overseerr appdata to Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Possibly related issues
Possibly related PRs
Suggested reviewers
Poem
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. Comment |
There was a problem hiding this comment.
🤖 Fix all issues with AI agents
Verify each finding against the current code and only fix it if needed.
In `@docs/getting-started/third-parties/unraid.mdx`:
- Around line 28-30: Update the sentence that currently reads "Copy your
existing Seerr files to the new folder, then apply the permissions below." to
include example source locations so users know where to copy from; specifically,
mention common migration sources like Overseerr (its appdata directory) and the
previous Seerr config directory as typical locations and show one or two
concrete example source paths for each migration scenario so users can easily
locate their existing files.
🧹 Nitpick comments (1)
🤖 Fix all nitpicks with AI agents
Verify each finding against the current code and only fix it if needed. In `@docs/getting-started/third-parties/unraid.mdx`: - Around line 28-30: Update the sentence that currently reads "Copy your existing Seerr files to the new folder, then apply the permissions below." to include example source locations so users know where to copy from; specifically, mention common migration sources like Overseerr (its appdata directory) and the previous Seerr config directory as typical locations and show one or two concrete example source paths for each migration scenario so users can easily locate their existing files.docs/getting-started/third-parties/unraid.mdx (1)
28-30: Consider specifying the typical source location for migrations.The instruction to "copy your existing Seerr files" assumes users know where their current config is stored. For clarity, consider mentioning a typical source path (e.g.,
/mnt/user/appdata/overseerrif migrating from Overseerr, or the previous Seerr location).📝 Suggested improvement
:::info -**If migrating**: Copy your existing Seerr files to the new folder, then apply the permissions below. +**If migrating**: Copy your existing Seerr/Overseerr config files (e.g., from `/mnt/user/appdata/overseerr`) to `/mnt/user/appdata/seerr`, then apply the permissions below. :::🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed. In `@docs/getting-started/third-parties/unraid.mdx` around lines 28 - 30, Update the sentence that currently reads "Copy your existing Seerr files to the new folder, then apply the permissions below." to include example source locations so users know where to copy from; specifically, mention common migration sources like Overseerr (its appdata directory) and the previous Seerr config directory as typical locations and show one or two concrete example source paths for each migration scenario so users can easily locate their existing files.
changed: -**If migrating**: Copy your existing Seerr files to the new folder, then apply the permissions below. to: +**If migrating**: Copy your existing Seerr/Overseerr config files (e.g., from `/mnt/user/appdata/overseerr`) to `/mnt/user/appdata/seerr`, then apply the permissions below.
change to Jellyseerr/Overseerr
1. Create the config directory
:::note
Seerr is now rootless. Unraid typically runs Docker containers as
nobody:users(UID 99, GID 100), but Seerr now runs internally as UID 1000, GID 1000. This creates a permission mismatch. ::::::info
If migrating: Copy your existing Seerr files to the new folder, then apply the permissions below. :::
Open the Unraid terminal and run:
Description
How Has This Been Tested?
Screenshots / Logs (if applicable)
Checklist:
pnpm buildpnpm i18n:extractSummary by CodeRabbit