Skip to content

Commit ef9accb

Browse files
sudheerbhuvanasudheerbhuvana
authored
Merge pull request #3 from stackryze/development
Development
2 parents 927c9b2 + 9f19766 commit ef9accb

15 files changed

Lines changed: 389 additions & 21 deletions

‎src/dns-providers/digitalocean.md‎

Lines changed: 191 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,202 @@ label: DigitalOcean DNS
33
icon: server
44
---
55

6-
# DigitalOcean DNS Setup
6+
# DigitalOcean DNS Setup for Stackryze Domains
77

88
> [!WARNING]
99
> These docs are in **Beta** and actively updated daily. Please report if you find any issues.
1010
11-
*Documentation coming soon*
11+
This guide shows you how to use DigitalOcean DNS as your DNS provider for your **Stackryze Domains** subdomain.
1212

13-
DigitalOcean DNS is a free DNS service included with any DigitalOcean account, offering simple and reliable DNS hosting.
13+
## Why DigitalOcean DNS?
1414

15-
## Quick Setup
15+
- **Free DNS Hosting**: Included with any DigitalOcean account
16+
- **Simple Interface**: Easy-to-use control panel
17+
- **Reliable Infrastructure**: Built on DigitalOcean's global network
18+
- **Fast Propagation**: Quick DNS updates
19+
- **API Access**: Automate DNS management
1620

