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.