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.
193 lines
4.1 KiB
Markdown
193 lines
4.1 KiB
Markdown
---
|
||
title: Ortam Değişkenleri
|
||
description: Neta kurulumunda kullanılan environment değişkenleri.
|
||
order: 11
|
||
---
|
||
|
||
# Ortam Değişkenleri
|
||
|
||
Neta kurulumunda environment değişkenleri uygulamanın hangi URL'leri kullanacağını, Supabase bağlantılarını, JWT secret değerlerini ve portları belirler.
|
||
|
||
## Dosya Ayrımı
|
||
|
||
Docker Compose:
|
||
|
||
```text
|
||
.env
|
||
```
|
||
|
||
dosyasını kullanır.
|
||
|
||
Lokal Next.js geliştirme:
|
||
|
||
```text
|
||
.env.local
|
||
```
|
||
|
||
dosyasını kullanır.
|
||
|
||
Bu ayrım önemlidir. `.env.local` hosted Supabase'e bakarken Docker full-stack farklı bir `.env` ile çalışıyor olabilir.
|
||
|
||
## Full-Stack Değerleri
|
||
|
||
Full-stack mod için env üretmek:
|
||
|
||
```bash
|
||
node scripts/generate-full-stack-env.mjs > .env
|
||
```
|
||
|
||
Temel değişkenler:
|
||
|
||
```env
|
||
NETA_INSTALL_MODE=full-stack
|
||
NEXT_PUBLIC_SITE_URL=http://localhost:3000
|
||
NETA_PORT=3000
|
||
NEXT_PUBLIC_SUPABASE_URL=http://localhost:8000
|
||
SUPABASE_API_PORT=8000
|
||
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
|
||
SUPABASE_SERVICE_ROLE_KEY=...
|
||
JWT_SECRET=...
|
||
POSTGRES_PASSWORD=...
|
||
POSTGRES_PORT=54322
|
||
JWT_EXPIRY=3600
|
||
SMTP_ADMIN_EMAIL=admin@neta.local
|
||
```
|
||
|
||
## `NEXT_PUBLIC_SITE_URL`
|
||
|
||
Neta uygulamasının public URL değeridir.
|
||
|
||
Local örnek:
|
||
|
||
```env
|
||
NEXT_PUBLIC_SITE_URL=http://localhost:3000
|
||
```
|
||
|
||
Production örnek:
|
||
|
||
```env
|
||
NEXT_PUBLIC_SITE_URL=https://app.example.com
|
||
```
|
||
|
||
Auth redirect ve site URL kontrollerinde kullanılır.
|
||
|
||
## `NEXT_PUBLIC_SUPABASE_URL`
|
||
|
||
Tarayıcıdan erişilebilen Supabase API URL değeridir.
|
||
|
||
Full-stack local örnek:
|
||
|
||
```env
|
||
NEXT_PUBLIC_SUPABASE_URL=http://localhost:8000
|
||
```
|
||
|
||
Production örnek:
|
||
|
||
```env
|
||
NEXT_PUBLIC_SUPABASE_URL=https://api.example.com
|
||
```
|
||
|
||
Bu URL dışarıdan erişilebilir olmalıdır. Tarayıcı Auth, REST ve Storage çağrıları için bu değeri kullanır.
|
||
|
||
## `SUPABASE_INTERNAL_URL`
|
||
|
||
Uygulama container içinden Supabase proxy'ye bağlanırken kullanılabilir.
|
||
|
||
Full-stack Compose içinde varsayılan:
|
||
|
||
```env
|
||
SUPABASE_INTERNAL_URL=http://neta-supabase-proxy:8000
|
||
```
|
||
|
||
Bu değer genellikle manuel ayarlanmaz, Compose içinde verilir.
|
||
|
||
## `NEXT_PUBLIC_SUPABASE_ANON_KEY`
|
||
|
||
Supabase anon JWT değeridir. Client tarafında kullanılabilir, ama yine de doğru JWT secret ile üretilmiş olmalıdır.
|
||
|
||
Full-stack modda script tarafından otomatik üretilir.
|
||
|
||
## `SUPABASE_SERVICE_ROLE_KEY`
|
||
|
||
Service role key yüksek yetkili bir anahtardır.
|
||
|
||
Güvenlik kuralları:
|
||
|
||
- Client tarafında paylaşılmamalıdır.
|
||
- Public repository'ye yazılmamalıdır.
|
||
- Sadece server-side işlemlerde kullanılmalıdır.
|
||
- Coolify/Dokploy gibi panellerde secret olarak saklanmalıdır.
|
||
|
||
## `JWT_SECRET`
|
||
|
||
Supabase Auth ve JWT doğrulama için kullanılan gizli değerdir.
|
||
|
||
`NEXT_PUBLIC_SUPABASE_ANON_KEY` ve `SUPABASE_SERVICE_ROLE_KEY` bu secret ile uyumlu olmalıdır. Secret değişirse tokenlar da yeniden üretilmelidir.
|
||
|
||
## `POSTGRES_PASSWORD`
|
||
|
||
Bundled PostgreSQL için ana parola değeridir.
|
||
|
||
Full-stack modda:
|
||
|
||
- `neta-db`
|
||
- `neta-auth`
|
||
- `neta-rest`
|
||
- `neta-storage`
|
||
- `neta-migrations`
|
||
|
||
servislerinin veritabanı bağlantılarında kullanılır.
|
||
|
||
## Port Değerleri
|
||
|
||
```env
|
||
NETA_PORT=3000
|
||
SUPABASE_API_PORT=8000
|
||
POSTGRES_PORT=54322
|
||
```
|
||
|
||
Bu değerler host makinede hangi portların dışarı açılacağını belirler.
|
||
|
||
Container içi portlar genellikle sabittir.
|
||
|
||
## SMTP Değerleri
|
||
|
||
MVP kurulumda e-posta doğrulama varsayılan olarak otomatik onaylıdır. Yine de ileride e-posta akışları için SMTP ayarları kullanılabilir.
|
||
|
||
Örnek:
|
||
|
||
```env
|
||
SMTP_ADMIN_EMAIL=admin@example.com
|
||
SMTP_HOST=smtp.example.com
|
||
SMTP_PORT=587
|
||
SMTP_USER=...
|
||
SMTP_PASS=...
|
||
SMTP_SENDER_NAME=Neta
|
||
```
|
||
|
||
## App-Only Değerleri
|
||
|
||
App-only modda minimum değerler:
|
||
|
||
```env
|
||
NEXT_PUBLIC_SITE_URL=https://app.example.com
|
||
NEXT_PUBLIC_SUPABASE_URL=https://project-ref.supabase.co
|
||
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
|
||
SUPABASE_SERVICE_ROLE_KEY=...
|
||
```
|
||
|
||
Migration için ayrıca:
|
||
|
||
```env
|
||
DATABASE_URL=postgresql://postgres:password@host:5432/postgres
|
||
```
|
||
|
||
## Güvenlik Notları
|
||
|
||
- `.env` ve `.env.local` dosyalarını commit etme.
|
||
- Service role key'i sadece sunucu tarafında kullan.
|
||
- Production ortamında güçlü secret değerleri kullan.
|
||
- Domain ve Supabase URL değerlerinin birbiriyle uyumlu olduğundan emin ol.
|
||
- Coolify/Dokploy panellerinde secret değerlerini public build loglarında göstermemeye dikkat et.
|
||
|