Custom Domain Setup — docs.starshadow.com¶

This page documents the custom domain configuration for the Starshadow Minecraft documentation site.

DNS Configuration ✅¶

The DNS CNAME record has been configured and is active.

GitLab Pages Configuration¶

To enable the custom domain in GitLab:

1. Navigate to starshadow/stsh-gitlab-mc-docs → Settings → Pages
2. Click New Domain
3. Enter docs.starshadow.com
4. GitLab will auto-provision a TLS certificate via Let's Encrypt
5. Verify the domain responds at https://docs.starshadow.com

TLS¶

TLS is auto-provisioned by GitLab using Let's Encrypt. No manual certificate management is required.

Fallback URL¶

The site is also available at the default GitLab Pages URL:

• https://starshadow.gitlab.io/stsh-gitlab-mc-docs/

Cross-Project Triggers¶

Each source repository triggers a documentation rebuild when docs change:

# In each repo's .gitlab-ci.yml
trigger-docs:
  stage: pages
  trigger:
    project: starshadow/stsh-gitlab-mc-docs
    branch: main
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
      changes:
        - docs/**/*
        - README.md
        - CHANGELOG.md

This ensures the unified site stays current when any source repo updates its documentation.