docs: promote Nixpkgs as an official installation method

[M0NsTeRRR]

Description

promote Nixpkgs as an official installation method

How Has This Been Tested?

Screenshots / Logs (if applicable)

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

• Documentation
  • Added new installation guide for Nix Package Manager (Advanced).
  • Reorganized getting-started documentation sidebar order.
  • Updated migration guide with current Nix package availability and planned release information.

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR reorganizes Nix installation documentation by moving the guide from a third-party folder to the main getting-started section, reorders sidebar navigation positions for related installation pages, updates component URLs to reference new nixpkgs paths, and refreshes migration guide content.

Changes

Cohort / File(s)	Summary
Nix Documentation Reorganization docs/getting-started/nixpkg.mdx, docs/getting-started/third-parties/nixpkg.mdx	Added new Nix documentation page in getting-started folder with installation steps; removed previous third-party nixpkg documentation page.
Sidebar Position Updates docs/getting-started/third-parties/aur.mdx, docs/getting-started/third-parties/unraid.mdx, docs/getting-started/third-parties/truenas.mdx, docs/getting-started/third-parties/synology.mdx	Adjusted sidebar_position values to reorder navigation: aur (2→1), unraid (3→2), truenas (4→3), synology (5→4).
Migration Guide Update docs/migration-guide.mdx	Added new Nix subsection with updated status information regarding unstable channel availability and planned 26.05 release inclusion; replaced outdated nixpkgs pull request references.
Component URL Updates gen-docs/src/components/SeerrVersion/index.tsx	Updated NixpkgVersion component to fetch metadata from new nixpkgs paths: se/seerr/package.nix at nixos-unstable and nixos-26.05 channels instead of previous jellyseerr paths.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• seerr-team/seerr#2491: Modifies the same TrueNAS documentation file with content updates while this PR adjusts its sidebar position.

Suggested reviewers

• gauthier-th
• fallenbagel

Poem

🐰 The Nix docs hop and reorganize with glee,
Sidebar positions reordered, one, two, three!
From third-parties moved to main, they now reside,
Component URLs updated with Seerr pride,
Migration guide refreshed, the path forward's clear! ✨

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title accurately describes the main change: promoting Nixpkgs from a third-party installation method to an official one by moving documentation and updating references throughout.

_{✏️ 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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

gen-docs/src/components/SeerrVersion/index.tsx (1)

74-76: ⚠️ Potential issue | 🟡 Minor

Incorrect error return type will cause rendering issues.

The error case returns { error } (an object) rather than a renderable value. This will display as [object Object] in the UI instead of the actual error message.

🐛 Proposed fix

  if (error) {
-   return { error };
+   return `Error: ${error}`;
  }

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@gen-docs/src/components/SeerrVersion/index.tsx` around lines 74 - 76, The
error branch in the SeerrVersion component returns an object ({ error }) which
will render as "[object Object]"; change the error handling in SeerrVersion to
return a renderable value such as a string or JSX that shows the error message
(e.g., use error.message or wrap it in a <div> or <span>), ensuring you
reference the existing error variable and the SeerrVersion component's return
path.

🧹 Nitpick comments (1)

docs/getting-started/nixpkg.mdx (1)

7-10: Unused imports due to commented-out code.

SeerrVersion, NixpkgVersion, Admonition, Tabs, and TabItem are imported but not used because the VersionMismatchWarning component is fully commented out (lines 23-75). This may cause build warnings or linter errors depending on the project configuration.

Consider either:

1. Removing the unused imports and commented-out code if it's not planned for near-term use
2. Uncommenting and enabling the VersionMismatchWarning feature if it's ready

♻️ Proposed fix to remove unused imports

-import { SeerrVersion, NixpkgVersion } from '@site/src/components/SeerrVersion';
-import Admonition from '@theme/Admonition';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';

And remove lines 23-75 (the commented-out component).

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@docs/getting-started/nixpkg.mdx` around lines 7 - 10, The file imports
SeerrVersion, NixpkgVersion, Admonition, Tabs, and TabItem but the
VersionMismatchWarning component block is fully commented out, leaving unused
imports; either remove those unused imports (SeerrVersion, NixpkgVersion,
Admonition, Tabs, TabItem) and delete the commented VersionMismatchWarning
block, or restore/uncomment and enable the VersionMismatchWarning component so
those imports are used (look for the commented VersionMismatchWarning block and
the import statements to adjust accordingly).

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@gen-docs/src/components/SeerrVersion/index.tsx`:
- Around line 37-39: The stableUrl constant in the SeerrVersion component points
to a non-existent branch ('nixos-26.05'), causing fetches to 404 and fall back
to "0.0.0"; update the stableUrl value to point to an existing nixpkgs branch
(for example 'nixos-25.11') or add explicit handling in the SeerrVersion fetch
logic to detect a 404 and render a "Not yet released" message instead of
defaulting to "0.0.0" (refer to the stableUrl constant and the SeerrVersion
component's fetch/response handling to implement the change).

---

Outside diff comments:
In `@gen-docs/src/components/SeerrVersion/index.tsx`:
- Around line 74-76: The error branch in the SeerrVersion component returns an
object ({ error }) which will render as "[object Object]"; change the error
handling in SeerrVersion to return a renderable value such as a string or JSX
that shows the error message (e.g., use error.message or wrap it in a <div> or
<span>), ensuring you reference the existing error variable and the SeerrVersion
component's return path.

---

Nitpick comments:
In `@docs/getting-started/nixpkg.mdx`:
- Around line 7-10: The file imports SeerrVersion, NixpkgVersion, Admonition,
Tabs, and TabItem but the VersionMismatchWarning component block is fully
commented out, leaving unused imports; either remove those unused imports
(SeerrVersion, NixpkgVersion, Admonition, Tabs, TabItem) and delete the
commented VersionMismatchWarning block, or restore/uncomment and enable the
VersionMismatchWarning component so those imports are used (look for the
commented VersionMismatchWarning block and the import statements to adjust
accordingly).

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9c8aa48f-7452-47ae-a915-c2839fdcbf9a

📥 Commits

Reviewing files that changed from the base of the PR and between 20c2ed8 and e018b92.

📒 Files selected for processing (8)

• docs/getting-started/nixpkg.mdx
• docs/getting-started/third-parties/aur.mdx
• docs/getting-started/third-parties/nixpkg.mdx
• docs/getting-started/third-parties/synology.mdx
• docs/getting-started/third-parties/truenas.mdx
• docs/getting-started/third-parties/unraid.mdx
• docs/migration-guide.mdx
• gen-docs/src/components/SeerrVersion/index.tsx

💤 Files with no reviewable changes (1)

• docs/getting-started/third-parties/nixpkg.mdx