Skip to content

Conversation

kaczmar2
Copy link

What does this PR aim to accomplish?:

This PR adds comprehensive SSL certificate configuration guides for Pi-hole users who need alternatives to the default self-signed certificate.

How does this PR accomplish the above?:

Adds two detailed guides under docs/guides/ssl/:

  1. Automatic Certificate Renewal (automatic-renewal.md):
  • Uses acme.sh + Let's Encrypt + Cloudflare DNS validation
  • Covers installation, configuration, and automated renewal
  • Includes Pi-hole-specific certificate installation steps
  1. Self-Signed Certificate Creation (self-signed.md):
  • Method 1: Internal CA approach
  • Method 2: Direct self-signed certificates

Both guides provide step-by-step instructions with troubleshooting.

Link documentation PRs if any are needed to support this PR:

N/A


By submitting this pull request, I confirm the following:

  1. I have read and understood the contributors guide, as well as this entire template. I understand which branch to base my commits and Pull Requests against.
  2. I have commented my proposed changes within the code and I have tested my changes.
  3. I am willing to help maintain this change if there are issues with it later.
  4. It is compatible with the EUPL 1.2 license
  5. I have squashed any insignificant commits. (git rebase)
  6. I have checked that another pull request for this purpose does not exist.
  7. I have considered, and confirmed that this submission will be valuable to others.
  8. I accept that this submission may not be used, and the pull request closed at the will of the maintainer.
  9. I give this submission freely, and claim no ownership to its content.

  • I have read the above and my PR is ready for review. Check this box to confirm

@kaczmar2 kaczmar2 requested a review from a team as a code owner August 19, 2025 16:32
Copy link

netlify bot commented Aug 19, 2025

Deploy Preview for pihole-docs ready!

Name Link
🔨 Latest commit 4fd65ff
🔍 Latest deploy log https://app.netlify.com/projects/pihole-docs/deploys/68b65e3ed90c4b0008d07ff7
😎 Deploy Preview https://deploy-preview-1278--pihole-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

- Add automatic SSL certificate renewal guide using acme.sh + Let's Encrypt
  * Covers Cloudflare DNS validation setup
  * Includes certificate installation and Pi-hole configuration
  * Documents automatic renewal via cron jobs

- Add self-signed SSL certificate creation guide
  * Method 1: Internal CA approach for multiple servers (recommended)
  * Method 2: Direct self-signed certificates for single server
  * Includes Subject Alternative Names (SAN) configuration
  * Covers browser certificate installation steps

These guides are adapted from my existing GitHub Gists:
- Automatic renewal: https://gist.github.com/kaczmar2/17f02a0ddb59a7d336b20376695797c6
- Self-signed certs: https://gist.github.com/kaczmar2/e1b5eb635c1a1e792faf36508c5698ee

Both guides provide step-by-step instructions for different deployment scenarios.

Fix Pi-hole branding in new guides.

Signed-off-by: Christian Kaczmarek <[email protected]>
Signed-off-by: Christian Kaczmarek <[email protected]>
@kaczmar2 kaczmar2 force-pushed the ssl-certificate-guides branch from c042d84 to 4fd65ff Compare September 2, 2025 03:02
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.

1 participant