microdao-daarion/docs/DEPLOY_DNS_SETUP.md

DNS Setup для DAARION Production

Домен: daarion.space
Цільовий сервер: VPS з Ubuntu 22.04 LTS

---

📋 Обов'язкові DNS записи

1. Головний домен (Landing / Redirect)

Type: A
Name: @
Value: <SERVER_IP_ADDRESS>
TTL: 3600

Призначення: https://daarion.space → redirect на https://app.daarion.space

---

2. Application субдомен (MVP Product)

Type: A
Name: app
Value: <SERVER_IP_ADDRESS>
TTL: 3600

Призначення: https://app.daarion.space → головний MVP-продукт (microDAO + City + Agents)

---

📋 Опціональні DNS записи

3. Grafana моніторинг

Type: A
Name: grafana
Value: <SERVER_IP_ADDRESS>
TTL: 3600

Призначення: https://grafana.daarion.space → прямий доступ до Grafana

Альтернатива: Використовувати path-based routing через app: https://app.daarion.space/grafana/

---

4. API субдомен (майбутнє)

Type: A
Name: api
Value: <SERVER_IP_ADDRESS>
TTL: 3600

Призначення: https://api.daarion.space → окремий субдомен для API

Статус: Не потрібно для MVP, але можна зарезервувати

---

5. Matrix субдомен (Phase 4+)

Type: A
Name: matrix
Value: <SERVER_IP_ADDRESS>
TTL: 3600

Призначення: https://matrix.daarion.space → Matrix homeserver (Phase 4+)

Статус: Буде потрібно в PHASE MATRIX FULL

---

🔍 Перевірка DNS

Після додавання записів перевірити:

# Перевірка A-запису для головного домену
dig daarion.space +short

# Перевірка A-запису для app субдомену
dig app.daarion.space +short

# Перевірка всіх записів
dig daarion.space ANY

# Через nslookup
nslookup app.daarion.space

# Через host
host app.daarion.space

Очікуваний результат: IP-адреса вашого VPS

---

⏱️ Час propagation

• Середній час: 15-60 хвилин
• Максимальний: 24-48 годин (рідко)
• TTL: 3600 секунд (1 година)

Рекомендація: Почекати хоча б 15 хвилин перед налаштуванням SSL.

---

🌐 DNS Providers інструкції

Cloudflare

1. Dashboard → DNS → Add record
2. Type: A, Name: app, IPv4 address: <SERVER_IP>
3. Proxy status: DNS only (сіра хмарка) для MVP
4. TTL: Auto
5. Save

Google Domains

1. DNS → Manage custom records
2. Host name: app, Type: A, TTL: 3600, Data: <SERVER_IP>
3. Add

Namecheap

1. Advanced DNS → Add New Record
2. Type: A Record, Host: app, Value: <SERVER_IP>, TTL: Automatic
3. Save

DigitalOcean

1. Networking → Domains → daarion.space → Create new record
2. Type: A, Hostname: app, Will direct to: <SERVER_IP>, TTL: 3600
3. Create Record

---

🔒 SSL Certificate Requirements

Після налаштування DNS, для SSL потрібно:

1. ✅ DNS A-записи propagated
2. ✅ Порт 80 відкритий на сервері
3. ✅ Порт 443 відкритий на сервері
4. ✅ Домен вказує на правильний IP

Команда для перевірки портів:

# На сервері
sudo ufw status
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

---

📊 DNS Health Check

# Перевірка DNS propagation globally
# Використати онлайн інструменти:
# - https://dnschecker.org/
# - https://www.whatsmydns.net/

# Або через CLI:
for server in 8.8.8.8 1.1.1.1 208.67.222.222; do
  echo "Testing with DNS server: $server"
  dig @$server app.daarion.space +short
done

---

🚨 Troubleshooting

Проблема: DNS не резолвиться

Рішення:

1. Перевірити синтаксис DNS запису
2. Очистити локальний DNS cache:

   # macOS
   sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
   
   # Linux
   sudo systemd-resolve --flush-caches
   
   # Windows
   ipconfig /flushdns
   

3. Почекати 15-60 хвилин

Проблема: Propagation занадто повільна

Рішення:

1. Зменшити TTL до 300 секунд (5 хвилин)
2. Почекати старий TTL (якщо був 3600 - почекати годину)
3. Використати публічні DNS (8.8.8.8, 1.1.1.1)

Проблема: Subdomain не працює

Рішення:

1. Перевірити що створили запис саме для субдомену (app), а не для @ (root)
2. Для Cloudflare: перевірити Proxy status (має бути DNS only для MVP)

---

✅ Pre-deployment Checklist

Перед запуском SSL/HTTPS налаштування:

• DNS A-запис для daarion.space створено
• DNS A-запис для app.daarion.space створено
• DNS propagated (перевірено через dig або онлайн tools)
• Порти 80 та 443 відкриті на сервері
• Firewall налаштований (ufw/iptables)
• Сервер доступний через SSH
• Docker та Docker Compose встановлені

---

📚 Наступні кроки

Після успішного налаштування DNS:

1. ➡️ SSL/HTTPS Setup (docs/DEPLOY_SSL_SETUP.md)
2. ➡️ Environment Configuration (docs/DEPLOY_ENV_CONFIG.md)
3. ➡️ Database Migrations (docs/DEPLOY_MIGRATIONS.md)
4. ➡️ Services Startup (docs/DEPLOY_SERVICES.md)

---

Статус: ✅ DNS Setup Guide Complete
Версія: 1.0.0
Дата: 24 листопада 2025