Skip to content

DNS records

Pipebase serves three sub-domains by default:

HostContainerPurpose
designer.<root>pipebase-designerVisual editor + REST API
runtime.<root>pipebase-runtimePublic HTTP triggers + management API
docs.designer.<root>pipebase-docsThis site

Replace <root> with whatever you put in ROOT_DOMAIN.

Add a single record at your DNS provider:

*.example.com A <your-server-ip> 300

That covers all three sub-domains plus any future ones (e.g. when you provision additional runtimes via the Environments page).

If your DNS provider doesn’t support wildcards at the root, add a wildcard at the second level:

*.example.com A <ip>
*.designer.example.com A <ip>

The second wildcard is what makes docs.designer.example.com resolve.

If you’d rather list every host explicitly:

designer.example.com A <ip> 300
runtime.example.com A <ip> 300
docs.designer.example.com A <ip> 300

You’ll need to add records for any additional runtimes you provision (e.g. dev.example.com, stag.example.com).

If the default <service>.<root> pattern doesn’t fit your DNS layout, override per-service:

Terminal window
# In .env
ROOT_DOMAIN=example.com
DESIGNER_HOST=pipebase.example.com
RUNTIME_HOST=api.example.com
DOCS_HOST=help.example.com

The Traefik labels in docker-compose.yml read these and route accordingly.

After your records propagate:

Terminal window
dig +short designer.<your-root>
dig +short runtime.<your-root>
dig +short docs.designer.<your-root>

All three should return your server’s public IP. If they return empty or NXDOMAIN, give DNS a few minutes — most providers update inside 60 seconds, but TTL caches can hold for hours.