Custom Domain

Custom domains allow your Noloco app to appear more professional and branded by using a web address that aligns with your business name (e.g., www.yourcompany.com instead of yourcompany.noloco.io).

Each app can be accessed at a unique URL like mycompany.noloco.co but it is better if you use a custom domain for your portal for a truly white-labeled experience like portal.mycompany.com

With Noloco connecting a custom domain is easy

What You'll Need

  • A Noloco account and a published app.

  • A domain name purchased from a domain registrar (e.g., GoDaddy, Namecheap, Cloudflare).

  • Basic familiarity with your domain registrar's dashboard.

Adding Your Custom Domain to Your Noloco App

  1. Navigate to the 'Domains' Settings in your Noloco App's settings.

  2. Enter Your Domain: Click the 'Add a domain' button and enter the domain or subdomain you wish to connect e.g., www.yourcompany.com or app.yourcompany.com

  3. Save Changes: Noloco will generate DNS records for you to add to your domain registrar.

Adding your DNS Records

After adding your domain to your Noloco app, you will be asked to add some records to your domain's DNS settings. To do this, you need to find the β€œDNS Records” section in your domain name provider's account or dashboard. This will look different for each domain provider, but here are the general steps:

  1. Look for an area that's related to DNS, e.g. Manage DNS, Advanced DNS, etc.

  2. Locate the area or section where you can add β€œrecords” or DNS records

If you get stuck, try contacting your domain name provider's support or exploring their help articles.

The next step will be different depending on the type of domain you have used. You could be using a subdomain, or a normal domain.

  • A normal domain is something like yourcompany.com or yourcompany.co.uk

  • A subdomain is anything like app.yourcompany.com or www.yourcompany.com

    • You can swap app with anything you like, such as portal or secure

    • app.yourcompany.com is a subdomain of yourcompany.com

For Normal Domains

It is more challenging to use a normal domain as a custom domain for your Noloco app, so we usually reccomend using a subdomain instead. If you are using Cloudflare as your DNS provider, or any other provider that supports an ALIAS record you can add an ALIAS record that points to ssl.noloco.co If you do not see this option, you will need to switch your nameservers to a provider that supports ALIAS records (like Cloudflare) or use a subdomain as described below.

For Subdomains

Add a CNAME record for your domain pointing to ssl.noloco.co

Verify Domain Connection

After adding your DNS records to your domain registrar, you can come back to Noloco and verify the setup. This will check if you have correctly setup your domain name, and it will activate your custom domain. DNS changes can take up to 48 hours to propagate worldwide, so if this doesn't work immediately, please try again in a few minutes or a few hours.

Troubleshooting Custom Domains

I don't own a domain yet

Buying a new domain is quick, easy and typically cheap. We strongly reccomend using Namecheap to purchase your domains. They typically cost ~10$ for a .com but can vary for other types of domains.

Using with Cloudflare

If you are setting up your custom domain with Cloudflare DNS then you need to disable Always use https This is because the https/SSL certificate is handled by Noloco when you configure your domain as described above.

Your domain won't verify

It's important to wait for 30 minutes or for up to 48 hours for DNS records to propagate. If you check less than the required time, you may not see the changes applied.

Transfer domain to another app

If you want to use your custom domain for another app, simply set up the domain settings for that app and then remove the domain settings for the previous app. Noloco will manage the switch for you. However, you might need to wait again up to 24 hours before the changes take effect.

Using a normal domain vs a subdomain

If you're not using a subdomain you might find it trickier to setup your custom domain. Usually we recommend using a custom domain.

Last updated