How To Set Up Custom Domains
Written by Amanda Stançani
Updated at July 1st, 2024, by Amanda Stançani
Your Helpjuice account comes with a default address, like help.helpjuice.com. You can get rid of the .helpjuice.com part and use a custom subdomain name instead, like help.example.com.
Domain Setup
The first thing you need to do, before updating the Helpjuice settings page, is to update your DNS Records.
Under your DNS settings, of your DNS provider, make sure to create a new record for what you'd like your new Helpjuice Knowledge Base URL to reside on. Something like that:
| Name |
Type |
Alias |
|---|---|---|
| Your Custom Domain |
CNAME |
your_subdomain.helpjuice.com |
In some cases you'll be asked for a TTL field, you can use 43200 as value.
Helpjuice Setup
There are two different ways of configuring the Helpjuice side, and it depends on whether you are going to use the Free Certificate we offer or use a Custom SSL Certificate.
SSL Certificate Provisioned By Helpjuice
If you are using Custom Domain, you do not need to upload SSL keys as we already auto-generate it for you using LetsEncrypt. We also handle auto-renewal of your LetsEncrypt SSL. You do not need to do anything after setting up your Custom Domain.
In this case, the only field you need to update is CNAME/Custom Domain under your_subdomain.helpjuice.com/admin/settings/custom_domain_setup
- Click on your Profile Picture > Settings
- Access the Custom Domain Setup section
- Fill in the CNAME/Custom Domain field
Please note that the certificate may take 30 minutes to be available on your KB.Uploading a Custom Certificate
If you wish to upload your own SSL Certs, you may still do so and we'll use your provided ones instead of LetsEncrypt.
- Click on your Profile Picture > Settings
- Access the SSL section
- Fill in the Your Domain field
- Upload your Certificate
- Upload your Private Key
For more information on how to upload your custom certificate check this article.
DeleteIf you wish to force your entire knowledge base to run under HTTPS/forcing SSL, you may do so under the Knowledge Base Settings page.
Too Many Redirects Error
If instead of pointing your DNS directly to Helpjuice you use a proxy, you may start seeing the Too Many Redirects error in the browser when trying to access it. That happens when you don't use HTTPS in the connection between your proxy and Helpjuice, so make sure you point it to https://subdomain.helpjuice.com.
Heroku
If you have an app on Heroku that's already connected to your custom domain, you must first remove it from your app.
If you have a wildcard SSL certificate managed by Heroku that includes your custom domain, you must contact Heroku to allow our app to manage your custom domain. Once you contact them, they will provide a ticket number. You will have to send that number to our support team so we can move forward with the domain registration process.