Add comprehensive installation and operational documentation for Neta

- 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.
This commit is contained in:
Poyraz Avsever
2026-06-14 11:12:52 +03:00
parent 32e00a163e
commit 03b03d253d
13 changed files with 1745 additions and 0 deletions
+97
View File
@@ -0,0 +1,97 @@
---
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.