How to setup a Site
Creating a New Site
Note: An SSL Certificate needs to be uploaded before a site can be created.
To create a new site entry, three pieces of information are needed.
- Hostname (this cannot be a wildcard)
- Certificate name
- Code service label
The hostname is up to you, and the certificate name is also decided by you when uploaded. The code service label is the name of the code service that you intend traffic for this hostname to go to. If you don’t know what your code service’s name is, you can find it in The Platform dashboard.
The CLI sites create command is used to create the site, taking the form
datica -E "<your_env_name>" sites create <hostname> <code service label> <certificate name>. For example, to set up a site mapping
example.com to a code service named
code-1 using an uploaded cert named
datica -E "<your_env_name>" sites create .example.com code-1 example
Note the leading
. - this is required for apex domains.
If you’ve uploaded a wildcard cert and intend to use it with multiple subdomains, that cert can be used as many times as needed:
datica -E "<your_env_name>" sites create api1.example.com code-1 wildcard-example datica -E "<your_env_name>" sites create api2.example.com code-2 wildcard-example datica -E "<your_env_name>" sites create api3.example.com code-3 wildcard-example
In order for your service proxy to pick up the new site, it needs to be redeployed:
datica -E "<your_env_name>" redeploy service_proxy
If a site needs to be removed, use the sites rm command.
How do I setup DNS to point to my Datica environment?
The Platform environments are designed to have CNAMES or ALIAS records pointed at them. We create a public hostname for the environment that functions as the target of your DNS entries. You will receive your public hostname as part of your on-boarding process after we provision your environment. Datica Public Hostname:
Use CNAMES for pointing specific subdomains at the Datica public hostname. CNAME Example:
mysite.wxyz.com CNAME pod0123.catalyzeapps.com
Use ALIAS records for pointing the bare domain at the Datica public hostname. ALIAS Example:
wxyz.com ALIAS pod0123.catalyzeapps.com
If you wish to redirect non-matched DNS traffic to your Datica public hostname, you can create a wildcard CNAME record with your DNS provider.
*.wxyz.com CNAME pod0123.catalyzeapps.com