Skip to main content

Connect Your Cloudflare Account

Connect your Cloudflare account to CycleDNS to start managing your DNS zones dynamically. This integration allows CycleDNS to automatically update your DNS records when your IP address changes.

Prerequisites​

Before connecting your Cloudflare account, ensure you have:

  • A Cloudflare account with active DNS zones
  • Zone Edit permissions for the domains you want to manage
  • API Token with appropriate permissions (we'll help you create this)

Step 1: Create a Cloudflare API Token​

  1. Go to Cloudflare Dashboard
  2. Click "Create Token"
  3. Use "Custom token" template
  4. Configure the following permissions:
    • Zone:Zone:Read - Read access to all zones
    • Zone:DNS:Edit - Edit access to DNS records
  5. Zone Resources: Include all zones or specific zones you want to manage
  6. Client IP Address Filtering: Leave empty
  7. TTL: Leave empty so it will always work unless you delete it
  8. Click "Continue to summary" and "Create Token"

Step 2: Access Provider Integration​

  1. Log in to your CycleDNS dashboard at dash.cycledns.com
  2. Navigate to "Settings" → "Integration"
  3. Click "Add DNS Provider"

Step 3: Connect Your Account​

  1. Select Cloudflare in Provider dropdown
  2. Set a descriptive name for the integration, for example, "My Token" in the Description field
  3. Paste your Cloudflare API token in the Token field
  4. Click "Save Changes"

Step 4: Verify Integration​

After connecting, you should see:

  • The descriptive name where you can click to expand and collapse
  • Available Domains: List of your Cloudflare zones

Managing Your Integration​

Sync new zones in CycleDNS​

If you need to sync new zones in CycleDNS:

  1. Navigate to "Settings" → "Integration"
  2. Click to expand the desired provider integration
  3. Click the refresh icon to Sync Domains

Updating API Token​

If you need to update your API token:

  1. Navigate to "Settings" → "Integration"
  2. Click to expand the desired provider integration
  3. Click the pencil icon to Edit Account
  4. Paste the new token and Save Changes
  5. Your existing zones will remain configured

Removing Integration​

To disconnect your Cloudflare account:

  1. Go to Settings → Integration
  2. Expand your desired Cloudflare integration
  3. Click the trash icon to "Remove Provider"
  4. Confirm the action - this will stop all DNS updates and remove all data related to removed integration which include hostnames, zones and the integration token

Security Considerations​

API Token Security​

  • Create a specific token only for CycleDNS platform
  • Never share your API token with others
  • Use minimal permissions - only what's needed

Troubleshooting​

Common Issues​

"Invalid API Token" Error

  • Verify the token is correct and not expired
  • Check that the token has the required permissions
  • Ensure the token has access to the zones you're trying to manage

"Zone Not Found" Error

  • Verify the zone exists in your Cloudflare account
  • Check that the zone is active (not paused)
  • Ensure your API token has access to the zone

"Permission Denied" Error

  • Verify your API token has DNS:Edit permissions
  • Check that the zone is not in a restricted state
  • Ensure your account has the necessary Cloudflare plan

Getting Help​

If you're experiencing issues:

  1. Review Cloudflare's API documentation
  2. Contact our support team with specific error messages
  3. Join our community for peer support

Next Steps​

Once your Cloudflare account is connected, you can:

  1. Set up your hosts
  2. Download desktop/console applications

Ready to continue? Let's set up your hosts next!