Skip to content

docs: warn that password-protected keys break Caddy in custom SSL setup#3008

Merged
sebastianiv21 merged 4 commits intomainfrom
docs/custom-ssl-password-protected-key-warning
May 1, 2026
Merged

docs: warn that password-protected keys break Caddy in custom SSL setup#3008
sebastianiv21 merged 4 commits intomainfrom
docs/custom-ssl-password-protected-key-warning

Conversation

@wyattwalter
Copy link
Copy Markdown
Contributor

Summary

  • Adds a caution callout in the custom SSL certificate setup page noting that Caddy cannot load password-protected private keys, which prevents Appsmith from starting
  • Provides the openssl pkey command to strip the passphrase from the key
  • Clarifies the key verification step so users know whether their key is still encrypted

Test plan

  • Render the custom domain docs page locally and verify the caution admonition displays correctly
  • Verify markdown formatting and code blocks render as expected

🤖 Generated with Claude Code

Caddy cannot load encrypted private keys, so Appsmith fails to start
when a password-protected key is supplied. Add a caution callout with
the openssl command to strip the passphrase, and clarify the key
verification step.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
appsmith-docs Ready Ready Preview, Comment May 1, 2026 8:55pm

Request Review

Restructure so users only see the passphrase-removal instructions if
they were actually prompted for a password during key verification.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
wyattwalter and others added 2 commits May 1, 2026 15:52
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@sebastianiv21 sebastianiv21 merged commit 4cf6831 into main May 1, 2026
5 checks passed
@sebastianiv21 sebastianiv21 deleted the docs/custom-ssl-password-protected-key-warning branch May 1, 2026 21:00
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.

2 participants