Custom domains for Gemfury repositories βeta

DNS provider setup examples

After adding your custom domain to your Gemfury account, you need to create DNS records with your domain provider to point your domain to Gemfury. This guide shows how to create CNAME records on popular DNS providers.

What you need to configure

For each subdomain you want to use (like repo.yourcompany.com), you’ll need to create a CNAME record that points to a “target” domain generated for you:

example-target.furyns.com.

For example, if you want to use repo.example.com, you would create:

Record Type Name/Host Target/Value
CNAME repo example-target.furyns.com.

Note: Some DNS providers require the trailing dot (.) at the end of the target, while others add it automatically. Check your provider’s documentation.

Cloudflare

  1. Log into your Cloudflare dashboard
  2. Select your domain from the list
  3. Go to the DNS section
  4. Click Add record
  5. Configure the record:
    • Type: CNAME
    • Name: Your subdomain (e.g., repo)
    • Target: example-target.furyns.com
    • Proxy status: DNS only (gray cloud icon)
    • TTL: Auto
  6. Click Save

Important: Ensure the proxy status is set to “DNS only” (gray cloud). Orange cloud proxying will interfere with package manager authentication.

AWS Route 53

  1. Open the Route 53 console
  2. In the navigation pane, choose Hosted zones
  3. Select your domain’s hosted zone
  4. Click Create record
  5. Configure the record:
    • Record name: Your subdomain (e.g., repo)
    • Record type: CNAME
    • Value: example-target.furyns.com
    • TTL: 300 (or your preference)
    • Routing policy: Simple routing
  6. Click Create records

Google Cloud DNS

  1. Go to the Cloud DNS page
  2. Select your DNS zone
  3. Click Add record set or Add standard
  4. Configure the record:
    • DNS Name: Your subdomain (e.g., repo)
    • Resource Record Type: CNAME
    • TTL: 300 (or your preference)
    • Canonical name: example-target.furyns.com.
  5. Click Create

DigitalOcean

  1. Log into the DigitalOcean Control Panel
  2. Navigate to Networking → Domains
  3. Select your domain
  4. In the Create new record section:
    • Type: CNAME
    • Hostname: Your subdomain (e.g., repo)
    • Will direct to: example-target.furyns.com.
    • TTL: 3600 (or your preference)
  5. Click Create Record

Squarespace Domains

  1. Log into your Squarespace account
  2. Go to Settings → Domains
  3. Click on the domain you want to configure
  4. Click DNS Settings
  5. Scroll to the Custom Records section
  6. Click Add Record
  7. Configure the record:
    • Type: CNAME
    • Host: Your subdomain (e.g., repo)
    • Data: example-target.furyns.com
    • Priority: Leave blank
  8. Click Add

Verifying your DNS setup

After configuring your DNS records, it may take a few minutes to several hours for changes to propagate. You can verify your setup using the dig command:

$ dig repo.yourcompany.com +nostats +nocomments +nocmd
repo.yourcompany.com.  3554  IN  CNAME  example-target.furyns.com.

If the CNAME record appears in the output, your DNS is configured correctly.

DNS propagation typically takes 5-30 minutes but can take up to 48 hours in some cases. If you don’t see the CNAME record immediately, wait a bit and try again.