Hızlı Başlangıç

Docker Compose ile çalıştırın

git clone https://github.com/kutupbt/kutup.git
cd kutup
cp .env.example .env
# .env dosyasını düzenleyin — POSTGRES_PASSWORD, JWT_SECRET için güçlü değerler ayarlayın,
# S3_SECRET_KEY, ADMIN_ACCOUNT.
mkdir -p nginx/certs
openssl req -x509 -nodes -newkey rsa:2048 -days 365 \
  -keyout nginx/certs/privkey.pem -out nginx/certs/fullchain.pem \
  -subj /CN=localhost -addext subjectAltName=DNS:localhost,IP:127.0.0.1
docker compose up -d --build --wait

Hız sınırları, çöp saklama ve SERVER_URL dahil olmak üzere her ortam değişkeni, Kendi Sunucunda Barındırma kılavuzunda belgelenmiştir.

İlk giriş

https://localhost:38443 adresini açın, yerel kendinden imzalı sertifika uyarısını kabul edin ve ADMIN_ACCOUNT kimlik bilgileriyle oturum açın. Oluşturulan kurtarma ifadesini güvenli biçimde kaydedin. HTTP 38080, HTTPS 38443’e yönlendirir. Bu önyükleme hesabı korumalı acil durum yöneticisidir; yetkisi düşürülemez, devre dışı bırakılamaz veya silinemez.

Office düzenleme dahildir

.docx, .xlsx ve .pptx düzenleme varsayılan Compose derlemesinde çalışır. OnlyOffice DocumentServer veya elle kurulum gerekmez. Entegrasyon ayrıntıları için OnlyOffice kılavuzuna bakın.

Üretime geçiyoruz

Gerçek bir dağıtım için aşağıdakileri kapsayan Kendi Sunucunda Barındırma kılavuzunu izleyin:

• TLS / HTTPS — paketlenmiş Nginx’e bir sertifika ekleme veya Certbot kullanma.
• Mevcut bir ters proxy’nin arkasında çalışma — yığının önünde Nginx veya Caddy’yi barındırın.
• Depolama ve yedeklemeler — neyin yedekleneceği ve nasıl yedekleneceği.
• Güvenliği güçlendirme — güvenlik duvarı, sırlar, kotalar ve acil durum yöneticisi.