domains

Custom Domains

Connect your own domain to a Runix deployment with automatic TLS.

Every web service gets a default subdomain on `runixcloud.dev`. You can also connect your own domain for a professional URL. TLS certificates are provisioned automatically.

Adding a Custom Domain#

Add the domain in Runix

Use the CLI or dashboard to register your domain with a service:

bash

$ runix domains add api api.myapp.com
✓ Added domain: api.myapp.com

Set up DNS

In your DNS provider (Cloudflare, Namecheap, Route53, etc.), create a CNAME record:

Type	Name	Value	TTL
CNAME	`api`	`runixcloud.dev`	Auto / 300

For root/apex domains (e.g., `myapp.com` without a subdomain), some DNS providers support CNAME flattening or ALIAS records. Check your provider's documentation.

Wait for verification

Runix automatically verifies your DNS records. This usually takes a few minutes. Check the status:

bash

$ runix domains list api
DOMAIN                         VERIFIED   SSL
api.myapp.com                  ✓          ✓

Done

Once verified, your domain is live with automatic HTTPS. The TLS certificate is managed by Caddy and renews automatically.

DNS Setup by Provider#

1.Go to your domain's DNS settings
2.Click "Add record"
3.Type: CNAME, Name: your subdomain (e.g., `api`), Target: `runixcloud.dev`
4.Set Proxy status to "DNS only" (grey cloud) for TLS to work correctly
5.Click Save

If using Cloudflare proxy (orange cloud), you may encounter TLS conflicts. Use DNS-only mode for Runix domains.

Removing a Domain#

bash

$ runix domains remove api api.myapp.com
✓ Removed domain: api.myapp.com

After removing a domain from Runix, also delete the CNAME record from your DNS provider.

Troubleshooting#

Issue	Solution
Domain stuck on "pending"	Check that your CNAME record points to `runixcloud.dev` and DNS has propagated (can take up to 48 hours)
SSL not provisioning	Make sure the CNAME is correct and not behind a proxy (Cloudflare orange cloud)
ERR_TOO_MANY_REDIRECTS	Disable Cloudflare's "Always Use HTTPS" for this domain, as Runix handles TLS

Custom domains require a Starter plan or higher. Hobby plan users can only use the default `runixcloud.dev` subdomain.

Instance Types

Networking