How to set up a custom domain
Skygear provides default suffixed domain .skygearapp.com for you to access your application. You can update your application to use a custom domain which owned by you instead of the skygear generated domain.
More commands on custom domains can be found here.
To setup custom domain, you need to install and configure skycli properly. Please follow this guide to setup skycli.
$ skycli domain add <your_domain>​#example$ skycli domain add www.example.com --app=myapp
After adding the custom domain, please follow the instructions shown in the console and add dns records in your dns provider.
#exmaple$ skycli domain add www.example.com --app=myappAdded domain www.example.com successfully!​Add following DNS records in your DNS provider.​TYPE HOST VALUETXT _skygear.example.com <txt_record_value>A www.example.com <a_record_value>​After updating DNS records, run `skycli domain verify www.example.com` to verify domain.
$ skycli domain verify <your_domain>​#example$ skycli domain verify www.example.com --app=myappSuccess! You can now access your app through www.example.com.Your site may show a security certificate warning until the certificate has been provisioned.
After verifying the domain successfully, you can now access your application with the new domain.
Skygear Cluster by default provisions SSL certificate signed by Let's Encrypt. If you want to use your own certificate, you can update it with skycli domain update command.
# Create tls secret$ skycli secret create <your_tls_secret_name> --type=tls --cert=<path/to/tls-cert.pem> --key=<path/to/tls-key.pem># Update domain to use tls secret$ skycli domain update <your_domain> --tls-secret=<your_tls_secret_name>​​#example$ skycli secret create myapp-tls --type=tls --cert=path/to/tls-cert.pem --key=path/to/tls-key.pem --app=myappSuccess! Created secret myapp-tls​$ skycli domain update example.com --tls-secret=myapp-tls --app=myappSuccess! Updated domain example.com​$ skycli domain list --app=myappDOMAIN VERIFIED CUSTOM_CERT REDIRECT SSL_CERT_EXPIRY CREATED_ATexample.com true true - 2020-11-26 20:00:00 +08:00 2020-01-01 18:00:00 +08:00
For some case, you may want to redirect all requests of a custom domain to another specific domain (e.g. Redirect example.com to www.example.com).
$ skycli domain update example.com --redirect-domain=www.example.comSuccess! Updated domain example.com​$ skycli domain list --app=myappDOMAIN VERIFIED CUSTOM_CERT REDIRECT SSL_CERT_EXPIRY CREATED_ATwww.example.com true false - - 2019-11-26 18:00:00 +08:00example.com true false www.example.com - 2019-11-26 18:00:00 +08:00
​
