> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Domain Setup

> Configure your own domain name for your Members Portal to provide a seamless branded experience for your members.

## Overview

Custom domain setup allows you to use your own domain name (like `members.mydomain.com`) for your Members Portal instead of the default Nexudus subdomain. This provides a more professional, branded experience for your members and maintains consistency with your overall brand identity.

## Purpose

By default, your Members Portal is accessible through a Nexudus subdomain (like `yourspace.nexudus.site`). Custom domains solve several business challenges:

* **Brand consistency**: Keep your members within your brand ecosystem rather than directing them to a third-party domain
* **Professional appearance**: Custom domains appear more trustworthy and established to potential members
* **SEO benefits**: Domain authority remains with your organization
* **Member confidence**: Members feel more secure accessing services through your own domain

This feature is primarily designed for coworking operators who want to maintain their brand identity throughout the entire member experience.

## Setup Process

<CardGroup cols={2}>
  <Card title="Basic Setup" icon="globe" href="#basic-configuration">
    Configure domain name and basic settings through the dashboard interface.
  </Card>

  <Card title="SSL & DNS Configuration" icon="shield-check" href="#ssl-and-dns-verification">
    Set up SSL certificates and configure DNS records for domain verification.
  </Card>
</CardGroup>

### Basic Configuration

<Steps>
  <Step title="Access Domain Settings">
    Navigate to **[Settings > Website > Domain](https://dashboard.Nexudus.com/settings/2/0/6)** in your dashboard to begin custom domain configuration.
  </Step>

  <Step title="Add Domain Details">
    * **Name**: Internal reference name for the domain (not visible to users) - **Domain**: Your custom domain URL (e.g.,
      `members.mydomain.com`) -**Active status**: Toggle to enable/disable the domain The domain automatically includes SSL
      proxy functionality when created.
  </Step>

  <Step title="Save Configuration">
    Save your domain configuration to begin the verification process. The system will start checking DNS configuration and SSL certificate requirements.
  </Step>
</Steps>

## SSL and DNS Verification

The setup process differs depending on your Nexudus hosting configuration:

<Tabs>
  <Tab title="Portal version 5 or above">
    For locations running on version 5 of the members portal, the system provides automated SSL certificate generation and detailed DNS configuration guidance.

    #### DNS Configuration Requirements

    Once you save your domain, the system displays the required DNS records:

    | Record Type | Name/Host                                      | Value/Points to                   |
    | ----------- | ---------------------------------------------- | --------------------------------- |
    | **CNAME**   | Your subdomain (e.g., `members`)               | Value provided by the system      |
    | **A**       | `@` or your apex domain (e.g., `mydomain.com`) | IP address provided by the system |

    <Warning>
      DNS records must match exactly as provided. Any discrepancies will prevent SSL certificate generation and domain
      verification.
    </Warning>

    #### SSL Certificate Process

    The system automatically handles SSL certificate generation through this workflow:

    1. **DNS Verification**: System checks that your DNS records point correctly to Nexudus servers
    2. **Certificate Request**: Automatic SSL certificate request is initiated
    3. **Certificate Issuance**: Certificate is generated and deployed
    4. **Domain Activation**: Your custom domain becomes fully functional

    The verification process typically takes a few minutes to several hours, depending on DNS propagation times.

    #### Status Monitoring

    The interface provides real-time status updates:

    * **Domain Status**: Shows whether DNS records are properly configured
    * **SSL Certificate Status**: Indicates certificate generation progress
    * **Ready to Use**: Confirmation when the domain is fully operational
  </Tab>

  <Tab title="Members Portal version 1 to 4">
    For locations running earlier versions of the members portal, additional coordination with Nexudus support is required before domain setup.

    <Info>Contact [support@Nexudus.com](mailto:support@Nexudus.com) before attempting to add custom domains on legacy hosting to ensure proper SSL certificate provisioning.</Info>
  </Tab>
</Tabs>

### Troubleshooting Common Issues

* **Certificate Pending**: Usually indicates DNS records are not yet properly configured or propagated
* **Domain Misconfigured**: DNS records don't match the required values exactly

<Tip>
  Use `nslookup`, `ping` or online DNS checking tools to verify your DNS records are properly configured before
  contacting support.
</Tip>