infra.page

Custom Domains

Map custom domains to your infrapage pages for a branded experience.

Custom Domains

infrapage supports custom domain mapping, allowing you to serve any page on your own domain. For example, instead of yourserver.com/p/my-project, visitors can access your dashboard at status.myproject.com.

How It Works

Custom domains work through a middleware layer that:

  1. Checks the incoming request's Host header
  2. Looks up a page associated with that domain in MongoDB
  3. If found, serves that page's content directly at the root path (/)
  4. If not found, processes the request normally

Setup

1

Configure DNS

Point your custom domain to your infrapage server. Create a CNAME or A record:

status.myproject.com  CNAME  infrapage.example.com

Or with an A record:

status.myproject.com  A  203.0.113.50
2

Set the Domain in Page Settings

Open the page editor for the page you want to map. In the page settings, enter the custom domain (e.g., status.myproject.com).

infrapage will verify that the domain's DNS resolves to the server before saving.
3

Configure TLS (Recommended)

For HTTPS, set up a reverse proxy (like Caddy or nginx) in front of infrapage that handles TLS termination for your custom domain.

**Caddy** makes this especially easy with automatic HTTPS:

status.myproject.com {
        reverse_proxy infrapage:8080
    }

Multiple Domains

Each page can have one custom domain. Different pages can have different custom domains, allowing you to serve multiple branded dashboards from a single infrapage instance.

Removing a Custom Domain

To remove a custom domain mapping, clear the domain field in the page settings. The page will continue to be accessible at its original /p/slug URL.

Navigation