The upstream is a core building block of SaaS Custom Domains.
In short, upstream is a server that receives requests forwarded from custom domains. This is usually your application server.
Creating an upstream
On the main dashboard, click the New Upstream button. The pop-up will appear:
The most important part of the upstream is its Host. As the name says, this is the URL where your application is hosted, e.g. app.mydomain.com.
There are additional upstream options
Port — port at which you want to receive traffic from custom domains. The default value is 443 for the HTTPS traffic.
TLS — enable encrypted communication to your upstream. It's enabled by default.
Bubble.io — enable if your upstream is a Bubble.io application. This is required for custom domains to work for Bubble.io apps. It's disabled by default.
Let's fill in the host and click the Create Upstream button.
Your upstream will be created and you'll be redirected to the upstream page:
That's it! Now we can start creating custom domains for this upstream.
Once you create custom domains, and the requests start coming to these domains, we'll handle the traffic from those domains and forward the traffic to your upstream.
To learn about custom domains, read our Custom Domains 101 Guide.
Until next time, keep building!
Need more help? Reach out via the Intercom chat widget and we'll be right with you!