Getting started / Reference /
Domains

Domains

Overview

Domains in Tapitalee allow you to connect custom domain names to your application, providing branded URLs and professional web presence. The system handles DNS routing, SSL certificate management, and load balancer configuration to make your application accessible via your custom domain names.

Purpose and Benefits

  • Professional Branding: Use your own domain names instead of default URLs
  • Multiple Domains: Support multiple domains and subdomains for the same app
  • DNS Integration: Optionally integrates with Route53 if you use the Route53 add-on

How Domains Work

Domain setup involves:

  • Tapitalee provides a built-in hostname (under *.dns.tapitalee.net) to point your CNAME record to
  • Add your domain name(s) to Tapitalee, if using Tapitalee to set up a proxy/load balancer, so the domains can be direct to the applications.

Route53 Integration

Domains and subdomains that are added to an app will be automatically added to a Route53 Hosted Zone, if a Route53 add-on is present with a matching domain.

Deploying apps with custom domains

  • Apps get internal tapitalee.net hostnames, but users generally want their own domain used. IP addresses for apps are dynamic in Tapitalee, and change on each deploy.
  • Do you want to retain control of the DNS outside the AWS account? Point to the tapitalee.net internal hostname using CNAME. This won’t work for the root of the domain (eg. this works for www.app.com but not app.com)
  • If Cloudflare is used for the domain, the Tapitalee Cloudflare addon can be used to tunnel back to Cloudflare and it can manage the DNS as well as provide WAF services. Nothing more is needed at the Tapitalee end.
  • If the domain is in registered in the AWS account that Tapitalee is connected to, then adding the route53_zone Add-on for the domain will find and use a Route53 Hosted Zone (or create one if it doesn’t exist).
  • Adding Tapitalee domains objects to the app (tapit create domain) tells SecureProxy addon (if present) to be configured to request LetsEncrypt TLS certs for those domains or the route53_zone addon (if present) to update these hostnames with the app’s IP addresses dynamically.
  • The simplest way, in summary, is either use Cloudflare, or register/transfer the domain in the same AWS account as Tapitalee is configured for, and then configure a route53_zone addon for it, and add the hostnames that the app should served on as Domains. This will then result in DNS A records being added after deploy.

CLI Usage

Create Domain

Add a custom domain to the app

tapit create domain name=domain.com [--ignore-existing]

Parameters

  • name: The domain name to add (required, e.g., www.myapp.com)
  • --ignore-existing: Skip creation if a resource with the same name already exists (useful for idempotent scripts)

Examples 

tapit create domain name=myapp.com

List Domains

List all custom domains configured for the app

tapit list domains

Delete Domain

Remove a custom domain from the app

tapit delete domain name=domain.com

Parameters

  • name: The domain name to remove (required)