Skip to content

docs: add self-signed certificate guide#2776

Open
costajohnt wants to merge 1 commit intoseerr-team:developfrom
costajohnt:docs/self-signed-certs
Open

docs: add self-signed certificate guide#2776
costajohnt wants to merge 1 commit intoseerr-team:developfrom
costajohnt:docs/self-signed-certs

Conversation

@costajohnt
Copy link
Copy Markdown

@costajohnt costajohnt commented Mar 28, 2026

Summary

  • Add a new docs page covering how to use self-signed certificates with Seerr
  • Document the NODE_EXTRA_CA_CERTS approach (recommended) with Docker CLI and Docker Compose examples
  • Document the NODE_TLS_REJECT_UNAUTHORIZED=0 fallback with appropriate security warnings
  • Update the four "Use SSL" sections in services.md and mediaserver.mdx to link to the new guide instead of saying certificates are "not supported"

Closes #2578

AI Disclosure

AI tools were used to assist with drafting and reviewing this documentation. All content was verified for technical accuracy against the Node.js documentation and the Seerr codebase.

Summary by CodeRabbit

  • Documentation
    • Added comprehensive guide for configuring Seerr with self-signed SSL certificates from upstream services, including configuration options via environment variables.
    • Updated media server and services documentation to clarify that self-signed certificates can be configured to work with Seerr.

Add a new page at docs/using-seerr/advanced/ covering
NODE_EXTRA_CA_CERTS (recommended) and NODE_TLS_REJECT_UNAUTHORIZED
(fallback) for self-signed certificate setups.

Update the four "Use SSL" sections in services.md and mediaserver.mdx
to cross-reference the new guide instead of saying "not supported."

Closes seerr-team#2578
@costajohnt costajohnt requested a review from a team as a code owner March 28, 2026 21:44
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 28, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 4b8e9361-d9a4-4174-9d62-fb06adccbf48

📥 Commits

Reviewing files that changed from the base of the PR and between 56b79ff and 60dfbeb.

📒 Files selected for processing (3)
  • docs/using-seerr/advanced/self-signed-certificates.mdx
  • docs/using-seerr/settings/mediaserver.mdx
  • docs/using-seerr/settings/services.md

📝 Walkthrough

Walkthrough

This pull request adds a new documentation page for configuring Seerr with self-signed SSL certificates and updates existing settings documentation to reflect that such certificates can now be supported through configuration, rather than being unsupported.

Changes

Cohort / File(s) Summary
New Self-Signed Certificate Guide
docs/using-seerr/advanced/self-signed-certificates.mdx
Added comprehensive documentation page explaining two methods to handle self-signed certificates: using NODE_EXTRA_CA_CERTS environment variable with CA certificates (primary approach) and setting NODE_TLS_REJECT_UNAUTHORIZED=0 (secondary approach). Includes Docker CLI and Docker Compose examples for both methods with relevant warnings and format requirements.
Updated Settings Documentation
docs/using-seerr/settings/mediaserver.mdx, docs/using-seerr/settings/services.md
Updated "Use SSL" documentation across media server and service settings to replace "self-signed certificates not supported" with "self-signed certificates not trusted by default but can be configured," and added cross-references to the new self-signed certificate guide.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 Self-signed certs were quite a fright,
But now our docs shine clear and bright!
With NODE_EXTRA_CA in hand so true,
Seerr welcomes certificates, old and new! 🔐

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: add self-signed certificate guide' accurately summarizes the main change: adding documentation for self-signed certificate configuration.
Linked Issues check ✅ Passed The PR fully addresses issue #2578 by documenting two approaches for self-signed certificates (NODE_EXTRA_CA_CERTS and NODE_TLS_REJECT_UNAUTHORIZED) and updating existing docs to reference the new guidance.
Out of Scope Changes check ✅ Passed All changes are directly within scope: new documentation page and updates to existing documentation sections to reference the new guide. No unrelated modifications present.

✏️ 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 and usage tips.

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.

Add docs for self-signed certificates

1 participant