17-
1. Create a DigitalOcean account
18-
2. Go to Networking → Domains
19-
3. Add your subdomain
20-
4. Note your DigitalOcean nameservers
21-
5. Register with indevs using your nameservers
21+
---
22+
23+
## Prerequisites
24+
25+
Before you begin:
26+
27+
- **Registered subdomain** on [domain.stackryze.com](https://domain.stackryze.com/)
28+
- **DigitalOcean account** - [Sign up here](https://www.digitalocean.com/)
29+
30+
> [!TIP]
31+
> If you haven't registered your subdomain yet, see our [Getting Started](../getting-started) guide first.
32+
33+
---
34+
35+
## Step 1: Login to DigitalOcean Dashboard
36+
37+
1. Log in to your [DigitalOcean Dashboard](https://cloud.digitalocean.com/)
38+
2. Navigate to **"Networking"** in the left sidebar
39+
3. Click on **"Networking"**
40+
41+
[![DigitalOcean Dashboard - Navigate to Networking](../media/DigitalOcean/DigitalOcean_step_1.png)](../media/DigitalOcean/DigitalOcean_step_1.png)
42+
43+
---
44+
45+
## Step 2: Navigate to Domains Tab
46+
47+
1. Click on the **"Domains"** tab
48+
2. If this is your first time, you may need to **add a payment method**
49+
3. Fill in your payment details/credentials to proceed
50+
4. Once payment is set up, click **"Add a domain"** button
51+
52+
[![Navigate to Domains Tab and Add Domain](../media/DigitalOcean/DigitalOcean_step_2.png)](../media/DigitalOcean/DigitalOcean_step_2.png)
53+
54+
---
55+
56+
## Step 3: Add Your Domain
57+
58+
1. In the domain input field, enter your **full subdomain** (e.g., `yourname.indevs.in`)
59+
2. Click **"Add Domain"** button
60+
61+
[![Add Your Domain](../media/DigitalOcean/DigitalOcean_step_3.png)](../media/DigitalOcean/DigitalOcean_step_3.png)
62+
63+
> [!IMPORTANT]
64+
> Make sure to enter your complete subdomain from Stackryze Domains (e.g., `myproject.indevs.in`), not just the base domain.
65+
66+
---
67+
68+
## Step 4: Copy Your DigitalOcean Nameservers
69+
70+
After adding the domain, DigitalOcean will display your nameservers:
71+
72+
1. You'll see three nameservers like:
73+
```
74+
ns1.digitalocean.com
75+
ns2.digitalocean.com
76+
ns3.digitalocean.com
77+
```
78+
2. **Copy all three nameservers** - you'll need them in the next step
79+
80+
[![Copy DigitalOcean Nameservers](../media/DigitalOcean/DigitalOcean_step_4.png)](../media/DigitalOcean/DigitalOcean_step_4.png)
81+
82+
> [!WARNING]
83+
> Your nameservers will be the same for all DigitalOcean domains. Always use the exact values shown in your dashboard.
84+
85+
---
86+
87+
## Step 5: Update Nameservers in Stackryze Domains
88+
89+
Now add the DigitalOcean nameservers to your Stackryze domain:
90+
91+
1. Log in to [domain.stackryze.com](https://domain.stackryze.com/)
92+
2. Update nameservers with your DigitalOcean nameservers
93+
3. Click **"Save"**
94+
95+
> [!TIP]
96+
> For detailed instructions, see [Updating Nameservers](../managing-domains#updating-nameservers) guide.
97+
98+
> [!IMPORTANT]
99+
> DNS changes will be updated within 24-48 hours globally.
100+
101+
---
102+
103+
## Step 6: Create an A Record
104+
105+
Now add your DNS records in DigitalOcean:
106+
107+
1. In DigitalOcean, go to your **domain's DNS management page**
108+
2. Click **"Create new record"** or **"Add record"** button
109+
110+
[![Click Create a Record](../media/DigitalOcean/DigitalOcean_step_6.1.png)](../media/DigitalOcean/DigitalOcean_step_6.1.png)
111+
112+
3. Select **"A"** as the record type
113+
4. Fill in the details:
114+
- **Hostname**: `@` (for root domain) or your subdomain name
115+
- **Will Direct To**: Your server's IP address (e.g., `192.0.2.1`)
116+
- **TTL**: `3600` (1 hour) or your preferred value
117+
5. Click **"Create Record"**
118+
119+
[![Fill in Record Details and Create](../media/DigitalOcean/DigitalOcean_step_6.2.png?v=2)](../media/DigitalOcean/DigitalOcean_step_6.2.png?v=2)
120+
121+
**That's it! All steps are done.** 🎉
122+
123+
> [!TIP]
124+
> **Common Record Types:**
125+
> - **A Record**: Points to an IPv4 address
126+
> - **CNAME Record**: Points to another domain (e.g., GitHub Pages)
127+
> - **AAAA Record**: Points to an IPv6 address
128+
> - **MX Record**: For email routing
129+
130+
---
131+
132+
## SSL Configuration
133+
134+
**SSL Handling:**
135+
- DigitalOcean DNS provides DNS services only
136+
- SSL certificates must be managed by your hosting provider
137+
138+
**For Common Hosting Platforms:**
139+
- **Vercel/Netlify**: Automatic SSL provisioning
140+
- **GitHub Pages**: Automatic SSL after DNS verification
141+
- **DigitalOcean App Platform**: Free automatic SSL certificates
142+
- **Custom Server**: Use Let's Encrypt or commercial certificates
143+
144+
> [!TIP]
145+
> Most modern hosting platforms provide free automatic SSL certificates once DNS is configured.
146+
147+
---
148+
149+
## Common Issues
150+
151+
### Domain Not Added
152+
153+
**Solution**:
154+
- Verify you entered the complete subdomain
155+
- Check that you have an active DigitalOcean account
156+
- Ensure subdomain format is correct
157+
- Try refreshing the page and retry
158+
159+
### DNS Not Resolving
160+
161+
**Solution**:
162+
- Verify nameservers are correctly updated in your Stackryze dashboard
163+
- Wait 10-30 minutes for DNS propagation
164+
- Check DNS records in DigitalOcean
165+
- Use [DNS Checker](https://dnschecker.org/) to verify
166+
- Ensure all three nameservers are entered correctly
167+
168+
### Records Not Updating
169+
170+
**Solution**:
171+
- Check TTL value - changes may be cached
172+
- Verify record syntax is correct
173+
- Ensure no conflicting records exist
174+
- Wait for TTL period to expire before expecting changes
175+
176+
### Domain Not Working After Setup
177+
178+
**Solution**:
179+
- Verify nameservers in Stackryze dashboard match DigitalOcean
180+
- Check DNS records in DigitalOcean
181+
- Clear browser and DNS cache
182+
- Wait up to 48 hours for full propagation
183+
184+
---
185+
186+
## Advanced Features
187+
188+
- **API Access**: Manage DNS programmatically via DigitalOcean API
189+
- **IPv6 Support**: Full support for AAAA records
190+
- **CAA Records**: Certificate Authority Authorization
191+
- **SRV Records**: Service records for advanced configurations
192+
- **Bulk Operations**: Manage multiple records efficiently
193+
194+
---
195+
196+
## Additional Resources
197+
198+
- [DigitalOcean DNS Documentation](https://docs.digitalocean.com/products/networking/dns/)
199+
- [DigitalOcean API Documentation](https://docs.digitalocean.com/reference/api/api-reference/#tag/Domains)
200+
- [DNS Propagation Checker](https://dnschecker.org/)
201+
202+
---
22203

23-
For detailed instructions, please check back soon, join our [Discord Community](https://discord.gg/wr7s97cfM7), or contact [support@stackryze.com](mailto:support@stackryze.com).
204+
**Need help?** [Join our Discord](https://discord.gg/wr7s97cfM7) for live help or contact us at [support@stackryze.com](mailto:support@stackryze.com)

0 commit comments

Comments
 (0)