# Depolama, yedekler ve limitler

Tüm Oleafly Server ayarları, dosyaları diskte veya S3 kovasında depolama, derlenmiş PDF'ler, vekil sunucu arkasında çalıştırma, tek bir ağdaki sınıflar ve her hesap için limitler, günlükler, yedekler, geri yükleme ve güncellemeler.

Bu sayfa Oleafly Server'ı gündelik olarak çalıştırmayı ele alır. Kurmak için [İş birliği sunucusu çalıştırma](/docs/collaboration/server/) ile başlayın.

## Ayarlar

Sunucu ayarlarını ortam değişkenlerinden okur. Ayarlanmış ama boş olan bir değişken, ayarlanmamış sayılır. Bir ayar eksik veya bozuksa sunucu başlamaz ve günlüğü hangisi olduğunu söyler.

| Değişken | Ne yapar | Varsayılan |
| --- | --- | --- |
| `OLEAFLY_PUBLIC_URL` | Kişilerin Oleafly'de girdiği HTTPS adresi. `https://www.cs.example.edu/oleafly` gibi bir yol içerebilir. Zorunlu. Compose ve Coolify dosyaları bunu sizin için ayarlar. | Yok |
| `OLEAFLY_BIND` | Sunucunun dinlediği adres ve port. | `0.0.0.0:8080` |
| `OLEAFLY_DATA_DIR` | Veritabanının ve depolanan dosyaların bulunduğu klasör. | `/data` |
| `OLEAFLY_SERVER_NAME` | Kişilerin Oleafly'de gördüğü ad, örneğin `Smith Lab`. | `Oleafly Server` |
| `OLEAFLY_SERVER_ICON_URL` | Adın yanında gösterilen kare bir görselin HTTPS adresi. | Yok |
| `OLEAFLY_SETUP_CODE` | Kendi tek kullanımlık kurulum kodunuz: en az 12 harf veya rakam; isterseniz tire veya boşlukla. Sağlanmazsa sunucu bir tane üretir. | Üretilir |
| `OLEAFLY_GITHUB_CLIENT_ID`, `OLEAFLY_GITHUB_CLIENT_SECRET` | GitHub ile oturum açmayı açar. | Kapalı |
| `OLEAFLY_GITHUB_URL` | Bir GitHub Enterprise Server'ın adresi. | `https://github.com` |
| `OLEAFLY_GITHUB_API_URL` | GitHub API adresi, sizinki alışılmadıksa. | `https://api.github.com` ya da `OLEAFLY_GITHUB_URL` altında `/api/v3` |
| `OLEAFLY_GITHUB_LABEL` | GitHub oturum açma düğmesindeki metin. | `GitHub` |
| `OLEAFLY_OIDC_<NAME>_ISSUER`, `OLEAFLY_OIDC_<NAME>_CLIENT_ID`, `OLEAFLY_OIDC_<NAME>_CLIENT_SECRET` | `<NAME>` adlı bir OpenID Connect sağlayıcısını açar. | Kapalı |
| `OLEAFLY_OIDC_<NAME>_LABEL` | Oturum açma düğmesindeki metin, örneğin `University login`. | `<NAME>` |
| `OLEAFLY_OIDC_<NAME>_TRUST_EMAIL` | Bu sağlayıcıdan gelen her e-posta adresini doğrulanmış sayar. Önce [Doğrulanmış e-posta adresleri](/docs/collaboration/server-access/#verified-email-addresses) bölümünü okuyun. | `false` |
| `OLEAFLY_SMTP_URL`, `OLEAFLY_MAIL_FROM` | E-posta. [E-posta](/docs/collaboration/server-access/#email) bölümünü okuyun. | Kapalı |
| `OLEAFLY_OPEN_SIGNUP` | Sağlayıcılarınızdan biriyle oturum açan herkese üye olarak bir hesap verir. [Açık kayıt](/docs/collaboration/server-access/#open-sign-up) bölümünü okuyun. | `false` |
| `OLEAFLY_WEB` | Tarayıcı erişimini açar. [Tarayıcı erişimi](/docs/collaboration/server-access/#browser-access) bölümünü okuyun. | `false` |
| `OLEAFLY_BLOB_STORE` | Şekiller ve PDF'ler gibi dosyaların nerede saklandığı. `fs` bunları `OLEAFLY_DATA_DIR` içinde tutar. `s3://lab-bucket` veya `s3://lab-bucket/oleafly` gibi bir adres, bunları bir kovada tutar. | `fs` |
| `OLEAFLY_S3_ENDPOINT` | Amazon S3 dışında bir S3 uyumlu deponun adresi, örneğin MinIO veya Cloudflare R2. Amazon S3 için boş bırakın. | Amazon S3 |
| `OLEAFLY_S3_REGION` | Kovanın bölgesi. | `us-east-1` |
| `OLEAFLY_S3_ACCESS_KEY_ID`, `OLEAFLY_S3_SECRET_ACCESS_KEY` | Sunucunun kova için kullandığı anahtar. `s3://` adresiyle zorunludur. | Yok |
| `OLEAFLY_MAX_PROJECT_MB` | Sunucunun kabul ettiği en büyük proje, megabayt cinsinden. | `200` |
| `OLEAFLY_MAX_FILE_MB` | En büyük tek dosya, megabayt cinsinden. | `50` |
| `OLEAFLY_MAX_MEMBERS_PER_PROJECT` | Bir projedeki en fazla kişi sayısı. | `20` |
| `OLEAFLY_ACCOUNT_STORAGE_MB` | Bir hesabın sahip olduğu projelerin en fazla ne kadar yer kaplayabileceği, megabayt cinsinden. [Hesap başına limitler](#limits-per-account) bölümünü okuyun. | Limit yok; açık kayıtla `100` |
| `OLEAFLY_MAX_PROJECTS_PER_ACCOUNT` | Bir hesabın sahip olabileceği en fazla paylaşılan proje sayısı. | Limit yok; açık kayıtla `50` |
| `OLEAFLY_UPLOADS_PER_HOUR` | Bir hesabın bir saatte yapabileceği dosya ve anlık görüntü yükleme sayısı. | Limit yok; açık kayıtla `300` |
| `OLEAFLY_SIGN_IN_BURST` | Bir ağ adresinin art arda gelen bir istek dizisinde kaç oturum açma isteği gönderebileceği. Tek bir oturum açma yaklaşık altı istek harcar; bu yüzden varsayılan, aynı adresten 50 kişinin aynı anda oturum açmasını karşılar. | `300` |
| `OLEAFLY_SIGN_IN_PER_MINUTE` | İstek dizisinden sonra bir ağ adresinin her dakika geri aldığı oturum açma isteği sayısı. | `120` |
| `OLEAFLY_EMAIL_LINKS_PER_IP` | Sunucunun 15 dakikada tek bir ağ adresindeki kişilere kaç oturum açma e-postası göndereceği. | `100` |
| `OLEAFLY_EMAIL_LINKS_PER_ADDRESS` | Bir e-posta adresinin 15 dakikada alabileceği oturum açma e-postası sayısı. `OLEAFLY_EMAIL_LINKS_PER_IP` değerinden fazla olamaz. | `3` |
| `OLEAFLY_DEVICE_CODES_PER_IP` | Tek bir ağ adresindeki kişilerin 10 dakikada isteyebileceği oturum açma kodu sayısı. | `100` |
| `OLEAFLY_SNAPSHOT_MEMORY_MB` | Sunucunun proje anlık görüntüleri oluştururken kullanabileceği bellek miktarı, megabayt cinsinden. | Kapsayıcının bellek sınırının yarısı; sınır yoksa `1024` |
| `OLEAFLY_BEHIND_PROXY` | Her kişinin adresini, vekil sunucunuzun eklediği `X-Forwarded-For` üstbilgisinden alır. Compose, Coolify ve Render dosyaları bunu açar. | `false` |
| `OLEAFLY_PROXY_HOPS` | Her isteğin sunucuya ulaşmadan önce üzerinden geçtiği vekil sunucu sayısı. `OLEAFLY_BEHIND_PROXY=true` gerektirir. | `1` |
| `OLEAFLY_LOG_LEVEL` | Sunucunun günlüğe ne kadar ayrıntı yazdığı: `error`, `warn`, `info`, `debug` veya `trace`. Sunucunun kullandığı kitaplıklar, `debug` veya `trace` seçmedikçe yalnızca uyarıları günlüğe yazar. | `info` |
| `OLEAFLY_SECURITY_LOG_DAYS` | Güvenlik günlüğü girdilerinin, proje erişim günlüğü girdilerinin ve yanıtlanmış ya da süresi geçmiş konuk davetlerinin kaç gün saklanacağı. | `365` |
| `OLEAFLY_ARCHIVE_DAYS` | Sahibi paylaşmayı bıraktıktan sonra bir projenin kaç gün saklanacağı. | `30` |
| `OLEAFLY_POLL_HOLD_SECONDS` | Bekleyen düzenleme olmadığında sunucunun bir uzun yoklama isteğini kaç saniye açık tutacağı; 1 ile 40 saniye arası. Sunucunun önündeki vekil sunucuların boşta kalma zaman aşımının birkaç saniye altında tutun. | `25` |

Compose `.env` dosyasında, `$` veya `#` içeren bir değeri tek tırnak içine yazın. Gizli bilgi tutan ayarlar dosyalardan da okunabilir. [Gizli bilgileri .env dışında tutma](/docs/collaboration/server/#keep-secrets-out-of-env) bölümünü okuyun.

## Depolama

Varsayılan olarak sunucu her şeyi `OLEAFLY_DATA_DIR` içinde tutar: veritabanı, kişilerin paylaştığı dosyalar ve proje anlık görüntüleri. Anlık görüntüler, kişilerin hızlıca katılmasını ve son durumu yakalamasını sağlayan, her projenin kaydedilmiş kopyalarıdır.

### Kova içindeki dosyalar

Sunucu, dosyaları ve anlık görüntüleri bunun yerine Amazon S3'te ya da MinIO veya Cloudflare R2 gibi S3 uyumlu API'ye sahip başka bir depoda tutabilir. Veritabanı her iki durumda da `OLEAFLY_DATA_DIR` içinde kalır; bu yüzden sunucunun veri klasörüne yine ihtiyacı vardır.

1. Bir kova oluşturun ve ona genel erişimi engelleyin.
2. Yalnızca o kovadaki nesneleri okuyabilen, yazabilen ve silebilen, başka hiçbir şey yapamayan bir anahtar oluşturun. Amazon S3'te bu, `arn:aws:s3:::lab-bucket/*` üzerinde (klasör kullanıyorsanız `arn:aws:s3:::lab-bucket/oleafly/*` üzerinde) `s3:GetObject`, `s3:PutObject` ve `s3:DeleteObject` anlamına gelir.
3. Değişkenleri ayarlayın, örneğin `.env` içinde:

   ```sh
   OLEAFLY_BLOB_STORE=s3://lab-bucket/oleafly
   OLEAFLY_S3_REGION=eu-west-1
   OLEAFLY_S3_ACCESS_KEY_ID=your-access-key-id
   OLEAFLY_S3_SECRET_ACCESS_KEY=your-secret-access-key
   ```

Amazon S3 dışındaki bir depo için ayrıca `OLEAFLY_S3_ENDPOINT` değerini adresine ayarlayın, örneğin `https://minio.example.org:9000` veya `https://<account-id>.r2.cloudflarestorage.com`, ve `OLEAFLY_S3_REGION` değerini beklediği bölgeye ayarlayın (R2 için `auto`). Düz `http://` da çalışır, ancak yalnızca depo sunucuyla aynı özel ağda bulunuyorsa kullanın.

Kova adından sonraki bölüm isteğe bağlı bir klasördür. Her dosya, SHA-256 karmasının adını taşır ve o karmanın ilk iki karakterinin altında yer alır; bu yüzden karması `3f9a` ile başlayan bir dosya `oleafly/3f/3f9a...` olarak saklanır. Anlık görüntülerin, her proje için bir klasör içeren kendi `snapshots` klasörü vardır. Sunucu bir dosyayı veya anlık görüntüyü geri okuduğunda baytları karmayla karşılaştırır ve uymayanı reddeder. Kova olmadığında aynı düzen `OLEAFLY_DATA_DIR` içindeki `blobs` klasöründedir.

Kova bir isteği reddederse o yükleme veya indirme başarısız olur ve sunucu günlüğü kovanın ne dediğini gösterir, örneğin `403 Forbidden (AccessDenied)`. Sunucu hatası, zaman aşımı veya kopan bağlantı farklıdır: sunucu en fazla üç kez dener ve denemeler arasında kısa rastgele bir duraklama yapar. Bir nesneyi silemezse bunu not eder ve 6 saatte bir yapılan her bakım turunda yeniden dener; böylece bir kesinti arkada nesne bırakmaz.

### Anlık görüntüler ve bellek

Bir proje paylaşıldığında, sahibinin uygulaması ilk anlık görüntüyü yükler ve o cihazın anahtarıyla imzalar. O andan itibaren her anlık görüntüyü sunucu kendisi, önceki anlık görüntüden ve o günden bu yana kişilerin gönderdiği değişikliklerden oluşturur. Bir projede son anlık görüntüden sonra 1.000 değişiklik birikince yeni bir anlık görüntü oluşturulur. Sunucu her zaman en az son 2.000 değişikliği tutar; böylece kısa süre uzak kalmış bir cihaz bunlardan güncel hale gelir ve tüm projeyi yeniden indirmez.

Bir anlık görüntü oluşturmak, önceki anlık görüntünün boyutunun yaklaşık on katı artı ondan sonraki değişiklikler kadar yer ister. Sunucu yalnızca `OLEAFLY_SNAPSHOT_MEMORY_MB` içine sığan bir oluşturmaya başlar ve aynı anda çalışan oluşturmalar bu miktarı paylaşır. Bir oluşturma sığmazsa sunucu onu atlar, ne kadar belleğe ihtiyacı olduğunu günlüğe yazar ve projenin tüm değişikliklerini tutar. Cihazlar sonra bu değişikliklerden, her seferinde birkaç megabayt alarak güncel hale gelir. Ayarı yükseltirseniz bir sonraki anlık görüntü oluşturulur. Sunucu, `OLEAFLY_MAX_PROJECT_MB` değerinden büyük bir anlık görüntüyü depolamaz.

### Derlenmiş PDF'ler

Bir sahip ya da düzenleyen paylaşılan bir projeyi başarıyla derlediğinde uygulaması PDF'i, varsa SyncTeX dosyasıyla birlikte sunucuya gönderir. Her proje için dakikada en fazla bir PDF gönderir. Sunucu her proje için bir PDF ve bir SyncTeX dosyası tutar; ana dosyanın adı, kimin derlediği ve ne zaman derlendiğiyle birlikte. [Tarayıcı erişimi](/docs/collaboration/server-access/#browser-access) bu PDF'i projedeki kişilere gösterir.

Her yükleme bir öncekinin yerini alır ve eski dosya, artık hiçbir şey onu kullanmadığında silinir. Derlenmiş dosyalar diğer dosyalarla birlikte, diskte ya da kovada saklanır ve projeleriyle birlikte silinir. Derlenmiş bir dosya `OLEAFLY_MAX_FILE_MB` kadar büyük olabilir. Sahibin [hesap depolama alanından](#limits-per-account) düşer ama saatlik yüklemelere sayılmaz.

Bir projenin her üyesi derlenmiş dosyalarını okuyabilir. Bunları yalnızca sahipler ve düzenleyenler yenileriyle değiştirebilir.

## Ters vekil sunucu arkasında

Sunucu düz HTTP konuşur; bu yüzden HTTPS'yi önündeki bir şey halleder: Compose kurulumunda Caddy, Coolify'nın vekil sunucusu veya üniversitenizinki gibi halihazırda çalıştırdığınız bir web sunucusu. Önünde ne varsa şunları yapmalıdır:

- `OLEAFLY_MAX_PROJECT_MB` kadar büyük istekleri kabul etmek
- İstemcinin adresini `X-Forwarded-For` üstbilgisine eklemek

Ayrıca WebSocket yükseltmelerini `/ws` adresine geçirmeli ve bu bağlantıları en az bir saat açık tutmalıdır. Canlı düzenleme, mümkün olduğunda bunları kullanır. Tarayıcı erişimi açıkken bunları `/web/ws` adresine de geçirmelidir, çünkü tarayıcı uygulamasının daha yavaş bir yedek yolu yoktur.

Sunucuyu yalnızca vekil sunucunun erişebileceği bir yerde çalıştırın. Aynı makinede `OLEAFLY_BIND=127.0.0.1:8080` ayarlayın. Ardından `OLEAFLY_BEHIND_PROXY=true` ayarlayın.

### WebSocket bağlantıları engellendiğinde

Bazı ağlar WebSocket bağlantılarını engeller; genellikle filtreleyen bir vekil sunucu kullanan üniversite veya şirket ağları. Canlı düzenleme orada yine çalışır, daha yavaş. Sunucu HTTPS üzerinden hâlâ yanıt verirken art arda iki WebSocket denemesi başarısız olursa Oleafly, HTTP uzun yoklamasına geçer. Düzenlemeleri `/api/v1/projects/<project>/frames` adresine gönderir ve diğer kişilerin düzenlemelerini `/api/v1/projects/<project>/poll` üzerinde bekler; her isteği en fazla `OLEAFLY_POLL_HOLD_SECONDS` süresince açık tutar. Her düzenleme yine ulaşır. Oleafly her dakika WebSocket'i yeniden dener ve biri bağlanır bağlanmaz ona geri döner.

Oleafly'deki **Bağlantıyı test et** ve yönetici konsolundaki **Bağlantı denetimleri**, bunun olduğunu şöyle söyler: "Bu ağ olağan yolu engellediği için canlı düzenlemeler daha yavaş bir yoldan gidiyor. Yine de ulaşıyorlar."

Vekil sunucuyu sunucunun önünde siz çalıştırıyorsanız, WebSocket yükseltmelerini yine de geçirin. Uzun yoklama çalışır, ancak her düzenleme grubu ek bir isteğe ve biraz daha gecikmeye mal olur.

Bazı vekil sunucular, 30 saniyeden az sessiz kalan bir isteği kapatır; kısa bir `proxy_read_timeout` ile nginx bunlardan biridir. Bunlar uzun yoklama isteklerine 502 veya 504 hatasıyla yanıt verir ve düzenlemeler geç ulaşır. `OLEAFLY_POLL_HOLD_SECONDS` değerini bu zaman aşımının birkaç saniye altına ayarlayın, örneğin 10 saniyelik bir zaman aşımı için `8`.

### OLEAFLY_BEHIND_PROXY neyi değiştirir

Sunucu istemci adresini iki yerde not eder: güvenlik günlüğünde ve bir adresin ne sıklıkla oturum açma başlatabileceğini ya da canlı bağlantı açabileceğini belirleyen [limitlerde](#limits-for-a-class-on-one-network).

Ayar olmadan sunucu, kendisine bağlanan neyse onun adresini kullanır. Bir vekil sunucunun arkasında bu her zaman vekil sunucudur; bu yüzden herkes tek bir limit paylaşır ve güvenlik günlüğünde yalnızca vekil sunucunun adresi görünür.

`OLEAFLY_BEHIND_PROXY=true` ile sunucu `X-Forwarded-For` üstbilgisini okur ve içindeki son adresi, yani vekil sunucunuzun eklediği adresi kullanır. Üstbilgi yoksa veya geçerli bir adres içermiyorsa sunucu, bağlanan tarafın adresine geri döner. Başka hiçbir şey değişmez. Sunucu `X-Forwarded-Proto`, `X-Forwarded-Host` ve `Forwarded` üstbilgilerini yok sayar ve dağıttığı her adresi `OLEAFLY_PUBLIC_URL` üzerinden oluşturur.

Bunu yalnızca her istek vekil sunucunuz üzerinden gelirken açın. Kişiler sunucuya doğrudan da erişebiliyorsa, herhangi biri uydurma bir `X-Forwarded-For` gönderebilir, güvenlik günlüğüne istediği adresi düşürebilir ve oturum açma limitini aşabilir.

Art arda iki vekil sunucu varsa, örneğin Coolify'nın vekil sunucusunun önünde Cloudflare, `OLEAFLY_PROXY_HOPS=2` ayarlayın. Sunucu bu durumda sondan ikinci adresi alır. Yalnızca her isteğin üzerinden geçtiği vekil sunucuları sayın. Doğrudan sunucuya giden bir Cloudflare Tunnel bir olarak sayılır.

Sayıyı denetlemek için kendi bilgisayarınızdan oturum açın ve yönetici konsolunda **Güvenlik günlüğü**'nü açın. En yeni girdi, `ifconfig.me` gibi bir sitenin bildirdiği genel adresinizi göstermelidir. Onun yerine özel bir adres veya Cloudflare adresi gösteriyorsa `OLEAFLY_PROXY_HOPS` değerini bir artırın.

### Caddy

Caddy, WebSocket bağlantılarını ve `X-Forwarded-For` üstbilgisini ek ayar olmadan geçirir ve sertifikayı kendisi alır. [Öne HTTPS koyma](/docs/collaboration/server/#put-https-in-front) bölümünde tam `Caddyfile` vardır.

### nginx

Önce etki alanı için bir sertifika alın, örneğin certbot ile. Sonra bunu `/etc/nginx/conf.d/oleafly.conf` olarak kaydedin ve `sudo nginx -t && sudo systemctl reload nginx` komutunu çalıştırın:

```nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 443 ssl;
    server_name collab.example.org;
    ssl_certificate /etc/letsencrypt/live/collab.example.org/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/collab.example.org/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_read_timeout 1h;
        proxy_send_timeout 1h;
        client_max_body_size 200m;
    }
}
```

`client_max_body_size`, `OLEAFLY_MAX_PROJECT_MB` varsayılanı olan 200 ile eşleşir. Birini yükseltirseniz diğerini de yükseltin.

### Apache

Apache 2.4.47 veya daha yenisine ihtiyacınız vardır; Debian 12 ile Ubuntu 22.04 ve sonraki sürümler bunu içerir. Modülleri açın:

```sh
sudo a2enmod proxy proxy_http ssl
```

Bunu `/etc/apache2/sites-available/oleafly.conf` olarak kaydedin, ardından `sudo a2ensite oleafly && sudo systemctl reload apache2` komutunu çalıştırın:

```apache
<VirtualHost *:443>
    ServerName collab.example.org
    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/collab.example.org/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/collab.example.org/privkey.pem

    ProxyPreserveHost On
    ProxyPass / http://127.0.0.1:8080/ upgrade=websocket timeout=3600
    ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>
```

`upgrade=websocket` WebSocket bağlantılarını geçirir ve `timeout=3600` onları bir saat açık tutar. Apache, istemcinin adresini `X-Forwarded-For` üstbilgisine kendiliğinden ekler.

### Bir yol altında

Sunucu bir yol altında çalışıyorsa, yolu `OLEAFLY_PUBLIC_URL` içine ekleyin, örneğin `https://www.cs.example.edu/oleafly`, ve oturum açma sağlayıcılarına kaydettiğiniz geri çağırma adreslerine de ekleyin. Sunucu, o yol dahil ve yolsuz her iki biçimde de yanıt verir; bu yüzden vekil sunucunuz yolu geçirebilir veya kaldırabilir. nginx ile içinde aynı satırlar bulunan `location /oleafly/ {` kullanın ve nginx yolun üzerinden geçsin diye `proxy_pass http://127.0.0.1:8080;` satırını yolsuz bırakın.

## Tek bir ağdaki bir sınıf için limitler

Bir sınıfın tamamı çoğu zaman tek bir ağ adresinden oturum açar, örneğin bir üniversitenin NAT'ından. Varsayılanlar buna göre ayarlanmıştır:

- **Oturum açmalar**: bir adrese önce 300 oturum açma isteğinden oluşan bir dizinin hakkı verilir, ardından saniyede iki. Bir oturum açma yaklaşık altı istek harcadığından 50 kişi aynı anda oturum açabilir. Bunları `OLEAFLY_SIGN_IN_BURST` ve `OLEAFLY_SIGN_IN_PER_MINUTE` ile değiştirin.
- **E-posta bağlantıları**: 15 dakikada bir adrese 100 ve bir e-posta adresine 3. Bunları `OLEAFLY_EMAIL_LINKS_PER_IP` ve `OLEAFLY_EMAIL_LINKS_PER_ADDRESS` ile değiştirin.
- **Oturum açma kodları**: 10 dakikada bir adresten 100 kod ve 10 yanlış kod. Bunu `OLEAFLY_DEVICE_CODES_PER_IP` ile değiştirin.
- **Canlı bağlantıların** kendi, daha büyük limiti vardır; böylece bir adresin arkasındaki bir sınıfın tamamı yeniden başlatmadan sonra aynı anda yeniden bağlanabilir. Bu limiti yalnızca oturumunu kanıtlayamayan bağlantılar tüketir: önce 300'lük bir dizi, ardından saniyede on. Oturumunu kanıtlayan bir bağlantı ise kendi cihazının hakkından düşer; bir cihaz önce bir dizide 60 kez, ardından saniyede bir kez yeniden bağlanabilir.

Bir `/64` ağındaki tüm IPv6 adresleri tek bir adres sayılır. Bu limitler kişi başına yalnızca sunucu herkesin gerçek adresini gördüğünde işler; bu yüzden [vekil sunucunuzu doğru kurun](#what-oleafly_behind_proxy-changes).

Sunucu her canlı bağlantıya 30 saniyede bir ping gönderir. Bu pingleri 90 saniye boyunca yanıtsız bırakan bir bağlantıyı ve sunucunun gönderdiklerini okumayı bırakan bir bağlantıyı kapatır.

Proje limitleri herkese uygulanır: tüm bir proje için `OLEAFLY_MAX_PROJECT_MB` (varsayılan 200 MB), tek bir dosya için `OLEAFLY_MAX_FILE_MB` (50 MB) ve bir projedeki kişiler için `OLEAFLY_MAX_MEMBERS_PER_PROJECT` (20). Yönetici konsolundaki **Genel bakış**, geçerli limitleri gösterir.

## Hesap başına limitler

Her hesaba üç limit uygulanır. Siz ayarlayana kadar kapalıdırlar; [açık kayıt](/docs/collaboration/server-access/#open-sign-up) açıksa şu varsayılanlarla açılırlar:

| Limit | Ayar | Açık kayıtla |
| --- | --- | --- |
| Bir hesabın sahip olduğu projeler için depolama alanı | `OLEAFLY_ACCOUNT_STORAGE_MB` | 100 MB |
| Bir hesabın sahip olduğu paylaşılan projeler | `OLEAFLY_MAX_PROJECTS_PER_ACCOUNT` | 50 |
| Bir hesabın bir saatte yaptığı yüklemeler | `OLEAFLY_UPLOADS_PER_HOUR` | 300 |

Ayarladığınız bir değer her zaman varsayılanın önüne geçer. Her biri en az 1 olan bir tam sayı olmalıdır.

- **Depolama alanı**, hesabın sahip olduğu her projenin (arşivlenmişler dahil) dosyalarını, değişiklik geçmişini ve derlenmiş PDF'lerini toplar. Anlık görüntüler sayılmaz. Birinin bir projeye eklediği dosya, projenin sahibinin hesabından düşer. Sahibin hesabı dolduğunda sunucu, onun projeleri için yeni dosyaları ve derlenmiş PDF'leri reddeder ve sahip başka bir proje paylaşamaz. Dosya, onu ekleyen kişinin bilgisayarında kalır. Kişilerin yazdığı metin eşitlenmeye devam eder.
- **Paylaşılan projeler**, hesabın paylaştığı projeleri, hâlâ karşıya yüklenmekte olanlar dahil, sayar. Arşivlenmiş projeler sayılmaz; bu yüzden bir projenin paylaşımını durdurmak yer açar.
- **Yüklemeler**, bir saatlik bir zaman aralığındaki her dosya ve anlık görüntü yüklemesini sayar. Derlenmiş PDF'ler sayılmaz. Oleafly, reddedilen bir dosyayı daha sonra kendiliğinden yeniden gönderir.

Yönetici konsolundaki **Genel bakış** bu limitleri göstermez. Açık kayıt açıkken sunucunun günlüğü, her başlangıçta bu limitleri adlarıyla yazar.

## Günlükler

- **Sunucu günlüğü**, `docker compose logs oleafly-server`, Coolify'nın **Logs** bölümü veya `journalctl -u oleafly-server` komutunun gösterdiğidir. `OLEAFLY_LOG_LEVEL`, ne kadar ayrıntı yazacağını belirler.
- **Güvenlik günlüğü**, oturum açmaları ve reddedilen oturum açmaları, cihazları, kişileri, rolleri, ayarları, projeleri ve konukları kaydeder; her birinde saat ve IP adresi bulunur. Yöneticiler ve sorumlular bunu yönetici konsolundaki **Güvenlik günlüğü** altında okur. `OLEAFLY_SECURITY_LOG_DAYS` gününden eski girdiler silinir.
- **Proje erişim günlükleri**, bir projeyi kimin açtığını, projeye katıldığını veya bir kopyasını indirdiğini, cihaz adı ve saatle birlikte kaydeder. **Proje erişim günlüklerine izin ver** açıkken bir projenin sahibi bunu açar ve yalnızca o sahibi okuyabilir. Aynı saklama süresi geçerlidir.

## Yedekler

Eksiksiz bir yedek için ne gerektiği, dosyaların nerede saklandığına bağlıdır:

- **Diskteki dosyalar** (`OLEAFLY_BLOB_STORE=fs`, varsayılan): veritabanı, dosyalar ve anlık görüntülerin tümü veri klasöründedir. Klasörün tamamını yedekleyin.
- **Kovadaki dosyalar**: veri klasörü veritabanını tutar, kova ise dosyaları ve anlık görüntüleri. Veritabanının bir kopyası artı kova, eksiksiz bir yedektir. Yanlışlıkla silinen bir nesnenin geri getirilebilmesi için kova için sürümlemeyi açın.

Düzenli olarak yedek alın ve kopyaları özel tutun, çünkü her projeyi içerirler. `.env` gibi ayarlarınız veri klasöründe değildir; bu yüzden onların da bir kopyasını tutun.

Docker ile, birimi kopyalarken sunucu birkaç saniye durur. Oleafly kendi kendine yeniden bağlanır. Bu komutları sunucunun klasöründe çalıştırın; yükleyiciyi kullandıysanız `/opt/oleafly-server`.

```sh
cd /opt/oleafly-server
sudo docker compose stop oleafly-server
sudo docker run --rm -v oleafly-server_oleafly-data:/data:ro -v "$PWD":/backup debian:13.7-slim tar -C /data -czf /backup/oleafly-data-$(date +%F).tar.gz .
sudo docker compose start oleafly-server
```

systemd ile:

```sh
sudo systemctl stop oleafly-server
sudo tar -C /var/lib/private/oleafly-server -czf /root/oleafly-data-$(date +%F).tar.gz .
sudo systemctl start oleafly-server
```

Arşivi başka bir makineye kopyalayın.

Coolify'da birimin adı, kaynağın kimliğiyle başlar. `docker volume ls --filter name=oleafly-data` ile bulun, `oleafly-server_oleafly-data` yerine kullanın ve sunucuyu `docker compose` yerine Coolify'nın panelinden durdurup başlatın.

### Geri yükleme tatbikatı

Hiç geri yüklemediğiniz bir yedek yalnızca bir umuttur. Bu tatbikat, sunucunun ikinci bir kopyasını bir yedekten başlatır, çalışmakta olanı olduğu gibi bırakır ve ikisinin de aynı sunucu olduğunu denetler. Kendi arşivinizin tarihini `2026-10-11` yerine kullanın.

```sh
cd /opt/oleafly-server
sudo docker volume create oleafly-restore-drill
sudo docker run --rm -v oleafly-restore-drill:/data -v "$PWD":/backup:ro debian:13.7-slim tar -C /data -xzf /backup/oleafly-data-2026-10-11.tar.gz
sudo docker run -d --name oleafly-restore-drill -v oleafly-restore-drill:/data -e OLEAFLY_PUBLIC_URL=https://restore-drill.invalid -e OLEAFLY_GITHUB_CLIENT_ID=restore-drill -e OLEAFLY_GITHUB_CLIENT_SECRET=restore-drill "$(sudo docker compose images -q oleafly-server)"
sudo docker run --rm --network container:oleafly-restore-drill curlimages/curl:8.22.0 -fsS --retry 10 --retry-connrefused --retry-delay 1 http://127.0.0.1:8080/.well-known/oleafly-server
curl -fsS https://collab.example.org/.well-known/oleafly-server
```

İki yanıttaki `server_id` eşleşmelidir. Tatbikat kopyasında kimseyi oturum açtıramayan yer tutucu bir GitHub oturum açması vardır ve açık portu yoktur; bu yüzden kimse onu kullanamaz. İşiniz bittiğinde kaldırın:

```sh
sudo docker rm -f oleafly-restore-drill
sudo docker volume rm oleafly-restore-drill
```

### Geri yükleme

Docker Compose ile gerçekten geri yüklemek için sunucuyu durdurun, birimin içeriğini arşivle değiştirin ve yeniden başlatın:

```sh
cd /opt/oleafly-server
sudo docker compose stop oleafly-server
sudo docker run --rm -v oleafly-server_oleafly-data:/data -v "$PWD":/backup:ro debian:13.7-slim sh -c 'find /data -mindepth 1 -delete && tar -C /data -xzf /backup/oleafly-data-2026-10-11.tar.gz'
sudo docker compose start oleafly-server
```

systemd ile:

```sh
sudo systemctl stop oleafly-server
sudo find /var/lib/private/oleafly-server -mindepth 1 -delete
sudo tar -C /var/lib/private/oleafly-server -xzf /root/oleafly-data-2026-10-11.tar.gz
sudo systemctl start oleafly-server
```

Geri yüklenmiş bir sunucuda, kişilerin yedekten sonra yaptığı değişiklikler eksiktir. Her uygulama, açık kalmış ya da sonradan açılmış olsun, yeniden bağlandığında bunu fark eder ve kendi eksik değişikliklerini yeniden gönderir. Bunun için kimsenin bir şey yapması gerekmez. Başka birinin eksik değişikliğine dayanan bir değişiklik, o kişi projeyi açana dek bekler, çünkü değişikliklerini yalnızca onun uygulaması gönderebilir. Sorun olduğu sırada düzenleme yapan herkesten, projeyi bir kez açmalarını isteyin.

### Litestream ile sürekli kopyalar

Bir arşiv, yalnızca oluşturduğunuz anda orada olanı içerir. [Litestream](https://litestream.io), sunucunun veritabanındaki her değişikliği, olduktan yaklaşık bir saniye sonra S3 uyumlu bir kovaya kopyalar. Compose dosyası bunu isteğe bağlı bir hizmet olarak içerir.

Litestream yalnızca veritabanını kopyalar. Dosyalar bir kovadaysa kova zaten dosyaları ve anlık görüntüleri tutar; bu yüzden Litestream kopyası ile kova birlikte kayıp bir diski geri getirebilir. Dosyalar diskteyse birimin arşivlerini de almaya devam edin, çünkü Litestream `blobs` klasörünü kopyalamaz.

1. Yalnızca bu sunucunun Litestream'inin kullandığı bir kova veya bir kovanın içindeki bir klasör oluşturun. `OLEAFLY_BLOB_STORE` ile paylaşmayın. Litestream'e, kovayı listeleyebilen ve içindeki nesneleri okuyup yazabilen ve silebilen bir anahtar verin.
2. Ayrıntıları `.env` dosyasına ekleyin:

   ```sh
   LITESTREAM_REPLICA_URL=s3://lab-backups/oleafly-server
   LITESTREAM_REGION=eu-west-1
   LITESTREAM_ACCESS_KEY_ID=your-access-key-id
   LITESTREAM_SECRET_ACCESS_KEY=your-secret-access-key
   COMPOSE_PROFILES=litestream
   ```

   Amazon S3 dışındaki bir depo için ayrıca `LITESTREAM_ENDPOINT` değerini adresine ve `LITESTREAM_REGION` değerini beklediği bölgeye ayarlayın (R2 için `auto`). `COMPOSE_PROFILES`, her `docker compose` komutunun Litestream'i içermesini sağlar.
3. Başlatın:

   ```sh
   sudo docker compose up -d
   ```

4. Veritabanını kopyaladığını denetleyin. Bu, `snapshot complete` içeren bir satır yazdırır:

   ```sh
   sudo docker compose logs litestream | grep 'snapshot complete'
   ```

Litestream günde bir kez tam kopya alır ve bir haftalık kopyayla aralarındaki değişiklikleri tutar. Zamanlama `litestream.yml` içindedir.

#### Litestream geri yükleme tatbikatı

Bu tatbikat, veritabanını kovadan geçici bir birime geri yükler, üzerinde sunucunun ikinci bir kopyasını başlatır ve ikisinin de aynı sunucu olduğunu denetler. Çalışan sunucuya dokunulmaz.

```sh
cd /opt/oleafly-server
sudo docker run --rm -v oleafly-litestream-drill:/data "$(sudo docker compose images -q oleafly-server)" --version
sudo docker compose run --rm --no-deps -v oleafly-litestream-drill:/restore litestream restore -config /etc/litestream.yml -o /restore/oleafly-server.sqlite3 /data/oleafly-server.sqlite3
sudo docker run -d --name oleafly-litestream-drill -v oleafly-litestream-drill:/data -e OLEAFLY_PUBLIC_URL=https://restore-drill.invalid -e OLEAFLY_GITHUB_CLIENT_ID=restore-drill -e OLEAFLY_GITHUB_CLIENT_SECRET=restore-drill "$(sudo docker compose images -q oleafly-server)"
sudo docker run --rm --network container:oleafly-litestream-drill curlimages/curl:8.22.0 -fsS --retry 10 --retry-connrefused --retry-delay 1 http://127.0.0.1:8080/.well-known/oleafly-server
curl -fsS https://collab.example.org/.well-known/oleafly-server
```

İlk komut, geçici birimi sunucunun ihtiyaç duyduğu sahibiyle oluşturur. Son iki yanıttaki `server_id` eşleşmelidir. İşiniz bittiğinde kopyayı kaldırın:

```sh
sudo docker rm -f oleafly-litestream-drill
sudo docker volume rm oleafly-litestream-drill
```

#### Veritabanını Litestream'den geri yükleme

Veritabanı dosyası bozulmuş ya da kaybolmuş ama veri klasörünün geri kalanı sağlamsa sunucuyu ve Litestream'i durdurun, veritabanından geriye kalanı kaldırın, geri yükleyin ve yeniden başlatın:

```sh
cd /opt/oleafly-server
sudo docker compose stop oleafly-server litestream
sudo docker run --rm -v oleafly-server_oleafly-data:/data debian:13.7-slim rm -rf /data/oleafly-server.sqlite3 /data/oleafly-server.sqlite3-wal /data/oleafly-server.sqlite3-shm /data/.oleafly-server.sqlite3-litestream
sudo docker compose run --rm --no-deps litestream restore -config /etc/litestream.yml /data/oleafly-server.sqlite3
sudo docker compose up -d
```

Dosyaların kovada olduğu bir disk kaybından sonra, yukarıdaki komutları yeni, boş birimde çalıştırın ve `.env` içindeki kova ayarlarını aynı tutun. Her proje, dosyalarıyla ve anlık görüntüleriyle geri gelir.

Dosyaların diskte olduğu bir disk kaybından sonra en yeni arşivinizi [geri yükleyin](#restore) ve işi orada bırakın. Litestream'den gelen daha yeni bir veritabanını daha eski bir arşivin üstüne koymayın. Veritabanı, arşivde bulunmayan dosyalara ve anlık görüntülere işaret ederdi ve o projeler açılmazdı.

## Güncelleme

Önce yedek alın. Sunucu, yeni bir sürüm ilk kez başladığında veritabanını günceller; bu yüzden eski bir sürüme dönmek, güncellemeden önce aldığınız yedeği geri yüklemek demektir.

- **Tek komutla kurulum**: `curl -fsSL https://oleafly.com/server/install.sh | sudo sh -s -- update` komutunu çalıştırın. `.env` dosyasını korur, yeni sürümün dosyalarını ve imajını alır ve sunucuyu yeniden başlatır.
- **Docker Compose'u elle kurma**: [Docker Compose'u elle kurma](/docs/collaboration/server/#docker-compose-by-hand) bölümündeki gibi yeni sürümün dosyalarını sunucunun klasörüne indirin, ardından `sudo docker compose up -d` komutunu çalıştırın.
- **Coolify**: **Redeploy** düğmesini seçin. Yayınlanan imajla bu, imajın etiketi altındaki en yeni sürümü çeker.
- **Render**: hizmeti açın ve elle bir dağıtım başlatın; bu, imajı yeniden çeker.
- **Railway**: hizmeti menüsünden yeniden dağıtın. Railway, GitHub'ın kayıt defterindeki bir imajı kendi kendine de güncelleyebilir.
- **systemd**: yeni sürümü [Sunucuyu indirin](/docs/collaboration/server/#download-the-server) bölümündeki gibi kurun, ardından `sudo systemctl restart oleafly-server` komutunu çalıştırın.

Oleafly, her bağlanışında sunucunun sürümünü denetler. Uygulama ile sunucu birlikte çalışamıyorsa Oleafly, hangisinin güncellenmesi gerektiğini söyler.
