Hosting Config
exoSwap White Label Hosting Configuration
When using a whitelabel product you are using a common core of our exoSwap platform. When we build improvements and deploy updates to the platform it deploys to your individual hosting location.
We currently have deployment pipelines for both CLOUDFLARE and NETLIFY.
See the instructions below for how to setup and configure hosting for your customized front-end for exoSwap.
Only proceed with these configuration steps after you have a signed whitelabel agreement and have had a technical onboarding session with EXO operations staff.
CLOUDFLARE
For us to push code updates to your whitelabel instance in Clourflare, we need the following details:
CLOUDFLARE_PROJECT_NAME = (e.g. exoswap-frontend-prod)
CLOUDFLARE_ACCOUNT_ID = (e.g. 2dxx9998x9x921408585449224394bee)
CLOUDFLARE_API_TOKEN = ()
Cloudflare Deployment
To setup the deployment you can follow these instructions:
Log in to Cloudflare, click on Workers on the left-hand navigation panel
On the right hand side, collect the Account ID. It should look something like 2dxx9998x9x921408585449224394bee.
Click on Pages on the left-hand navigation panel.
Click Create a project > Direct Upload
For the project name use the suggested name above and click Create Project
You can ignore the next page, the Pages project is now set up.
Note down the Pages deployment URL for your DNS settings later. It will be the project name + pages.dev (e.g. exoswap-frontend-prod.pages.dev)
Click the user icon in the top right and choose My Profile
Click API Tokens and Create Token
Click Get Started next to Create Custom Token
For the token name, use EXO_CICD
Add 2 permissions:
Account, Cloudflare Pages, Read
Account, Cloudflare Pages, Edit
Select the Account
Click continue to summary and Create Token
Send us the project name, account ID, and API token details.
We will deploy the front end pages.
In anticipation you can now take that deployment URL (e.g. exoswap-frontend-prod.pages.dev)and go to your DNS and setup a friendly domain name (e.g. swap.exo.fi) by pointing your subdomain at the deployment URL.
See the DNS setup and how to do DNS name replication checking instructions at the bottom of this page.
Once you have the subdomain assigned in your DNS, you also need to configure it in Cloudflare.
Cloudflare Custom Domain
To add the custom domain in Cloudflare follow these instructions:
Log in to Cloudflare, click Pages on the left-hand menu
Select the deployment (e.g. exoswap-frontend-prod)
On the third tab to the right select "Custom domains"
Select the "Set up a custom domain"
Type in the friendly subdomain (e.g. swap.exo.fi) and click continue
If you are using Cloudflare DNS then follow those instructions, if you are using your own DNS like Namechaep or Godaddy click "Begin CNAME setup"
See instructions below for generic instructions on setting up CNAME in your DNS provider.
Use the DNSChecker instructions below to check that the subdomain is pointing at the Pages deployment URL
In Cloudflare, select the "Check DNS records"
It says this could take a while and you will be emailed when its completed. If you setup the subdomain in DNS earlier then its likely ready right away.
NETLIFY SETUP
For us to push code updates to your whitelabel instance in Netlify, we need the following details:
NETILFY_API_TOKEN = (e.g.kmicN7xK1QoZUlx3IQX5YuLuFdQ1xxCVW3Sk91rN1-x)
Netlify Deployment
To setup the deployment you can follow these instructions:
Log in to netlify.com, create a project but skip deploying anything.
Click the user icon, top right, and select users settings.
On the left menu, select Applications
Under Personal access tokens, push the "New access token" button.
For the token name, use EXO_CICD and generate token.
Copy the token to send to EXO Operations for the deployment pipeline.
We will deploy the front end pages.
In anticipation you can now take that deployment URL (e.g. exoswap-frontend-prod.pages.dev)and go to your DNS and setup a friendly domain name (e.g. swap.exo.fi) by pointing your subdomain at the deployment URL.
See the DNS setup and how to do DNS name replication checking instructions at the bottom of this page.
Once you have the subdomain assigned in your DNS, you also need to configure it in Cloudflare.
Netlify Custom Domain
To asssign a subdomain in Netlify and configure an SSL certificate follow these instructions:
Select the Netlify site and select Site Settings
On the meny in the left select Domain Management
Select "Add custom domain"
Select "Add subdomain" and give it the same URL you put in DNS.
At the bottom in the SSL section, select the DNS Validation
If you are having issues, please don't hesitate to reach out to your onboarding team in the Discord Channel that has been setup for your support.
DNS Configuration
Generic DNS subdomain setup
How Change DNS to add a subdomain for a root domain you already have. (e.g. swap.exo.fi)
Log into your DNS provider (e.g. Namecheap, Godaddy)
Go to the DNS management
New CNAME Record
Host = add your subdomain host name (e.g. swap)
Value = paste in the value from your Cloudflare Pages deployment (e.g. exofi -frontend-prod.pages.dev)
Set the TTL to 4 hours and Submit
DNS Replication Checking
Go to https://dnschecker.org
Paste in your project deployment URL (e.g. exoswap-frontend-prod.pages.dev.)
Select A and Search
Note the IP address (this is the server that Cloudflare or Netlify use to host your deployment)
Now paste in your friendly subdomain (e.g. swap.exo.fi)
Select A and Search
check that the IP address for the subdomain is the same as the project deployment
Change the A to CNAME and Search
Check that the results show the subdomain pointing to the URL for the project deployment
Last updated