Sunucu Yapılandırması¶

Varsayılan Docker görüntüsünü kullanarak, gerekli tüm yapılandırmalar tarayıcıdan yapılabilir. Ancak, dağıtıma bağlı olarak sunucu yapılandırmasını özelleştirmek gerekebilir.

Bu sayfa, yapılandırmayı değiştirmek için tüm yöntemleri ve mevcut tüm yapılandırma seçeneklerini listeler.

Yapılandırma dosyası vs. ortam değişkenleri¶

Ayarlar için ya bir yapılandırma dosyası ya da ortam değişkenleri kullanabilirsiniz.

Docker Compose tabanlı kurulum kullanıyorsanız, grampsweb: bloğundaki volumes: anahtarının altına aşağıdaki liste öğesini ekleyerek bir yapılandırma dosyası dahil edebilirsiniz:

      - /path/to/config.cfg:/app/config/config.cfg

burada /path/to/config.cfg, sunucunuzun dosya sistemindeki yapılandırma dosyasının yoludur (sağ taraf, konteynerdeki yolu ifade eder ve değiştirilmemelidir).

Ortam değişkenleri kullanırken,

her ayar adını GRAMPSWEB_ ile öne ekleyerek ortam değişkeninin adını elde edin
İç içe sözlük ayarları için çift alt çizgi kullanın, örneğin GRAMPSWEB_THUMBNAIL_CACHE_CONFIG__CACHE_DEFAULT_TIMEOUT, THUMBNAIL_CACHE_CONFIG['CACHE_DEFAULT_TIMEOUT'] yapılandırma seçeneğinin değerini ayarlayacaktır.

Ortam üzerinden ayarlanan yapılandırma seçeneklerinin, yapılandırma dosyasındakilerden önceliği olduğunu unutmayın. Her ikisi de mevcutsa, ortam değişkeni "kazanır".

Mevcut yapılandırma ayarları¶

Aşağıdaki yapılandırma seçenekleri mevcuttur.

Gerekli ayarlar¶

Anahtar	Açıklama
`TREE`	Kullanılacak aile ağacı veritabanının adı. Mevcut ağaçları `gramps -l` ile gösterin. Bu isimde bir ağaç yoksa, yeni boş bir tane oluşturulacaktır.
`SECRET_KEY`	Flask için gizli anahtar. Gizli anahtar kamuya açık olarak paylaşılmamalıdır. Değiştirilmesi, tüm erişim token'larını geçersiz kılacaktır.
`USER_DB_URI`	Kullanıcı veritabanının veritabanı URL'si. SQLAlchemy ile uyumlu herhangi bir URL'ye izin verilir.

Info

Güvenli bir gizli anahtar oluşturmak için örneğin şu komutu kullanabilirsiniz:

python3 -c "import secrets;print(secrets.token_urlsafe(32))"

İsteğe bağlı ayarlar¶

Anahtar	Açıklama
`MEDIA_BASE_DIR`	Medya dosyaları için temel dizin olarak kullanılacak yol, Gramps'ta ayarlanan medya temel dizinini geçersiz kılar. S3 kullanırken `s3://<bucket_name>` formatında olmalıdır.
`SEARCH_INDEX_DB_URI`	Arama dizini için veritabanı URL'si. Sadece `sqlite` veya `postgresql` arka uçları izinlidir. Varsayılan olarak `sqlite:///indexdir/search_index.db` olup, scriptin çalıştırıldığı yola göre `indexdir` klasöründe bir SQLite dosyası oluşturur.
`STATIC_PATH`	Statik dosyaların sunulacağı yol (örneğin, statik bir web ön yüzü)
`BASE_URL`	API'nin ulaşılabileceği temel URL (örneğin, `https://mygramps.mydomain.com/`). Bu, doğru şifre sıfırlama bağlantıları oluşturmak için gereklidir.
`CORS_ORIGINS`	CORS isteklerinin izin verildiği kaynaklar. Varsayılan olarak, hepsi yasaktır. Herhangi bir alan adından istekleri izin vermek için `"*"` kullanın.
`EMAIL_HOST`	SMTP sunucu ana bilgisayarı (örneğin, şifre sıfırlama e-postaları göndermek için)
`EMAIL_PORT`	SMTP sunucu portu. Varsayılan 465'tir.
`EMAIL_HOST_USER`	SMTP sunucu kullanıcı adı
`EMAIL_HOST_PASSWORD`	SMTP sunucu şifresi
`EMAIL_USE_TLS`	Kullanımdan kaldırıldı (bunun yerine `EMAIL_USE_SSL` veya `EMAIL_USE_STARTTLS` kullanın). E-postaları göndermek için TLS kullanılıp kullanılmayacağını belirten boolean. Varsayılan olarak `True`'dur. STARTTLS kullanırken, bunu `False` olarak ayarlayın ve 25'ten farklı bir port kullanın.
`EMAIL_USE_SSL`	SMTP için örtük SSL/TLS kullanılıp kullanılmayacağını belirten boolean (v3.6.0+). `EMAIL_USE_TLS` açıkça ayarlanmamışsa varsayılan olarak `True`'dur. Genellikle 465 portu ile kullanılır.
`EMAIL_USE_STARTTLS`	SMTP için açık STARTTLS kullanılıp kullanılmayacağını belirten boolean (v3.6.0+). Varsayılan olarak `False`'dur. Genellikle 587 veya 25 portu ile kullanılır.
`DEFAULT_FROM_EMAIL`	Otomatik e-postalar için "Gönderen" adresi
`THUMBNAIL_CACHE_CONFIG`	Küçük resim önbelleği için ayarları içeren sözlük. Olası ayarlar için Flask-Caching sayfasına bakın.
`REQUEST_CACHE_CONFIG`	İstek önbelleği için ayarları içeren sözlük. Olası ayarlar için Flask-Caching sayfasına bakın.
`PERSISTENT_CACHE_CONFIG`	Kalıcı önbellek için ayarları içeren sözlük, örneğin telemetri için kullanılır. Olası ayarlar için Flask-Caching sayfasına bakın.
`CELERY_CONFIG`	Celery arka plan görev kuyruğu için ayarlar. Olası ayarlar için Celery sayfasına bakın.
`REPORT_DIR`	Gramps raporlarının çıktısının saklanacağı geçici dizin
`EXPORT_DIR`	Gramps veritabanasının dışa aktarım çıktısının saklanacağı geçici dizin
`REGISTRATION_DISABLED`	Eğer `True` ise, yeni kullanıcı kaydını engelle (varsayılan `False`)
`DISABLE_TELEMETRY`	Eğer `True` ise, istatistik telemetrisini devre dışı bırak (varsayılan `False`). Ayrıntılar için telemetri sayfasına bakın.
`PILLOW_MAX_IMAGE_PIXELS`	İşlenen görüntünün içerebileceği piksel sayısını belirten PIL.Image.MAX_IMAGE_PIXELS parametresini ayarlar. Ayrıntılar için belgeler sayfasına bakın.

