Domains

When you deploy an application with Deckrun, it is automatically assigned a public domain, allowing you to access it immediately without any additional configuration. Deckrun also automatically generates a free SSL certificate using Let's Encrypt, so all your domains will be served over HTTPS.

Automatic domains

The automatically generated domain follows a random pattern and is unique for each application. For example: myapp-red-lemon.deckrun.app.

This allows you to quickly check that your deployment is working correctly and share the progress with your team.

If you don't want to use this domain, you can delete it at any time. You can also add it back later if you need it.

Custom domains

To use your own domain, you must first add it to your application and then configure the DNS records to point to Deckrun's servers.

You can add a domain using the CLI:

deck domains add my-app.com

Once added, Deckrun will provide you with the DNS records that you must configure in your domain provider. After a few minutes for the DNS to propagate, your application will be available at your custom domain.

Custom SSL certificates

If you want to use your own certificate, you can do so by providing the path to the certificate and private key files:

deck domains add my-app.com --cert /path/to/cert.pem --key /path/to/key.pem

Wildcard domains

Deckrun also supports wildcard domains (e.g., *.my-app.com). However, for wildcard domains, it is required to provide your own SSL certificate, as Deckrun cannot automatically generate one in this case because it does not have control over your domain's DNS.

To add a wildcard domain, you must use the --cert and --key flags:

deck domains add *.my-app.com --cert /path/to/cert.pem --key /path/to/key.pem