DNS Providers
Getting Started
Connect your first DNS provider to Orkestia.
This guide walks you through connecting your first DNS provider to Orkestia.
Prerequisites
Before you begin, make sure you have:
- Orkestia Account - You must be logged into Orkestia with an organization
- DNS Provider Account - An active account with your chosen DNS provider
- Provider Credentials - API tokens, keys, or access credentials (varies by provider)
Provider-Specific Prerequisites
| Provider | Requirements |
|---|---|
| Cloudflare | Account with at least one zone, scoped API Token with Zone:Read and DNS:Edit |
| AWS Route 53 | AWS account with Route 53 hosted zones, existing AWS connection with Route 53 permissions |
| Google Cloud DNS | GCP project, service account with DNS admin permissions, service account key (JSON) |
| Vercel DNS | Vercel account, API token with DNS management permissions |
Adding Your First Connection
Navigate to DNS Connections
- From the Orkestia dashboard, click Connections in the sidebar
- In the DNS & CDN section, click the DNS Providers card
- Or navigate directly to
/connections/dns
View DNS Connections Page
On the DNS Connections page, you'll see:
- Connection Statistics - Active, pending, invalid connections, and total zones
- Connection List - All your DNS connections (empty if this is your first)
- Add Connection Button - Create a new DNS connection
Add Your First Connection
- Click the Add Connection button
- The connection wizard will open showing available DNS providers
- Select your DNS provider from the list
Choose Your Provider
Select the DNS provider you want to connect:
- Cloudflare - Best for CDN, DDoS protection, proxy features
- AWS Route 53 - Best for AWS infrastructure, existing AWS accounts
- Google Cloud DNS - Best for Google Cloud Platform users
- Vercel DNS - Best for Vercel deployments
Follow Provider Setup
- Enter Credentials - Provide the required authentication information
- Configure Settings - Set up provider-specific options (if applicable)
- Name Your Connection - Give it a descriptive name
- Create Connection - Submit the form
Each provider has different setup requirements. See Setup Methods for detailed instructions for each provider. DNS providers follow the same connect-once credential model as every other integration.
What Happens During Setup
When you create a DNS connection, Orkestia will:
- Validate Credentials - Test the authentication with your provider
- Check Permissions - Verify the credentials have required permissions
- List Zones - Fetch available DNS zones from your provider
- Cache Zones - Store zone information for faster access
- Set Status - Mark connection as Active, Pending, or Invalid
After Connection
Once connected, Orkestia will:
- Display Connection - Show in your connections list with status
- Sync Zones - Automatically fetch and cache DNS zones
- Enable Custom Domains - Use zones for custom domain configuration
- Track Statistics - Update connection statistics
Your connection will appear in the list with an Active status if everything is configured correctly.
Quick Provider Comparison
| Provider | Setup Complexity | Best For | Special Features |
|---|---|---|---|
| Cloudflare | Low | CDN, security | Proxy, DDoS protection |
| Route 53 | Medium | AWS users | Zone configuration, ACM integration |
| Google DNS | Medium | GCP users | Service account auth |
| Vercel DNS | Low | Vercel users | Simple token auth |
Next Steps
Troubleshooting
If you encounter issues during setup:
- Validation Failed? Check your credentials and permissions
- No Zones Found? Ensure you have zones in your DNS provider account
- Route 53 Issues? Verify your AWS connection has Route 53 permissions
For more help, see Troubleshooting.