1. Help Center
  2. Technical
  3. ➕ Setting up hosting for your Foleon Docs

Quick guide to hosting Foleon Docs

Every Foleon Doc needs to live on its own URL. You have 2 options for hosting your content: using a (free) Foleon domain or your own custom domain. In this article, we'll discuss these 2 options and how they shape the URL of your live Foleon Doc.

💡 Already know that you're hosting on a custom domain? Check out our article Hosting on a custom domain.

Hosting decisions to make

To help you quickly understand which hosting decisions you need to make, we've created this handy infographic to get you started. 

Group 979

1. Decide on a domain:

  • Use a (free) Foleon domain
    If you want to host your content on a free domain, you can select the Use a (free) Foleon domain option. For this option, "foleon" will always be included in the URL.
    If you choose this option, your domain is automatically secured for free, and you do not need to take any other steps.
  • Custom (sub)domain
    Host your content on a custom domain you set up with your hosting provider (e.g., ebook.yourdomain.com). Costs will depend on your hosting provider.

2. Custom domain setup with your hosting provider

First, decide on a domain name. This can be a subdomain (e.g., ebook.yourdomain.com) or a root domain (e.g., www.yourdomain.com).

Once you’ve chosen your domain name, you’re ready to configure your domain in the DNS settings of your hosting provider. 

  • Regular setup
    Go to your domain provider's DNS settings and point a CNAME record to our servers at s1.foleon.com. After that, set up your domain in account settings > domains.
  • With a reverse proxy
    If your hosting setup requires a reverse proxy, link your domain to an intermediate (like Cloudflare), so that the intermediate can point to our servers at s1.foleon.com. With this setup, you must manually add an SSL/TLS certificate to secure your content.

⚠️ Don’t check the reverse proxy checkbox in the platform unless you’re sure it matches your hosting setup. If you wrongly select it, you’ll encounter issues securing your domain.


3. SSL/TLS certificate

If you're hosting your content on a custom domain, secure it with an SSL/TLS certificate to ensure it's safe for your audience. You have two options:

Where to manage your domain setup

In the dashboard, go to the project for which you want to set up the hosting. In project settings, scroll down to your domain setup. You will see the two options discussed in this article: using a (free) Foleon default domain or your own custom domain.

Image1 (1)

If you choose a custom domain, click  + create new domain

💡Configuring a new domain used to be part of the project settings. 

Image2 (1)

 

Use a (free) Foleon domain

If you want to host your content on a free domain, you can select the Use a (free) Foleon domain option. For this option, "foleon" will always be included in the URL.

💡 The (free) Foleon domain is automatically secured.

Image3 (1)

By default, your Foleon Doc will then live on the following URL:

https://account-alias.foleon.com/project-alias/foleon-doc-alias/page-alias

💡 Note that for single-page Docs, as well as for the first page of multi-page Docs, the URL will not display the page alias. This is done for simplicity and to make the Doc URL cleaner and easier to remember. This doesn’t affect the option to share that page.

To better understand this URL and how it's made up, we go over the different components below:

  • https:// — The default hostname is always secured with SSL/TLS.

  • account-alias — The account alias is a hyphenated version of the company name you enter when creating an account. If you want to change your account alias, please contact support@foleon.com. Keep in mind that changing this will affect all of your Foleon Docs in your account.

  • foleon.com — Foleon Docs live on our domain by default. Depending on your plan, you can also choose to publish on a custom domain instead.

  • project-alias — The project alias is a hyphenated version of the name of the project a Foleon Doc lives in. You change it through a project's settings, but keep in mind that changing this will affect all Foleon Docs within that project.

  • foleon-doc-alias — The Foleon Doc alias is a hyphenated version of a Foleon Doc name. You can change it through a Foleon Doc's settings. It needs to be unique within a project.

  • page-alias — The page alias is a hyphenated version of a page name. You can change it through a page’s settings.

💡 The Foleon Doc alias and page alias allow you to link to specific Foleon Docs and pages. Make sure you include these in the URLs you share.

Let’s talk about what happens when, for whatever reason, any part of this URL is incorrect or missing:

  • account-alias — If the account alias is incorrect, visitors will be prompted with a Foleon 404 page.

  • foleon.com — If the domain is incorrect, visitors will be prompted with a browser error page.

  • project-alias — If the project alias is incorrect or missing, visitors will be prompted with a Foleon 404 page.

  • foleon-doc-alias — If the Foleon Doc alias is incorrect or missing, visitors will be directed to the most recent published Foleon Doc within the project. Alternatively, they will be directed to the primary Foleon Doc.

  • page-alias — If the page alias is incorrect or missing visitors will be redirected to the first page of the Foleon Doc.

Use your own custom domain

Alternatively, you can choose to publish on a custom domain instead.

📖 Want to learn how to set up your own custom domain? Read all more in our article Hosting on a custom domain.

Image4 (1)

This can be a subdomain or a domain you have set up with your hosting provider. Either way, URLs will look something like this:

http(s)://your-subdomain.your-domain.your-top-level-domain/foleon-doc-alias/page-alias

To better understand this URL and how it's made up, we go over the different components below:

  • http(s):// — Depending on the protocol of your domain Foleon Docs will either live on HTTP or HTTPS. To secure your domain, making it "HTTPS", you can install a SSL/TLS certificate in the project settings. Read more about securing your domain in our article How we generate an SSL/TLS certificate for you.

  • your-subdomain.your-domain — You can either publish on a subdomain or root domain. Read more about using a custom domain in our article Hosting on a custom domain.

  • your-top-level-domain — You can publish on any top-level domain (e.g. .com/.nl/.de).

  • base path (optional) — You can decide the add a base path to structure your URL. If you want to use one domain for multiple projects, this is required for a successful setup. Learn more in our article Hosting on a custom domain. 
  • foleon-doc-alias — The Foleon Doc alias is a hyphenated version of a Foleon Doc name. You can change it in the Foleon Doc settings.

  • page-alias — The page alias is a hyphenated version of a page name. You can change it in the page settings.

Let’s talk about what happens when, for whatever reason, any part of this URL is incorrect or missing:

  • http(s):// — What happens when a visitor navigates to HTTP/HTTPS is based on your domain’s protocol. To secure your domain, making it "HTTPS", you can install a SSL/TLS certificate in the project settings. Read more about securing your domain in our article How we generate an SSL/TLS certificate for you.

  • your-subdomain.your-domain.your-top-level-domain — If any of these are incorrect or missing, visitors will be prompted with a browser error page.

  • foleon doc-alias — If the Foleon Doc alias is incorrect or missing, visitors will be directed to the most recent published Foleon Doc within the project. Alternatively, they will be directed to the primary Foleon Doc.

  • page-alias — If the page alias is incorrect or missing, visitors will be redirected to the first page of the Foleon Doc.