Poyraz Avsever
03b03d253d
- Introduced "Kurulum Modları" to explain full-stack and app-only installation options. - Created detailed guides for "Full-Stack Kurulum", "Coolify Kurulumu", "Dokploy Kurulumu", and "App-Only Kurulum". - Documented the process for creating the first admin account and the registration lock mechanism. - Added operational guidelines covering health checks, backups, restores, and logging. - Explained environment variables used in Neta installations and their significance. - Provided troubleshooting tips for common issues encountered during setup and operation. - Outlined security measures and limitations of the MVP self-host model.
98 lines
2.9 KiB
Markdown
98 lines
2.9 KiB
Markdown
---
|
||
title: Kurulum Modları
|
||
description: Full-stack ve app-only kurulum seçenekleri.
|
||
order: 4
|
||
---
|
||
|
||
# Kurulum Modları
|
||
|
||
Neta iki farklı kurulum modeli destekler. Doğru modeli seçmek, migration, environment ve veri konumu açısından önemlidir.
|
||
|
||
## Full-Stack Kurulum
|
||
|
||
Full-stack kurulumda Neta ile birlikte gerekli backend servisleri de aynı sunucuda çalışır.
|
||
|
||
Bu mod şunları içerir:
|
||
|
||
- Neta web uygulaması
|
||
- PostgreSQL
|
||
- Supabase Auth
|
||
- PostgREST
|
||
- Supabase Storage
|
||
- Nginx proxy
|
||
- Otomatik migration runner
|
||
|
||
Bu modda harici Supabase hesabına gerek yoktur. İlk MVP için önerilen self-host yolu budur.
|
||
|
||
## App-Only Kurulum
|
||
|
||
App-only kurulumda sadece Neta uygulaması çalışır. Veritabanı, Auth, Storage ve API servisleri mevcut bir Supabase projesinden veya Supabase uyumlu bir backend'den sağlanır.
|
||
|
||
Bu mod şu durumlarda uygundur:
|
||
|
||
- Zaten aktif bir Supabase projen varsa
|
||
- Veritabanını managed servis olarak kullanmak istiyorsan
|
||
- Sadece Neta arayüzünü kendi sunucunda yayınlamak istiyorsan
|
||
|
||
Bu modda migration dosyalarını bağlandığın Supabase projesinin veritabanında manuel çalıştırman gerekir.
|
||
|
||
## Hangi Mod Seçilmeli?
|
||
|
||
Çoğu self-host kullanıcısı için önerilen seçenek:
|
||
|
||
```text
|
||
Full-stack kurulum
|
||
```
|
||
|
||
Çünkü bu mod:
|
||
|
||
- Harici servis gerektirmez.
|
||
- Migration işlemlerini otomatik yapar.
|
||
- Coolify ve Dokploy gibi araçlarda tek Compose dosyasıyla çalışır.
|
||
- Veriyi aynı sunucuda tutar.
|
||
|
||
App-only mod ise daha ileri kullanıcılar veya mevcut Supabase altyapısını kullanmak isteyenler için uygundur.
|
||
|
||
## `.env` ve `.env.local` Ayrımı
|
||
|
||
Bu ayrım kurulum hatalarının en sık sebebidir.
|
||
|
||
Docker Compose kurulumlarında `.env` dosyası kullanılır.
|
||
|
||
```bash
|
||
node scripts/generate-full-stack-env.mjs > .env
|
||
docker compose -f docker-compose.full.yml up -d --build
|
||
```
|
||
|
||
Lokal Next.js geliştirme sırasında ise Next.js `.env.local` dosyasını okur.
|
||
|
||
```bash
|
||
pnpm dev
|
||
```
|
||
|
||
Eğer `.env.local` hosted Supabase projesine bakıyorsa, lokal geliştirme ortamında self-host Docker veritabanına değil hosted Supabase'e bağlanırsın.
|
||
|
||
## Migration Nerede Çalışır?
|
||
|
||
Full-stack modda:
|
||
|
||
- Migration işlemleri `neta-migrations` servisi tarafından otomatik yapılır.
|
||
- Kullanıcının SQL dosyalarını manuel çalıştırması gerekmez.
|
||
|
||
App-only modda:
|
||
|
||
- Migration dosyaları mevcut Supabase projesinde çalıştırılmalıdır.
|
||
- Uygulamanın bağlandığı `NEXT_PUBLIC_SUPABASE_URL` hangi projeyi gösteriyorsa, migration da o projenin veritabanında olmalıdır.
|
||
|
||
## Coolify ve Dokploy İçin Öneri
|
||
|
||
Coolify ve Dokploy gibi araçlarda en pratik yöntem:
|
||
|
||
- Compose dosyası olarak `docker-compose.full.yml` seçmek
|
||
- Generated environment değerlerini panelde tanımlamak
|
||
- Neta domainini `neta-web:3000` servisine yönlendirmek
|
||
- Supabase API gerekiyorsa `neta-supabase-proxy:8000` servisini ayrıca yayınlamak
|
||
|
||
Bu yapı, kullanıcıya harici Supabase hesabı gerektirmeden tam self-host deneyimi sağlar.
|
||
|