Ortam değişkenleri

Hepsi, docker compose’un okuduğu ve docker-compose.yml dosyasının yanında duran .env dosyasına yazılır (eksiksiz ve açıklamalı şablon .env.example dosyasıdır). docker run ile bunları -e ile geçirin. Boş bir değer “tanımsız” sayılır.

Zorunlu

Değişken	Rol
POSTGRES_PASSWORD	PostgreSQL konteynerinin şifresi
BASEDB_ENCRYPTION_KEY	kurulum anahtarı: oturumları imzalar, gizli bilgileri şifreler. openssl rand -base64 32, bir kez ve kalıcı olarak

Veritabanı

Değişken	Varsayılan	Rol
POSTGRES_USER	basedb	PostgreSQL rolü
POSTGRES_DB	basedb	PostgreSQL veritabanı
POSTGRES_PORT	5432	127.0.0.1 üzerinde yayımlanan port
DATABASE_URL	db konteyneri	size ait bir PostgreSQL 16+ veritabanı

İlk başlatma

Değişken	Varsayılan	Rol
BASEDB_MIGRATE	1	boş bir veritabanında kataloğu uygular
BASEDB_BOOTSTRAP	1	ilk yöneticiyi hazırlar
BASEDB_TENANT	t4z56fq	API URL’lerindeki çalışma alanı (tenant) referansı
BASEDB_ADMIN_EMAIL	—	başlangıçta oluşturulan ilk yöneticinin adresi; boşsa arayüzü ilk açan kişi yöneticiyi oluşturur
BASEDB_ADMIN_PASSWORD	üretilir, bir kez gösterilir	BASEDB_ADMIN_EMAIL ile birlikte yöneticinin şifresi; tanımlıysa her başlatmada yöneticiye yeniden uygulanır: giriş yaptıktan sonra kaldırın

Google, Microsoft… ile giriş (OIDC)

Değişken	Varsayılan	Rol
BASEDB_OIDC_PROVIDERS	—	sunulan sağlayıcılar, virgülle ayrılmış: google,microsoft
BASEDB_OIDC_<NOM>_CLIENT_ID, _CLIENT_SECRET	—	sağlayıcıda kayıtlı uygulama
BASEDB_OIDC_<NOM>_ISSUER	google, gitlab için bilinen değer	OpenID Connect yayımlayıcısı
BASEDB_OIDC_<NOM>_LABEL, _SCOPES	sağlayıcıya göre	düğmenin adı, istenen kapsamlar
BASEDB_OIDC_<NOM>_SIGNUP	—	off: ilk giriş hesap oluşturmaz

Bkz. Hesaplar ve giriş.

Adresler

Değişken	Varsayılan	Rol
BASEDB_PORT	3000	127.0.0.1 üzerinde yayımlanan port: arayüz, /api ve /mcp
BASEDB_VERSION	latest	eodia/basedb imajının etiketi
BASEDB_PUBLIC_URL	—	OIDC dönüşü için basedb’nin herkese açık adresi
BASEDB_BASE_PATH	BASEDB_PUBLIC_URL’in yolu	basedb’nin bir ağ geçidinin arkasında sunulduğu yol, https://passerelle.example.com/basedb/ için /basedb; bkz. Docker Compose
BASEDB_DOMAIN	—	Caddy proxy’sinin HTTPS ile sunduğu alan adı
BASEDB_ORIGINS	—	sayfaları API’yi tarayıcıdan çağıran diğer siteler, virgülle ayrılmış; aynı adresten sunulan basedb arayüzü için gerekmez
BASEDB_API, BASEDB_MCP	/, /mcp	tarayıcıdan görüldüğü hâliyle API ve MCP; yalnızca geliştirme ortamı (pnpm start) için ayarlanır

Dosyalar