Info

Yapılandırma için ortam değişkenleri kullanırken, EMAIL_USE_TLS gibi boolean seçenekler ya true ya da false (büyük/küçük harf duyarlı!) olmalıdır.

Sadece PostgreSQL arka uç veritabanı için ayarlar¶

Eğer Gramps veritabanınızı PostgreSQL eklentisi ile çalışacak şekilde yapılandırdıysanız, bu gereklidir.

Anahtar	Açıklama
`POSTGRES_USER`	Veritabanı bağlantısı için kullanıcı adı
`POSTGRES_PASSWORD`	Veritabanı kullanıcısı için şifre

Birden fazla ağaç barındırma ile ilgili ayarlar¶

Ağaçları birden fazla barındırma durumunda aşağıdaki ayarlar geçerlidir.

Anahtar	Açıklama
`MEDIA_PREFIX_TREE`	Her ağacın medya dosyaları için ayrı bir alt klasör kullanılıp kullanılmayacağını belirten boolean. Varsayılan olarak `False`'dur, ancak çoklu ağaç kurulumunda `True` kullanılması şiddetle tavsiye edilir.
`NEW_DB_BACKEND`	Yeni oluşturulan aile ağaçları için kullanılacak veritabanı arka ucu. `sqlite`, `postgresql` veya `sharedpostgresql`'den biri olmalıdır. Varsayılan olarak `sqlite`'dır.
`POSTGRES_HOST`	SharedPostgreSQL arka ucu ile çoklu ağaç kurulumunda yeni ağaçlar oluşturmak için kullanılan PostgreSQL sunucusunun ana bilgisayar adı
`POSTGRES_PORT`	SharedPostgreSQL arka ucu ile çoklu ağaç kurulumunda yeni ağaçlar oluşturmak için kullanılan PostgreSQL sunucusunun portu

OIDC kimlik doğrulama ayarları¶

Dış sağlayıcılarla OpenID Connect (OIDC) kimlik doğrulaması kullanmak istiyorsanız bu ayarlar gereklidir. Ayrıntılı kurulum talimatları ve örnekler için OIDC Kimlik Doğrulama sayfasına bakın.

