mirror of
https://github.com/noodlapp/noodl-docs.git
synced 2026-01-11 14:52:54 +01:00
53f0d6320e
Co-Authored-By: kotte <14197736+mrtamagotchi@users.noreply.github.com> Co-Authored-By: mikaeltellhed <2311083+mikaeltellhed@users.noreply.github.com> Co-Authored-By: Tore Knudsen <18231882+torekndsn@users.noreply.github.com> Co-Authored-By: Michael Cartner <32543275+michaelcartner@users.noreply.github.com>
96 lines
4.1 KiB
Markdown
96 lines
4.1 KiB
Markdown
---
|
|
title: Deploying to Custom Domain
|
|
hide_title: true
|
|
---
|
|
|
|
# Deploying to your custom domain
|
|
|
|
## What you will learn in this guide
|
|
|
|
This guide will take you through the steps needed for deploying a Noodl app to your own custom domain. Note that the app is still hosted by Noodl, but you let your custom domain point to the app. If you want to host the backend and frontend yourself check out the [Using a self hosted backend](/docs/guides/deploy/using-an-external-backend) and [Hosting Frontend](/docs/guides/deploy/hosting-frontend).
|
|
|
|
:::note
|
|
To be able to follow this guide you must have custom domain feature enabled. This is not available in the free Noodl plan. But you can request a trial [here](https://noodl.net/plans).
|
|
:::
|
|
|
|
## Overview
|
|
|
|
The guide walks you through the following topics
|
|
|
|
- Acquiring a domain
|
|
- Deploying to your acquired custom domain
|
|
- Managing your custom domain deployments
|
|
|
|
You can also check out the video below that walks through all deployment options in Noodl, including deploying to a Custom Domain:
|
|
|
|
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/M97-89RiboE" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen></iframe>
|
|
|
|
## Acquiring your domain
|
|
|
|
The first thing you need to do is to acquire the domain, i.e. purchase it from a domain provider if you don't have it already. There are many different places where you can acquire a domain and they all work a little differently. The important thing is that you need to be able to configure the DNS records and especially set a [CNAME](https://en.wikipedia.org/wiki/CNAME_record) record. You will need this later.
|
|
|
|
## Deploying to you domain
|
|
|
|
Once you have acquired the domain, click the **Deploy application** icon in the top right corner.
|
|
|
|
<div className="ndl-image-with-background s">
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Then select the **Custom Domains** tab.
|
|
|
|
<div className="ndl-image-with-background l">
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Click **Manage Domains**. This allows you to add a new custom domain.
|
|
|
|
<div className="ndl-image-with-background xl">
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Enter the name of the domain you want to deploy to, including the subdomain. Note that Noodl does not support naked domains (e.g. `mydomain.com`) so you will have to add a subdomain, for example `www.`.
|
|
Click **Add Domain**. Noodl will now try to connect to the domain which will always fail the first time. You need to set up a CNAME record in the DNS on your domain providers side that matches Noodl.
|
|
|
|
Copy the value in the **Value** box (`proxy-ssl.noodl.cloud`). You will need to provide when you create the CNAME record on the domain side.
|
|
|
|
<div className="ndl-image-with-background l">
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Create the CNAME record in the DNS at your domain provider. Once that's done, click "Verify Connection" to see if Noodl can coonect.
|
|
|
|
?> Note that it could take some time - up to several hours - for your domain provider to propertly update the DNS records so if Noodl cannot verify the domain, try again in a few minutes or hours.
|
|
|
|
Once the domain has been verified you will see the green **Connected** text.
|
|
|
|
<div className="ndl-image-with-background l">
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Now your domain is available to deploy to. So close the **Manage Domains** popup.
|
|
|
|
You can now choose your newly added domain as a target. Make sure to also pick the backend you want to use in the deploy.
|
|
|
|
<div className="ndl-image-with-background l">
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Press **Create Deploy** and your new deployment is ready.
|
|
|
|
## Managing your custom deployments
|
|
|
|
Once you have added your custom domain and deployed to it you can updated it whenever you like, delete it or update which backend it uses.
|