Domain Configuration | Axero Documentation

Introduction

When you create your Axero intranet site, selecting the right domain affects your site's accessibility, branding, and user experience. This guide explains the available domain options and how each one is configured.

Overview

• Introduction
• Domain Options Comparison
• Axero Subdomain Configuration
• Custom Subdomain Configuration
• Custom Domain Configuration
• Accessing Domain Configuration
• Troubleshooting
• Additional Resources
• Support and Feedback

Domain Options Comparison

You have three options when choosing your domain:

1. Axero Subdomain (e.g., yourcompany.axero.io): A subdomain of axero.io that is fully managed by Axero. This is the quickest option to get started.
2. Custom Subdomain (e.g., intranet.yourdomain.com): A subdomain of your existing domain dedicated to your intranet site.
3. Custom Domain (e.g., yourintranetname.com): A dedicated root domain exclusively for your intranet.

Axero Subdomain Configuration

Choosing an Axero subdomain is the quickest way to get your site created and ready to build. Axero manages all DNS and SSL configuration, so no technical setup is required on your end.

Setup Process

1. Choose a memorable subdomain (e.g., yourcompany.axero.io).
2. Contact your Technical Account Manager with your chosen subdomain. The team will initiate the site creation process and personalize your site based on your launch requirements.

After setup is complete, you will receive secure login credentials from your Technical Account Manager.

Custom Subdomain Configuration

A custom subdomain uses your existing domain (e.g., intranet.yourdomain.com) to provide a branded experience. Axero manages SSL certificate renewals and site hosting. You are responsible for domain renewal and DNS record maintenance.

Common Subdomain Prefixes

• my.yourdomain.com
• hub.yourdomain.com
• portal.yourdomain.com

Setup Process

1. Configure DNS records. Create the subdomain in your domain provider and point it to the Axero servers:

   Region	Record Type	Value
   US	A Record	20.22.83.75
   EU	CNAME Record	AXERO-EU-ALB-1931466378.eu-north-1.elb.amazonaws.com

2. Verify DNS propagation. Confirm that your DNS records have propagated using nslookup or a public DNS checker such as whatsmydns.net. Propagation can take up to 48 hours.
3. Contact Axero. Notify your Technical Account Manager of the subdomain you selected. The team will initiate the site creation process.
4. Complete SSL certificate generation. After Axero sets up your site, you will receive DNS records needed to generate an SSL certificate. Add these records to your DNS provider. The certificate will remain valid as long as the records stay in place. Axero handles all SSL configuration and renewals.

   Tip: If your organization already has a wildcard SSL certificate for your domain (e.g., *.yourdomain.com), you can provide it to Axero instead of generating a new certificate. A wildcard certificate covers all subdomains under your main domain, which simplifies certificate management if you use multiple subdomains. Contact your Technical Account Manager to coordinate wildcard certificate installation.

After setup is complete, your Technical Account Manager will personalize your site based on the information gathered during your Kickoff session and provide you with secure access credentials.

Custom Domain Configuration

A dedicated domain (e.g., yourintranetname.com) creates a unique, professional location for your intranet. This option provides maximum branding flexibility and a completely independent web presence. Axero manages SSL certificate renewals and site hosting. You are responsible for domain purchase, renewal, and DNS record maintenance.

Setup Process

1. Purchase and configure the domain. Point the root domain to the Axero servers:

   Region	Record Type	Value
   US	A Record	20.22.83.75
   EU	A Record	13.53.84.230

2. Verify DNS propagation. Confirm that your DNS records have propagated using nslookup or a public DNS checker such as whatsmydns.net. Propagation can take up to 48 hours.
3. Contact Axero. Notify your Technical Account Manager of the domain you selected. The team will initiate the site creation process.
4. Complete SSL certificate generation. After Axero sets up your site, you will receive DNS records needed to generate an SSL certificate. Add these records to your DNS provider. The certificate will remain valid as long as the records stay in place. Axero handles all SSL configuration and renewals.

After setup is complete, your Technical Account Manager will personalize your site based on the information gathered during your Kickoff session and provide you with secure access credentials.

Accessing Domain Configuration

Once your site is set up, you can view your domain configuration through the Axero Control Panel. Navigate to Control Panel > System > Domain Configuration.

Troubleshooting

DNS Issues

DNS changes are not taking effect

DNS changes can take 24 to 48 hours to propagate globally. During this time, some users may see the old configuration while others see the new one. If your site is not accessible after 48 hours, verify that the DNS records match the values listed in this guide using nslookup or a public DNS checker.

Incorrect record type

Use A records for all root domains and US subdomains. EU customers should use CNAME records for subdomains only.

Conflicting records

Remove any existing A or CNAME records for the same hostname that point to different locations. Conflicting records can cause intermittent connectivity issues.

Subdomain conflicts

Ensure the subdomain is not already in use for other services (e.g., email, marketing landing pages). Existing records for the same subdomain will conflict with the Axero DNS entry.

TTL settings

Lower TTL values (300 to 3600 seconds) allow for faster DNS updates. If you plan to make DNS changes, reduce the TTL in advance to minimize downtime during the transition.

SSL Certificate Issues

Certificate validation fails

DNS records must be in place and fully propagated before SSL certificate generation can complete. Verify that the records match exactly and that no conflicting records exist.

Mixed content warnings

Ensure all resources (images, scripts, stylesheets) on your site use HTTPS URLs. Mixed HTTP/HTTPS content triggers browser warnings.

Certificate renewal

Axero handles automatic SSL certificate renewal. However, the DNS records provided during initial setup must remain unchanged. Removing or modifying these records will prevent renewal.

Additional Resources

• After configuring your domain, review Content Security Policy (CSP) to control which external sources your platform can load resources from.
• For security best practices related to login, sessions, and access control, see Site Security Best Practices.

Support and Feedback

If you need assistance with domain configuration or are planning a domain change for an active site, submit a support case. Domain changes for live sites require coordination with the Axero team to minimize disruption to your users.