Wildcard Domain Setup for RepoDocs

Wildcard Domain Setup for RepoDocs

Bu rehber, RepoDocs'ta custom domain'lerin otomatik çalışması için wildcard domain kurulumunu açıklar.

Sorun

Easypanel'in public API'si yok. Her custom domain için manuel olarak Easypanel'e domain eklemek gerekiyor.

Çözüm: Wildcard Domain

Wildcard domain kullanarak tüm subdomain'ler otomatik çalışır:

*.repodocs.dev → Tüm subdomain'ler otomatik çalışır
project1.repodocs.dev ✅
project2.repodocs.dev ✅
myproject.repodocs.dev ✅

Kurulum Adımları

1. DNS Ayarları

Domain registrar'ınızda (Cloudflare, Namecheap, etc.):

2. Easypanel'de Wildcard Domain Ekleme

Adım 1: Certificate Resolver Oluştur

Easypanel > Settings > Traefik > Environment
Şu environment variable'ları ekle:

Adım 2: DNS Provider Credentials

Cloudflare için:

Diğer provider'lar için: https://doc.traefik.io/traefik/https/acme/#providers

Adım 3: Traefik'i Yeniden Başlat

Easypanel > Settings > Traefik > Restart

Adım 4: Wildcard Domain Ekle

Easypanel > repodocs > app > Domains
Add Domain
Domain: *.repodocs.dev
Wildcard domain: ✅ Enable
Resolver: wildcard
Add

3. Test

Custom Domain'ler (docs.example.com)

Wildcard domain sadece subdomain'ler için çalışır. Tamamen farklı domain'ler (docs.example.com) için:

Seçenek 1: Manuel Ekleme (Önerilen)

Kullanıcı DNS'i ayarlar: docs.example.com → repodocs.dev
Admin Easypanel'e domain ekler
SSL otomatik oluşturulur

Seçenek 2: Cloudflare Proxy

Kullanıcı Cloudflare kullanır
CNAME: docs.example.com → repodocs.dev
Cloudflare SSL sağlar
Easypanel'e eklemeye gerek yok

Mevcut Durum

Domain Tipi	Otomatik	Manuel
`project.repodocs.dev`	✅ Wildcard ile	-
`docs.example.com`	❌	✅ Easypanel'e ekle

Sonuç

Subdomain'ler (*.repodocs.dev) wildcard ile otomatik çalışır
Custom domain'ler (docs.example.com) manuel ekleme gerektirir
Easypanel'in public API'si olmadığı için tam otomasyon mümkün değil