Değişken	Varsayılan	Rol
BASEDB_FILES_MAX_MB	25	bir dosyanın azami boyutu
BASEDB_S3_BUCKET	—	S3 depolamasını etkinleştirir
BASEDB_S3_ENDPOINT	—	S3 uç noktası
BASEDB_S3_REGION	us-east-1	bölge
BASEDB_S3_ACCESS_KEY_ID, BASEDB_S3_SECRET_ACCESS_KEY	—	kimlik bilgileri
BASEDB_S3_FORCE_PATH_STYLE	1	ana makine tabanlı adresleme için 0

E-postalar

Bir gönderim sunucusu olmadan basedb hiçbir e-posta göndermez. Onunla birlikte, on dakika okunmadan kalan bildirimler (herkes hangilerini istediğini Ayarlar › Bildirimler’de seçer), otomasyonların E-posta gönder adımının e-postaları ve bir şifremi unuttum bağlantısı gider. Bağlantılar BASEDB_PUBLIC_URL’e işaret eder; o tanımlı değilse bir e-posta bağlantı taşımaz.

Değişken	Varsayılan	Rol
BASEDB_SMTP_HOST	—	SMTP sunucusu: e-posta sağlayıcınızınki ya da bir gönderim servisininki
BASEDB_SMTP_PORT	587	baştan şifreli bir bağlantı için 465
BASEDB_SMTP_SECURE	starttls (465 portunda tls)	yalnızca aynı makinedeki bir aktarım için none: aksi hâlde şifre açık metin olarak geçer
BASEDB_SMTP_USER, BASEDB_SMTP_PASSWORD	—	gönderim hesabının kimliği, isteniyorsa
BASEDB_MAIL_FROM	—	BASEDB_SMTP_HOST ile zorunlu: gönderen, basedb <no-reply@exemple.fr>

Başlatıldığında günlük durumu bildirir: Courriels : SMTP smtp.exemple.fr:587 (starttls), expéditeur no-reply@exemple.fr. Sunucunun geri çevirdiği bir e-posta 1, 5, 30, 120 ve ardından 360 dakika sonra yeniden denenir.

Haritalar ve adresler

Harita görünümü bir adresi bir coğrafi kodlama servisi sayesinde yerleştirir: varsayılan olarak OpenStreetMap’inki (Nominatim), adres başına bir kez sorgulanır, en fazla saniyede bir istek, her yanıt saklanır. Harita altlığı, her okuyucunun tarayıcısının doğrudan yüklediği karolardan oluşur.

Değişken	Varsayılan	Rol
BASEDB_GEOCODER_URL	https://nominatim.openstreetmap.org	aynı protokolü konuşan başka bir servis (kendi Nominatim’iniz); off: hiçbiri, adresler kurulumdan çıkmaz ve satırları yalnızca enlem ve boylam yerleştirir
BASEDB_MAP_TILES	OpenStreetMap’in karoları	başka bir karo sunucusu, https://…/{z}/{x}/{y}.png modeli
BASEDB_MAP_ATTRIBUTION	© OpenStreetMap	bu sunucunun istediği ibare, haritanın sağ altında

Başlatıldığında günlük hangi servisin kullanıldığını bildirir: Géocodage : https://nominatim.openstreetmap.org.

PDF belgeleri

Değişken	Varsayılan	Rol
BASEDB_PDF_FONTS	imajın Noto yazı tipleri	konteynerde bağlanan kendi klasörünüz; NotoSans-Regular.ttf, -Bold, -Italic, -BoldItalic dosyalarını, Çince, Japonca ve Korece için de NotoSansCJK-Regular.ttc ve -Bold.ttc dosyalarını tutar

Veritabanı şablonları

Değişken	Varsayılan	Rol
BASEDB_TEMPLATES_URL	herkese açık sitenin kataloğu	kurulumun galerisindeki şablonları nereden okuduğu; hiçbirini okumamak için off (gömülü şablonlar kalır) — bkz. Şablonlar

Yapay zeka

