Custom Domain di Helipod: Gunakan Domain Sendiri untuk Aplikasi

Deploy ke helipod.app memang mudah. Tapi untuk production, kamu butuh domain sendiri, api.kamu.com, app.kamu.com, atau kamu.id.

Helipod memudahkan setup custom domain dengan SSL otomatis dan DNS verification. Tidak perlu khawatir certificate expired atau konfigurasi HTTPS manual.

Kenapa Custom Domain?#

• Branding: domain sendiri lebih profesional
• SEO: subdomain dari domain utama lebih baik
• SSL gratis: otomatis di-setup oleh Helipod
• Migration mudah: ganti backend tanpa ganti domain

Cara Setup Custom Domain#

Langkah 1: Tambah Domain di Helipod#

1. Buka halaman service di Helipod
2. Tab Settings → Domains
3. Klik Add Domain
4. Masukkan domain (misal: app.kamu.com)
5. Klik Add

Langkah 2: Konfigurasi DNS#

Helipod akan memberikan records DNS yang perlu ditambahkan:

CNAME Record:

Atau A Record (jika CNAME tidak didukung):

Langkah 3: Tambah DNS di Domain Register#

Buka dashboard domain register kamu (Namecheap, Cloudflare, dll) dan tambahkan records di atas.

Penting untuk Cloudflare users: Set DNS ke Grey Cloud (DNS Only) terlebih dahulu. Orange Cloud (Proxied) akan block SSL verification. Setelah domain aktif, baru bisa switch ke Orange Cloud.

Langkah 4: Verifikasi#

1. Tunggu propagasi DNS (biasanya 5-30 menit)
2. Klik Verify di dashboard Helipod
3. SSL certificate akan otomatis di-issue

Subdomain vs Root Domain#

Subdomain (Recommended)#

app.kamu.com    → Helipod
api.kamu.com    → Helipod
admin.kamu.com  → Helipod

Lebih mudah di-setup dan tidak konflik dengan layanan lain.

Root Domain#

kamu.com → Helipod

Butuh DNS provider yang mendukung ALIAS/ANAME record, atau gunakan A record dengan IP Helipod.

SSL Certificate#

Helipod menyediakan SSL gratis dari Let's Encrypt:

• Auto-renewal: certificate diperbarui otomatis
• Wildcard: support *.kamu.com
• TLS 1.3: protokol terbaru dan teraman

Verifikasi SSL#

# Cek SSL dari terminal
openssl s_client -connect app.kamu.com:443 -servername app.kamu.com

Atau buka https://app.kamu.com di browser, ikon gembok harus muncul.

Multi-Domain#

Satu service bisa punya banyak domain:

app.kamu.com    → Service "frontend"
www.kamu.com    → Service "frontend" (redirect ke app.kamu.com)
api.kamu.com    → Service "backend"

Setup Redirect#

Untuk redirect www ke non-www (atau sebaliknya):

1. Tambahkan kedua domain di Helipod
2. Di DNS provider, tambahkan CNAME untuk www ke app
3. Helipod akan handle redirect otomatis

Untuk penjelasan networking lebih lanjut, baca: Multi-Service Project di Helipod

Wildcard Domain#

Untuk aplikasi yang butuh subdomain dinamis (misal: tenant1.app.com, tenant2.app.com):

1. Setup wildcard SSL di Helipod
2. Tambahkan wildcard DNS record:

Type: CNAME
Name: *.app
Value: apps.helipod.app

3. Semua subdomain akan otomatis ter-resolve

Troubleshooting#

Domain Tidak Ter-resolve#

• Pastikan DNS sudah propagation (cek di dnschecker.org)
• Pastikan record DNS sudah benar
• Tunggu hingga 30 menit untuk propagation

SSL Error#

• Jika pakai Cloudflare, pastikan Grey Cloud (DNS Only)
• Tunggu beberapa menit setelah DNS propagation
• Klik Renew SSL di dashboard

502 Bad Gateway#

• Pastikan service di Helipod sudah running
• Cek apakah ada error di logs
• Verifikasi domain sudah benar di Helipod

Untuk troubleshooting lebih lanjut, baca: Deploy MongoDB ke Helipod, bagian troubleshooting

Best Practices#

1. Gunakan Subdomain#

Lebih aman dan fleksibel dibanding root domain.

2. Setup Redirect#

Selalu redirect satu versi ke lainnya (www → non-www atau sebaliknya) untuk SEO.

3. Monitor SSL#

Setup alert untuk certificate yang akan expired. Helipod handle auto-renewal, tapi tetap perlu monitoring.

4. Gunakan DNS Provider yang Mendukung CNAME#

Cloudflare, Namecheap, atau provider lain yang mendukung CNAME di apex domain.

Mulai Sekarang#

Daftar gratis di helipod.io. Tambahkan custom domain dan jalankan aplikasi dengan domain sendiri.

Butuh bantuan? Hubungi support@helipod.io atau bergabung di komunitas hangar.helipod.io.

Baca juga:

• Multi-Service Project di Helipod, deploy banyak service dengan domain berbeda
• Environment Variables di Helipod, cara set konfigurasi
• Monitoring dan Logs Real-time, pantau aplikasi dari dashboard