How to use a custom domain with StorageRoom
It is possible to configure the StorageRoom CMS to be available on a custom domain if the plan of your Account supports it. You could run the CMS on a domain like cms.mycompany.com, customer1.mycompany.com or www.mycompany.com (please note that you can currently not use api.mycompany.com).
To use this feature you need to complete the following steps:
- Register and configure a custom domain
- Purchase an SSL certificate for the custom domain
- Configure StorageRoom to use your custom domain
1. Register and configure a custom domain
You need to register a domain first if you don't have one already. Domain registrars we can recommend are:
If you would like to run the CMS on "cms.mycompany.com" you would need to register the main "mycompany.com" domain with a registrar, which will cost you about 10-20 USD/year.
After that you need to configure the DNS entries of the domain that you just registered.
To run StorageRoom on "cms.mycompany.com" you need to log into your registrars website and add a CNAME entry, a Canonical Name, for the subdomain "cms" that points to "cms.storageroomapp.com".
Each domain registrar has slightly different ways to create CNAME records. Google provides instructions on how to setup a custom domain for Google Apps, you can follow them, just remember to replace "ghs.google.com" with "cms.storageroomapp.com".
Keep in mind that changes to DNS records may take up to 48 hours to take effect.
2. Purchase an SSL certificate for the custom domain
The communication between StorageRoom and mobile devices/browsers needs to be secure, which is why we use SSL to encrypt all traffic.
You need to purchase an SSL certificate for the custom domain ("cms.mycompany.com") that you registered earlier. The domain registrars that we recommended above provide SSL certificates as well and a certificate for a single domain will cost about 10 USD/year. Another basic option for a free certificate is http://www.startssl.com/.
Again, each company has slightly different ways to create SSL certificates. When in doubt, check with the particular company you're using for additional help or instructions. When creating the SSL certificate, be sure to enter the full domain on which you want to run StorageRoom, including the subdomain ("cms.mycompany.com").
Use the PEM format and save the certificate and the certificate key after creation to your hard drive.
3. Configure StorageRoom to use your custom domain
Now that you have a custom domain pointed at our servers and an SSL certificate you can tell StorageRoom to listen on your particular domain.
Only the owner of the Account is allowed to change the domain. He must log in and go to "Account > Edit" and enter the following data:
- Domain: The domain configured above (e.g. "cms.mycompany.com")
- SSL Certificate: Copy and paste the SSL certificate in the PEM format into the text box
- SSL Certificate Key: Copy and paste the SSL certificate key into the text box
After saving your changes we will automatically update our servers to listen on your custom domain. This might take some time. After that you can open your browser and access the CMS and the API through your custom domain ("cms.mycompany.com").
We don't disable your subdomain on storageroomapp.com, so you can always use that in case your own domain isn't working. If you experience any problems in settings all of this up please create a support ticket or contact us in the chat.