Değişken	Varsayılan	Rol
BASEDB_AI_PROVIDER	—	openai, anthropic, mistral ya da openai_compatible (Azure, bir ağ geçidi, yerel bir model)
BASEDB_AI_MODEL	—	model
BASEDB_AI_API_KEY	—	anahtar (yoksa OPENAI_API_KEY, ANTHROPIC_API_KEY, MISTRAL_API_KEY); openai_compatible için isteğe bağlı
BASEDB_AI_BASE_URL	sağlayıcının adresi	/chat/completions öncesindeki kısım (anthropic için /messages), parametreler dahil; openai_compatible için zorunlu — bkz. Yapay zeka
BASEDB_AI_HEADERS	—	her çağrıya eklenen başlıklar, bir JSON nesnesi olarak: {"api-key":"…"}
BASEDB_AI_PROVIDER_SSL_VERIFY	true	false: sağlayıcının TLS sertifikası doğrulanmaz — kendinden imzalı sertifikalı bir iç ağ geçidi; bkz. Yapay zeka
BASEDB_AI_QUOTA	120	saat ve çalışma alanı başına etkileşimli çağrılar
BASEDB_AI_FIELD_QUOTA	300	saat ve çalışma alanı başına yapay zeka alanı hesaplamaları
BASEDB_AI_WORKER	1	0: bu süreçte arka plan hesaplaması yapılmaz

İç ağa giden webhook’lar

Değişken	Varsayılan	Rol
BASEDB_WEBHOOK_ALLOW	—	iç sunucularınız, virgülle ayrılmış: bir ad (chat.intra.example.com), bir alan adı ve alt alan adları (*.intra.example.com), bir adres ya da bir aralık (10.12.0.0/16)

Webhook’lar, otomasyonların HTTP istekleri ve senkronize tablolar yalnızca herkese açık HTTPS adreslerine gider. Listedeki bir hedef, adresi, portu ve şeması ne olursa olsun — HTTP dahil — ayrıca kabul edilir. Okunamayan bir girdi başlatmayı engeller. Bkz. Webhook’lar.

Herkese açık demo

demo.basedb.eodia.com gibi herkese açık bir kurulumda: giriş ekranı paylaşılan bir hesabı önceden doldurur, ziyaretçi her şeyi okur ve var olanı değiştirir, ama hiçbir şey oluşturmaz ya da silmez — veritabanı, tablo, satır, dosya, yorum, hesap, jeton, bağlantı —, ve yapay zeka demonun bir parçası olmadığını yanıtlar. SQL konsolu orada yalnızca okur. Veritabanını her gece eski hâline getirmek size kalır.

Değişken	Varsayılan	Rol
BASEDB_DEMO	—	1: kurulum herkese açık bir demoya dönüşür
BASEDB_DEMO_ACCOUNTS	—	dil başına bir hesap, virgülle ayrılmış: fr=demo@demo.com,en=demo-en@demo.com; giriş ekranı kendi dilindekini, yoksa İngilizceyi, yoksa ilkini önceden doldurur ve diğerlerini önerir. Demoyu etkinleştirmeden önce bu hesapları, her birini kendi projesiyle birlikte oluşturun: demo, yönetici dahil herkes için oluşturmaları reddeder
BASEDB_DEMO_PASSWORD	—	BASEDB_DEMO_ACCOUNTS ile birlikte, hepsi için aynı olan ve onlarla birlikte yayımlanan şifreleri

BASEDB_DEMO_ACCOUNTS olmadan, paylaşılan hesap BASEDB_ADMIN_EMAIL ve BASEDB_ADMIN_PASSWORD’ün adlandırdığı yöneticidir. Demonun bir adresi, ne yazılırsa yazılsın, yayımlanan şifreyle giriş yapar: yanlış denemeler onu herkes için kilitlemez.

Yalnızca geliştirme

Değişken	Rol
BASEDB_DEV_MAIL=1	e-postaları göndermek yerine günlüklerde gösterir
BASEDB_WEBHOOK_DEV=1	HTTP’ye ve yerel adreslere giden webhook’lara izin verir