Appshell Domain:
The appshell custom domain will allow your app users to install the app on their mobile devices using a custom link (URL). Please follow the steps below to integrate the appshell custom domain.
Step 1: To integrate your existing domain into your Beezer app, click on the appshell custom domain option under the Build section of your Beezer dashboard.
Step 2: Once you click on the appshell custom domain option, specify your domain name under the domain name option and switch on “Enable appshell custom domain” slider button.
Step 3: The Domain Validation settings will appear after enabling the appshell custom domain option. Please copy and paste the CNAME records into the DNS settings on your existing domain provider dashboard. You can click on manage DNS settings for the domain (example GoDaddy dashboard shown below) or seek assistance from your domain provider's customer support team.
Once the entries are added, navigate to your Beezer dashboard and click on Validate Domain option. If the validation fails, wait for 15-20 minutes and try again, as some domain providers take time to update the records at their end.
Note: If your DNS provider adds an SSL to your domain, you will need to disable it as SSL is added automatically when you add the custom domain. You may receive "Something went wrong" error message. To resolve this error, please navigate to the SSL settings by clicking on the advance section in your DNS provider's dashboard and disable "Auto SSL" option. Once your custom domain is setup, you can again enable the auto SSL option from your DNS dashboard.
Step 4: Once the validation is complete, navigate to the DNS settings of your domain provider and create a new CNAME entry. Now, set the Host to WWW. and point it to CloudFront address (xxxxxxxxxxxxxxxx.cloudfront.net). If you are using sub-domain there will be different subdomain host and CloudFront address.
Step 5: Once the CNAME record is updated, navigate to Forwarding section and select the settings "forward only", the forward type as "Permanent (301)" and forward it to http://www.yourwebsitename.com.
Note: This option will not be visible if you are using a sub-domain (for eg. https://www.app.yourwebsitename.com). In this case, you will just need to enter the cloudfront address and publish the app.
Platform Domain:
The platform custom domain can be used by the app admins of your app to login to the Beezer dashboard and publish changes to their respective apps. Please follow the steps below to integrate the platform custom domain.
Step 1: To integrate your platform domain, click on the platform custom domain option under the Build section of your Beezer dashboard.
Step 2: Once you click on the platform custom domain option, specify the domain name (URL) under the platform domain name option and switch on “Enable platform custom domain” slider button. You will share this link with your app admins once the setup is complete, which will allow your app admins to login to the dashboard and edit the app.
Step 3: The Domain Validation settings will appear after enabling the platform custom domain option. Please copy and paste the CNAME records to the DNS settings on your existing domain provider's dashboard. You can follow the same steps provided under Step 3 for appshell custom domain configuration.
Note: If your DNS provider adds an SSL to your domain, you will need to disable it as SSL is added automatically when you add the custom domain. You may receive "Something went wrong" error message. To resolve this error, please navigate to the SSL settings by clicking on the advance section in your DNS provider's dashboard and disable "Auto SSL" option. Once your custom domain is setup, you can again enable the auto SSL option from your DNS dashboard.
Step 4: Once the validation is complete, navigate to the DNS settings of your domain provider and create a new CNAME entry. Set the Host to Login. and point it to CloudFront address (xxxxxxxxxxxxxxxx.cloudfront.net).
Step 5: You can now publish the app and share the custom platform URL directly with your app admins. App admins can use this custom URL to login to the dashboard and make changes to the app without seeing the Beezer branding.
Please note: The Appshell and Platform domain in Reseller accounts or accounts with multiple apps can be configured only via the Super admin platform.
Using a Sub Domain:
If you want to setup the custom domain using a Sub domain, please do not create the sub domain directly in your domain provider's dashboard. The sub domain will be created via the Beezer platform itself (please delete the sub domain if you already created it in your domain provider's dashboard).
- To set up a custom domain with a subdomain, for example, app.domain.com, you need to enter the desired domain with the subdomain into the input box. (see the screenshot below).
- Click on the Enable Appshell / Platform custom domain toggle, then click on the Set Up Domain button, and wait for the DNS records to appear on the dashboard.
- Now please refresh your browser page. This is required so AWS knows that your sub domain is available and to get the correct CNAME records. Refreshing the browser forces AWS to fetch the updated CNAME records.
- After you refresh your browser page, the DNS records which appear on the dashboard should have a host name ending with your subdomain. Example: XXXXXXXXXXXX.yoursubdomain
- Follow the process from Step 2 by clicking here, and continue with the setup.
Shortcuts for some of the top domain providers:
Note: After these settings are updated, the changes may take some time to reflect depending upon the time specified by your domain provider.