Configure a custom domain

By default, your octoja instance uses its octoja address. A custom domain, such as rmm.yourdomain.com, lets users open it through your own address instead.

Your custom domain and its CNAME record do not determine which source IPs octoja uses to contact your integrations or SMTP server. For these IP allowlists, see IP addresses and firewall rules.

Prerequisites

• You are a member of an administrator group. Only administrators can change this setting.
• You can edit the DNS records for the domain.

Steps

1. Open Settings → Custom Domain.
2. Enter the complete hostname without https://, for example rmm.yourdomain.com.
3. Click Save domain under Configure domain. The Check button appears once the domain has been saved.
4. Copy Type (CNAME), Name and Target from DNS Setup Required into a new CNAME record at your DNS provider.
5. Wait for your DNS provider to publish the change, then click Check. octoja reports whether the domain is reachable.
6. Open the custom domain in a browser and check the sign-in page.

To return to the octoja address, click Remove, then Save domain. Removal takes effect only after saving.

FAQ

The check succeeds, but my domain returns HTTP 404. What now?

Open your instance's original octoja address for comparison. If it works while the custom domain keeps returning 404 despite a correct CNAME and saved setting, contact support. Include both hostnames, the time and the error status so the domain mapping can be checked. A successful check does not replace opening the sign-in page in a browser.