Skip to main content

Add a Custom Domain + SSL

This guide shows you how to use your own domain name on Fransys. The SSL certificate is generated and renewed automatically — you only need to configure your DNS.

Prerequisites​

  • A deployed application block online on Fransys
  • A domain name that you own
  • Access to your domain's DNS management (at your registrar or DNS provider)

Step 1 — Get the Fransys URL​

Open your application block's configuration. In the Ingress section, note the auto-generated URL at *.fransysapp.com. This is the address you'll use as the DNS target.

Step 2 — Configure your DNS​

At your registrar or DNS provider, add a record pointing to Fransys:

Create a CNAME record:

TypeNameValue
CNAMEapp (or www, api, etc.)your-url.fransysapp.com

Example: for app.mydomain.com, create a CNAME app pointing to your Fransys URL.

For a root domain (apex)​

CNAME records are not supported on root domains (e.g., mydomain.com without a subdomain). Depending on your DNS provider:

  • If your provider supports ALIAS/ANAME (Cloudflare, Route53, etc.) — Create an ALIAS record pointing to your Fransys URL
  • Otherwise — Use a subdomain (www.mydomain.com) and set up a redirect from the root domain

Step 3 — Add the domain in Fransys​

In your block's Ingress configuration, add your custom domain. Fransys takes it into account immediately.

Step 4 — Wait for DNS propagation​

DNS propagation can take from a few minutes to 48 hours depending on your provider. Once propagation is complete:

  1. Fransys automatically detects that the domain points to your block
  2. An SSL certificate is generated automatically via Let's Encrypt
  3. HTTPS is enabled automatically
  4. The certificate will be renewed automatically before expiration

Verify everything works​

Open your domain in a browser:

  • The SSL padlock should be present
  • Your application page should display
  • The URL should be https://

Multiple domains​

You can add multiple domains to the same block. Each domain receives its own SSL certificate, always automatically.

tip

Use the *.fransysapp.com domain for your development and staging environments — it's available instantly, without DNS configuration. Reserve your custom domain for production.

→ Learn more: Domains and SSL