Skip to main content

Bring your own domain

Each tunnel gets an assigned FQDN based on your tunnel ID (e.g., <tunnel-id>.tun.cruma.io). To use your own domain, add a CNAME and include that hostname in your target.

Add the CNAME​

Create a CNAME in your DNS provider pointing to the tunnel FQDN:

app.yourdomain.com CNAME <tunnel-id>.tun.cruma.io.

Use it in a target​

Add the custom hostname to your target (CLI example):

cruma-tunnel-ui http --target 127.0.0.1:3000 --tunnel-id demo-tunnel --secret-key beta-secret-123 --hostnames app.yourdomain.com

Or in a config file:

tunnel_id: "demo-tunnel"
tunnel_secret: "beta-secret-123"

targets:
  - destination: "127.0.0.1:3000"
    kind: http
    hostnames:
      - "react-dev"
      - "app.yourdomain.com"

Once DNS propagates, your custom hostname will resolve through the tunnel just like the assigned address.

TLS for custom hostnames terminates on your agent/backend; configure a valid certificate there. Cruma-managed TLS termination applies only to the *.cruma.io hostnames.