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-provided URL.

Features

  • Support for multiple custom domains per application

  • Three SSL mode options:

    1. Automated HTTPS - Automatically obtains and manages SSL certificates through Let’s Encrypt. Most people use this.
    2. Self-signed SSL - If you are configuring your app behind a CDN and the CDN supports self-signed certs for this origin. For example, this would be used with Cloudflare’s Full SSL mode.
    3. HTTP Only - If you need to serve your site without https for some reason. An example is Cloudflare Flexible SSL. Another example is CloudFront which does not support self-signed certs but supports http origins.

Configuration Steps

  1. Navigate to your app’s Custom Domains section
  2. Click “Add New Domain”
  3. Enter your domain name (e.g., myapp.com)
  4. Select your preferred SSL mode
  5. Configure your DNS settings:
    • Point your domain’s A record to your Blossom load balancer IP(s)
    • If multiple load balancer IPs are available, you can use weighted DNS for high availability

DNS Configuration

After adding your custom domain, you’ll need to configure your DNS settings. Blossom will provide you with the load balancer IP address(es) to use. Create an A record in your DNS provider’s settings pointing to these IPs.

Troubleshooting

If you encounter issues with custom domains or SSL certificates, see our Caddy debugging guide for detailed troubleshooting steps.

Wildcard Domains

In this section: