Blossom makes it easy to configure custom domains for your applications. With custom domains, you can serve your application through your own domain name (e.g., myapp.com) instead of using the generated Blossom managed URL.
SSL Modes
Blossom offers four SSL modes for your custom domains:
-
Automated HTTPS - Automatically obtains and manages SSL certificates through Let’s Encrypt. This is the option that most users to start off using.
-
Self-signed SSL - Useful when configuring your app behind a CDN that supports self-signed certs for origin. For example, Cloudflare’s Full SSL mode.
-
HTTP Only - For when SSL is handled by your CDN. For example, Cloudflare Flexible SSL or CloudFront. This is what most use for Cloudflare.
-
Wildcard HTTPS - For wildcard domains like
*.example.com. Requires a configured DNS provider for automatic certificate management. The credentials are used to create a DNS record, validate, and delete the DNS record immediately.
Quick Setup
- Navigate to your app’s Custom Domains section
- Click “Add New Domain”
- Enter your domain name (e.g.,
myapp.com) - Select your preferred SSL mode
- For wildcard domains, select a DNS provider
- Configure your DNS settings to point to your Blossom load balancer IP(s)
DNS Configuration
Configure your DNS settings after adding your custom domain by creating an A record pointing to your Blossom load balancer IP(s).
Troubleshooting
If you encounter issues with custom domains or SSL certificates, see our Caddy debugging guide for detailed troubleshooting steps.
Related Documentation
- For direct wildcard SSL configuration, see Wildcard Domains
- For CDN-based wildcard SSL configuration, see CDN Wildcard Domains