# CloudflareSSL

CloudflareSSL is a self-hosted security app. A small Docker container that generates Let's Encrypt certificates for Unraid using the Cloudflare API allowing to avoid "this page is not secure" warnings when connecting to Unraid locally. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2363/cloudflaressl

## Description

A small Docker container that generates Let's Encrypt certificates for Unraid using the Cloudflare API allowing to avoid "this page is not secure" warnings when connecting to Unraid locally.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

43/100 (Fair), based on 4 of 4 factors.
- Maintained: 68 (last commit 96 days ago)
- Popular: 18 (7 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- GitHub: https://github.com/tenasi/cloudflaressl
- Docker Hub: https://hub.docker.com/r/tenasi/cloudflaressl
- Unraid: https://ca.unraid.net/apps/cloudflaressl-17fhopk1kp5wjo?q=CloudflareSSL

## Common questions

### Can I request one certificate for multiple domains in this container?

Yes, set CERTBOT_DOMAINS to a comma-separated list of domains for the certificate.

### How do I handle slow DNS propagation when the DNS challenge runs?

Set CLOUDFLARE_PROPAGATION_SECONDS to the wait time, in seconds, after setting the DNS TXT records before validation. The default is 10 seconds.

### How do I change the name of an existing certificate?

Set CERTBOT_CERT_NAME to the certificate name to update or modify. CERTBOT_EXPAND is deprecated, and CERTBOT_CERT_NAME is the replacement.

### How can I make the container run once instead of renewing periodically?

Set RENEWAL_INTERVAL to 0 to disable renewal checks and only run once. Otherwise it checks every 43200 seconds, or 12 hours, by default.

### Does issuing these certificates require exposing ports or running a proxy?

No, it uses a DNS challenge via the Cloudflare API to request Let's Encrypt certificates for Unraid without exposing ports or running a proxy.

### What Cloudflare credentials does the container use?

Set CLOUDFLARE_API_TOKEN to a Cloudflare API token for DNS authentication, or point CLOUDFLARE_CREDENTIALS_FILE to a credentials file such as the default /cloudflare.ini. Treat the token like a password because it can modify DNS records.

---
Source: Our Local Host (https://ourlocalhost.com/app/2363/cloudflaressl), the self-hosted and open-source app directory.
