Skip to main content

How to Use Your Own Domain With AWS

Prerequisites​

Step 1 - Setup a Hosted Zone in AWS Route 53​

info

If you purchased your domain with AWS, you can skip this step.

For Defang to be able to manage your domain, you need to create a public hosted zone in AWS Route 53. It should list four AWS nameservers and should look like this:

Hosted Zone UI Screenshot

Step 2 - Configure your DNS settings in your domain registrar​

info

If you purchased your domain with AWS, you can skip this step.

You'll need to create NS records in your domain registrar that point to the AWS Route 53 name servers which we got in the previous step. For example, in CloudFlare, the NS records would look like this:

CloudFlare NS Records Screenshot

Step 3 - Set up Your Compose File​

In your compose file, specify the domain name you want to use, for example

services:
    web:
        domainname: nextjs.defang.chewydemos.com
        build:
            context: ./web
            dockerfile: Dockerfile
        ports:
            target: 3000
            mode: ingress

Step 4 - Deploy​

Run the following command to deploy your service:

defang compose up

This will deploy your service and set up the necessary DNS records in Route 53 as seen in the screenshot below as well as provision SSL certificates. You can now access your service at the domain you specified in your compose file.

Route 53 DNS Records Screenshot

For a deeper discussion of how to use a custom domain with Defang, see our Domain concept docs.