Getting Started

Domain Configuration & SSL Provisioning

How to point your domain's DNS to your app's instances and provision an SSL certificate to enable HTTPS.

Once your app's instance(s) have been provisioned and bootstrapped, to make your app live to the internet, you will need to point your domain's DNS to either your standalone instance, or, to your load balancer instance(s).

DNS for Standalone Deployments

To point your domain, login to your DNS provider (or domain registrar) and navigate to where you can create a new DNS record. For the record type select A and for the IP Address, enter the IP Address displayed on your deployment's setup page in the Push dashboard. Make sure to set the TTL (Time to Live) to the lowest value possible. This ensures that the DNS will propagate as fast as possible.

Once you've created the new DNS record, head back to the setup page for your deployment in the Push dashboard. Behind the scenes, Push will check your domain's DNS configuration and let you know when it's correct. Once it is, you will be presented with an option to provision your app's SSL certificate.

DNS for Load Balanced Deployments

Because load balanced deployments allow you to create multiple clusters of instances in different regions, it's recommended that you utilize a DNS provider that supports GeoDNS (the ability to route traffic to a specific IP based on the location of the user's IP address).

For example, Cloudflare's Load Balancing product offers GeoDNS capabilities.

Get Help via StackTrace

Confused? You can book an appointment to get help setting this up via CheatCode's StackTrace service to ensure that everything is wired properly.

While you can just add multiple A records (with each record pointing to one of your load balancer's IP addresses), this dramatically reduces the resiliency and value of having multiple clusters.

By default, DNS providers will use "round robin" routing, meaning, each request is routed to the "next A record in line." If any of the IPs (load balancers) are unresponsive, they may still receive traffic (and users will get an error) as most DNS providers do not offer health checking or intelligent routing as part of their standard DNS service.

Provisioning SSL

Once Push has detected that your domain is properly pointed at your app, click the "Provision SSL Certificate" button to begin the provisioning process. This will take about 10-20 seconds to complete. Push will attempt to provision the SSL certificate, and if successful, install the certificate and schedule renewal attempts twice per day (currently, certificates are good for 90 days and can be renewed within 30 days).

Once complete, you will not need to provision your SSL certificate again (unless you're moving your app to a new domain). Renewals are handled automatically on your behalf.