[PR #6477] docs: add guidance on avoiding Nginx header collisions for COOP/COEP #6554

Closed
opened 2026-02-28 21:29:57 -06:00 by GiteaMirror · 0 comments
Owner

Original Pull Request: https://github.com/actualbudget/actual/pull/6477

State: closed
Merged: Yes


The current Nginx documentation notes that "additional security mechanisms" should be implemented but doesn't specify the pitfalls of manual header management.

In modern deployments, actual-server sends its own COOP/COEP headers. When a user adds these manually in Nginx (as often required for SSL/Secure Contexts), it results in duplicated headers which browsers reject, causing a fatal app crash.

This PR adds a recommendation to use proxy_hide_header to ensure Nginx serves as the single source of truth for security policies, preventing the SharedArrayBufferMissing error.

Summary by CodeRabbit

  • Documentation
    • Added guidance on NGINX cross-origin isolation, risks from duplicated COOP/COEP headers and potential SharedArrayBufferMissing.
    • Documented using NGINX as the authoritative source for security headers, how to prevent header duplication (e.g., hiding proxied headers) and included a complete example location block.
    • Added COEP and COOP to the documentation spelling/expect list.

✏️ Tip: You can customize this high-level summary in your review settings.

**Original Pull Request:** https://github.com/actualbudget/actual/pull/6477 **State:** closed **Merged:** Yes --- The current Nginx documentation notes that "additional security mechanisms" should be implemented but doesn't specify the pitfalls of manual header management. In modern deployments, actual-server sends its own COOP/COEP headers. When a user adds these manually in Nginx (as often required for SSL/Secure Contexts), it results in duplicated headers which browsers reject, causing a fatal app crash. This PR adds a recommendation to use proxy_hide_header to ensure Nginx serves as the single source of truth for security policies, preventing the SharedArrayBufferMissing error. <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Added guidance on NGINX cross-origin isolation, risks from duplicated COOP/COEP headers and potential SharedArrayBufferMissing. * Documented using NGINX as the authoritative source for security headers, how to prevent header duplication (e.g., hiding proxied headers) and included a complete example location block. * Added COEP and COOP to the documentation spelling/expect list. <sub>✏️ Tip: You can customize this high-level summary in your review settings.</sub> <!-- end of auto-generated comment: release notes by coderabbit.ai -->
GiteaMirror added the pull-request label 2026-02-28 21:29:57 -06:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#6554