Anahtar	Açıklama
`OIDC_ENABLED`	OIDC kimlik doğrulamasını etkinleştirip etkinleştirmeyeceğini belirten boolean. Varsayılan olarak `False`'dur.
`OIDC_ISSUER`	OIDC sağlayıcı verici URL'si (özel OIDC sağlayıcıları için)
`OIDC_CLIENT_ID`	OAuth istemci kimliği (özel OIDC sağlayıcıları için)
`OIDC_CLIENT_SECRET`	OAuth istemci sırrı (özel OIDC sağlayıcıları için)
`OIDC_NAME`	Sağlayıcı için özel görüntüleme adı. Varsayılan olarak "OIDC"dır.
`OIDC_SCOPES`	OAuth kapsamları. Varsayılan olarak "openid email profile"dır.
`OIDC_USERNAME_CLAIM`	Kullanıcı adı için kullanılacak talep. Varsayılan olarak "preferred_username"dır.
`OIDC_OPENID_CONFIG_URL`	İsteğe bağlı: OpenID Connect yapılandırma uç noktasının URL'si (standart `/.well-known/openid-configuration` kullanılmıyorsa)
`OIDC_DISABLE_LOCAL_AUTH`	Yerel kullanıcı adı/şifre kimlik doğrulamasını devre dışı bırakıp bırakmayacağını belirten boolean. Varsayılan olarak `False`'dur.
`OIDC_AUTO_REDIRECT`	Sadece bir sağlayıcı yapılandırıldığında otomatik olarak OIDC'ye yönlendirilip yönlendirilmeyeceğini belirten boolean. Varsayılan olarak `False`'dur.

Yerleşik OIDC sağlayıcıları¶

Yerleşik sağlayıcılar (Google, Microsoft, GitHub) için bu ayarları kullanın:

Anahtar	Açıklama
`OIDC_GOOGLE_CLIENT_ID`	Google OAuth için istemci kimliği
`OIDC_GOOGLE_CLIENT_SECRET`	Google OAuth için istemci sırrı
`OIDC_MICROSOFT_CLIENT_ID`	Microsoft OAuth için istemci kimliği
`OIDC_MICROSOFT_CLIENT_SECRET`	Microsoft OAuth için istemci sırrı
`OIDC_GITHUB_CLIENT_ID`	GitHub OAuth için istemci kimliği
`OIDC_GITHUB_CLIENT_SECRET`	GitHub OAuth için istemci sırrı

OIDC Rol Eşlemesi¶

Bu ayarlar, kimlik sağlayıcınızdan OIDC gruplarını/rollerini Gramps Web kullanıcı rollerine eşlemenizi sağlar:

Anahtar	Açıklama
`OIDC_ROLE_CLAIM`	Kullanıcının gruplarını/rollerini içeren OIDC token'ındaki talep adı. Varsayılan olarak "groups"dır.
`OIDC_GROUP_ADMIN`	Gramps "Admin" rolüne eşlenen OIDC sağlayıcınızdaki grup/rol adı
`OIDC_GROUP_OWNER`	Gramps "Owner" rolüne eşlenen OIDC sağlayıcınızdaki grup/rol adı
`OIDC_GROUP_EDITOR`	Gramps "Editor" rolüne eşlenen OIDC sağlayıcınızdaki grup/rol adı
`OIDC_GROUP_CONTRIBUTOR`	Gramps "Contributor" rolüne eşlenen OIDC sağlayıcınızdaki grup/rol adı
`OIDC_GROUP_MEMBER`	Gramps "Member" rolüne eşlenen OIDC sağlayıcınızdaki grup/rol adı
`OIDC_GROUP_GUEST`	Gramps "Guest" rolüne eşlenen OIDC sağlayıcınızdaki grup/rol adı

Sadece AI özellikleri için ayarlar¶

Chat veya anlamsal arama gibi AI destekli özellikleri kullanmak istiyorsanız bu ayarlar gereklidir.

Anahtar	Açıklama
`LLM_BASE_URL`	OpenAI uyumlu chat API'si için temel URL. Varsayılan olarak `None`, bu OpenAI API'sini kullanır.
`LLM_MODEL`	OpenAI uyumlu chat API'si için kullanılacak model. Ayarlanmadığında (varsayılan), chat devre dışıdır. v3.6.0 itibarıyla, AI asistanı, araç çağırma yetenekleri ile Pydantic AI kullanır.
`VECTOR_EMBEDDING_MODEL`	Anlamsal arama vektör gömme işlemleri için kullanılacak Sentence Transformers modeli. Ayarlanmadığında (varsayılan), anlamsal arama ve chat devre dışıdır.
`LLM_MAX_CONTEXT_LENGTH`	LLM'ye sağlanan aile ağacı bağlamı için karakter sınırı. Varsayılan olarak 50000'dir.
`LLM_SYSTEM_PROMPT`	LLM chat asistanı için özel sistem istemi (v3.6.0+). Ayarlanmadığında, varsayılan soybilim optimize edilmiş istemi kullanılır.

Örnek yapılandırma dosyası¶

Üretim için minimal bir yapılandırma dosyası şu şekilde görünebilir: ```python TREE="Ailem Ağacı" BASE_URL="https://mytree.example.com" SECRET_KEY="..." # gizli anahtarınız USER_DB_URI="sqlite:////path/to/users.sqlite" EMAIL_HOST="mail.example.com" EMAIL_PORT=465 EMAIL_USE_SSL=True # 465 portu için örtük SSL kullan EMAIL_HOST_USER="gramps@example.com" EMAIL_HOST_PASSWORD="..." # SMTP şifreniz DEFAULT_FROM_EMAIL="gramps@example.com"