Skip to content

docs: update truenas migration section to include chown#3143

Open
thraizz wants to merge 2 commits into
seerr-team:developfrom
thraizz:patch-1
Open

docs: update truenas migration section to include chown#3143
thraizz wants to merge 2 commits into
seerr-team:developfrom
thraizz:patch-1

Conversation

@thraizz

@thraizz thraizz commented Jun 9, 2026

Copy link
Copy Markdown

Description

Added step to explain necessary ownership change of the Seerr folder after starting Seerr for the first time when migrating TrueNAS.
Without this, the first start of Seerr will just result in a lot of "EACCES: permission denied"

How Has This Been Tested?

Did not test changes. Its a simple doc change, i did not set up a dev environment for this.
I clicked the Edit On Github button in the docs, edited it, opened this PR.

Checklist:

  • I have read and followed the contribution guidelines.
  • Disclosed any use of AI (see our policy)
  • I have updated the documentation accordingly.
  • All new and existing tests passed.
  • Successful build pnpm build
  • Translation keys pnpm i18n:extract
  • Database migration (if required)

Summary by CodeRabbit

Summary by CodeRabbit

  • Documentation
    • Updated the TrueNAS SCALE “ixVolume” migration guide to ensure migrated files are assigned the correct directory ownership during the rsync copy step.

Added step to explain necessary ownership change of the Seerr folder after starting Seerr for the first time when migrating TrueNAS.
@thraizz thraizz requested a review from a team as a code owner June 9, 2026 22:08
@coderabbitai

coderabbitai Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

The TrueNAS SCALE ixVolume migration guide now copies data into /mnt/storage/seerr/ with rsync --chown=568:568, applying ownership during the transfer.

Changes

TrueNAS SCALE ixVolume Migration

Layer / File(s) Summary
Ownership applied during ixVolume copy
docs/migration-guide.mdx
The rsync command for copying ixVolume data into /mnt/storage/seerr/ now includes --chown=568:568.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • seerr-team/seerr#3107: Also changes docs/migration-guide.mdx in the TrueNAS ixVolume migration section.

Suggested reviewers

  • M0NsTeRRR
  • gauthier-th
  • fallenbagel

Poem

🐰 I hopped through the guide with a tug and a turn,
A --chown spell made the copy duly earn.
Soft paws, neat files, and ownership true,
One tiny edit, and the path is all blue.

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly matches the docs change about adding chown to the TrueNAS migration section.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@thraizz thraizz changed the title docs: update truenas section to include chown docs: update truenas migration section to include chown Jun 9, 2026
Comment thread docs/migration-guide.mdx Outdated
4. Install Seerr and use the same Host Path storage that was created before (`/mnt/storage/seerr/config` in our example)
5. Start Seerr app
6. Delete Jellyseerr/Overseerr app
4. Change ownership of the folder from `root` to the `apps` user and group:

@M0NsTeRRR M0NsTeRRR Jun 10, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does /mnt/.ix-apps/app_mounts/jellyseerr/ belong to the apps user, and does the rsync command update file permissions to root?
If so, you can use the -p flag with rsync to preserve permissions it’s the easiest way to handle this.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, the .ix-apps/ folder and all subfolders belong to root already so preserving is not enough here, sadly.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But i looked into the rsync man page and we can use --chown=568:568, so i will update to use this instead!

@thraizz

thraizz commented Jun 24, 2026

Copy link
Copy Markdown
Author

@M0NsTeRRR updated to use --chown=568:568 so we can skip the extra chown! :)

@seerr-automation-bot seerr-automation-bot added this to the v3.4.0 milestone Jun 24, 2026
@M0NsTeRRR

Copy link
Copy Markdown
Member

@thraizz can you fix the template issue #3143 (comment)

@thraizz

thraizz commented Jun 24, 2026

Copy link
Copy Markdown
Author

@thraizz can you fix the template issue #3143 (comment)

Done, hope this is fine like this

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.

4 participants