Nextcloud Server Apache, PHP-FPM ve MariaDB ile elle nasıl kurulur

Nextcloud Server; dosya eşitleme ve paylaşma, takvim, kişiler ve iş birliği için kendi sunucunuzda çalıştırdığınız açık kaynaklı bir platformdur. Bu rehber onu, güncel ana sürüm olan Nextcloud 35'in yönetici kılavuzunu izleyerek resmi arşivden elle kurar. PHP-FPM'li Apache'yi, MariaDB'yi, APCu ve Redis önbelleğini, doğrulanmış bir indirmeyi, komut satırı kurulumunu, Certbot ile HTTPS'i, systemd zamanlayıcısıyla arka plan işlerini ve kılavuzdaki yedekleme, geri yükleme ve yükseltme yöntemlerini kurarsınız.

Elle kurulum size tam denetim verir; ama her bileşenin sorumluluğu da sizde olur. Kendini güncelleyen ve yedekleyen konteynerleri tercih ediyorsanız bunun yerine Nextcloud All-in-One kullanın.

Adım 1 — Apache, PHP-FPM, MariaDB ve Redis'i kurun

Kılavuz, mod_php veya PHP-FPM ile Apache 2.4'ü ya da PHP-FPM ile Nginx'i listeler. Bu rehber, PHP'yi kendi servisinde çalıştıran ve PHP süreç sayısını ayarlamanıza izin veren PHP-FPM'li Apache'yi kullanır. Kılavuzun Ubuntu örneğindeki paketleri PHP-FPM ve önbellek modülleriyle birlikte kurun:

sudo apt update && sudo apt upgrade
sudo apt install apache2 mariadb-server redis-server bzip2 php-fpm php-cli php-gd php-mysql php-curl php-mbstring php-intl php-gmp php-xml php-imagick php-zip php-apcu php-redis

PHP'yi ve modülleri kontrol edin:

php -v
php -m | grep -E "apcu|redis|imagick|intl"
systemctl status redis-server mariadb --no-pager

php -v 8.3, 8.4 veya 8.5 göstermeli, modül listesinde ise dört adın tamamı bulunmalıdır.

Adım 2 — PHP'yi yapılandırın

PHP sürümünüzü bir değişkene kaydedin, ardından kılavuzun istediği bellek sınırını ayarlayın. Nextcloud'un komut satırı aracı occ, varsayılan olarak kapalı olan CLI için APCu'nun da açık olmasını gerektirir:

PHP_VER=$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;')
echo $PHP_VER
sudo tee /etc/php/$PHP_VER/fpm/conf.d/90-nextcloud.ini <<'EOF'
memory_limit = 512M
EOF
sudo tee /etc/php/$PHP_VER/cli/conf.d/90-nextcloud.ini <<'EOF'
memory_limit = 512M
apc.enable_cli = 1
EOF
sudo systemctl restart php$PHP_VER-fpm
php -i | grep -E "memory_limit|apc.enable_cli"

Son komut 512M ve On göstermelidir.

Adım 3 — Veritabanını oluşturun

openssl rand -hex 24 ile güçlü bir parola üretin, ardından sudo mariadb ile MariaDB kabuğunu açın ve şunları çalıştırın:

CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY 'change-me';
CREATE DATABASE IF NOT EXISTS nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';
FLUSH PRIVILEGES;
quit;

change-me yerine ürettiğiniz parolayı yazın. Nextcloud tablolarını kurulum sırasında oluşturur.

Adım 4 — Nextcloud'u indirin ve doğrulayın

En son sürümü, sağlama toplamını ve imzasını download.nextcloud.com adresinden, Nextcloud'un genel anahtarıyla birlikte indirin:

cd /tmp
wget https://download.nextcloud.com/server/releases/latest.tar.bz2
wget https://download.nextcloud.com/server/releases/latest.tar.bz2.sha256
wget https://download.nextcloud.com/server/releases/latest.tar.bz2.asc
wget https://nextcloud.com/nextcloud.asc
sha256sum -c --ignore-missing latest.tar.bz2.sha256
gpg --import nextcloud.asc
gpg --verify latest.tar.bz2.asc latest.tar.bz2

sha256sum mutlaka latest.tar.bz2: OK yazmalı, gpg ise geçerli bir imza (good signature) bildirmelidir. Yeni içe aktardığınız bir anahtar için anahtarın güvenilir bir imzayla onaylanmadığı uyarısı normaldir. Kontrollerden biri başarısız olursa dosyaları silip yeniden indirin.

Arşivi web köküne açın ve sıkılaştırma kılavuzunun önerdiği gibi web kökünün dışında bir veri klasörü oluşturun:

sudo tar -xjf latest.tar.bz2 -C /var/www
sudo chown -R www-data:www-data /var/www/nextcloud
sudo mkdir -p /srv/nextcloud/data
sudo chown -R www-data:www-data /srv/nextcloud

Adım 5 — Apache'yi yapılandırın

sudo nano ile /etc/apache2/sites-available/nextcloud.conf dosyasını oluşturun ve kılavuzdaki sanal sunucuyu ekleyin. FilesMatch bloğu, WebDAV istemcilerinin ihtiyaç duyduğu Authorization başlığını PHP-FPM'e iletir:

<VirtualHost *:80>
  ServerName cloud.example.com
  DocumentRoot /var/www/nextcloud/

  <Directory /var/www/nextcloud/>
    Require all granted
    AllowOverride All
    Options FollowSymLinks MultiViews

    <IfModule mod_dav.c>
      Dav off
    </IfModule>
  </Directory>

  ProxyFCGIBackendType FPM
  <FilesMatch remote.php>
    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
  </FilesMatch>
</VirtualHost>

Kılavuzun gerekli ve önerilen saydığı modülleri açın, Apache'yi PHP-FPM'e bağlayın ve siteleri değiştirin:

PHP_VER=$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;')
sudo a2enmod proxy proxy_fcgi setenvif rewrite headers env dir mime
sudo a2enconf php$PHP_VER-fpm
sudo a2ensite nextcloud.conf
sudo a2dissite 000-default.conf
sudo apache2ctl configtest
sudo systemctl restart apache2
apache2ctl -M | grep -E "rewrite|proxy_fcgi|mpm"

configtest çıktısı Syntax OK olmalı, modül listesinde ise rewrite_module, proxy_fcgi_module ve mpm_event_module görünmelidir.

Adım 6 — Nextcloud'u komut satırından kurun

Kurulum aracını web sunucusu kullanıcısıyla çalıştırın. Araç Adım 3'teki veritabanı parolasını ve yeni bir yönetici parolasını sorar; böylece ikisi de kabuk geçmişinize düşmez:

sudo -E -u www-data php /var/www/nextcloud/occ maintenance:install \
  --database mysql --database-name nextcloud \
  --database-user nextcloud \
  --admin-user admin \
  --data-dir /srv/nextcloud/data

mysql türü MariaDB'yi de kapsar. İşlem bitince Nextcloud'un başarıyla kurulduğunu yazar. Şimdi alan adınızı güvenilen alan adlarına ekleyin, genel adresi ayarlayın ve index.php içermeyen adresleri açın:

cd /var/www/nextcloud
sudo -E -u www-data php occ config:system:set trusted_domains 1 --value=cloud.example.com
sudo -E -u www-data php occ config:system:set overwrite.cli.url --value=https://cloud.example.com
sudo -E -u www-data php occ config:system:set htaccess.RewriteBase --value=/
sudo -E -u www-data php occ maintenance:update:htaccess
sudo -E -u www-data php occ config:system:get trusted_domains

Son komut localhost ve cloud.example.com değerlerini listeler. Nextcloud'a erişmek için kullandığınız her sunucu adı bu listede olmalıdır.

Adım 7 — HTTPS'i ve güvenlik duvarını açın

Yalnızca SSH ve web trafiğine izin verin, ardından Certbot'un Apache eklentisiyle bir Let's Encrypt sertifikası alın. Certbot bir TLS sanal sunucusu ve --redirect ile HTTP'den HTTPS'e bir yönlendirme ekler:

sudo apt install ufw
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d cloud.example.com --redirect
sudo certbot renew --dry-run

Burada dağıtımınızın Certbot paketleri kullanılır; bunlar bir yenileme zamanlayıcısı içerir. Certbot ekibi bunun yerine snap paketini önerir; Nginx reverse proxy ve Certbot rehberi bu yöntemi gösterir. İkisi de çalışır, ancak yalnızca birini kurun.

Sıkılaştırma kılavuzu HTTP Strict Transport Security'yi önerir. Certbot'un oluşturduğu /etc/apache2/sites-available/nextcloud-le-ssl.conf dosyasını açın ve VirtualHost *:443 bloğunun içine şunu ekleyin:

<IfModule mod_headers.c>
  Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>

Apache'yi yeniden yükleyin ve başlığı kontrol edin:

sudo apache2ctl configtest && sudo systemctl reload apache2
curl -sI https://cloud.example.com | grep -i strict-transport

Önde Nginx tercih ediyorsanız aynı ilkeler geçerlidir; Nginx reverse proxy ve Certbot rehberine bakın.

Adım 8 — Bellek önbelleğini açın

Kılavuzun tek sunuculu kurulumu yerel önbellek için APCu'yu, dağıtık önbellek ve dosya kilitleme için Redis'i kullanır. Ubuntu ve Debian'da Redis varsayılan olarak yalnızca localhost'ta dinler:

cd /var/www/nextcloud
sudo -E -u www-data php occ config:system:set memcache.local --value='\OC\Memcache\APCu'
sudo -E -u www-data php occ config:system:set memcache.distributed --value='\OC\Memcache\Redis'
sudo -E -u www-data php occ config:system:set memcache.locking --value='\OC\Memcache\Redis'
sudo -E -u www-data php occ config:system:set redis host --value=localhost
sudo -E -u www-data php occ config:system:set redis port --value=6379 --type=integer
sudo -E -u www-data php occ config:system:get memcache.locking

Son komut Redis sınıfını yazdırır. Redis aynı sunucuda çalıştığı için kılavuz alternatif olarak bir Unix soket bağlantısını da (/run/redis/redis-server.sock ve port 0) anlatır.

Adım 9 — Arka plan işlerini systemd zamanlayıcısıyla çalıştırın

Nextcloud temizlik, bildirimler ve önizlemeler için düzenli arka plan işlerine ihtiyaç duyar. Kılavuzdaki iki birimi oluşturun. Önce /etc/systemd/system/nextcloudcron.service:

[Unit]
Description=Nextcloud cron.php job

[Service]
User=www-data
ExecCondition=php -f /var/www/nextcloud/occ status -e
ExecStart=/usr/bin/php -f /var/www/nextcloud/cron.php
KillMode=process

Ardından /etc/systemd/system/nextcloudcron.timer:

[Unit]
Description=Run Nextcloud cron.php every 5 minutes

[Timer]
OnBootSec=5min
OnUnitActiveSec=5min
Unit=nextcloudcron.service

[Install]
WantedBy=timers.target

Zamanlayıcıyı açın ve Nextcloud'u cron moduna geçirin:

sudo systemctl daemon-reload
sudo systemctl enable --now nextcloudcron.timer
sudo -E -u www-data php /var/www/nextcloud/occ background:cron
systemctl list-timers | grep nextcloud

Adım 10 — Güvenlik ve kurulum uyarılarını giderin

https://cloud.example.com adresinde giriş yapın ve Yönetim ayarları → Genel bakış sayfasını açın. Nextcloud kurulumunuzu kontrol eder ve uyarıları kılavuz bağlantılarıyla listeler. Bu komutlar yeni bir sunucudaki sık görülen uyarıları giderir; telefon bölgesi için kendi ülke kodunuzu kullanın:

cd /var/www/nextcloud
sudo -E -u www-data php occ config:system:set default_phone_region --value=GB
sudo -E -u www-data php occ config:system:set maintenance_window_start --type=integer --value=1
sudo -E -u www-data php occ db:add-missing-indices
sudo -E -u www-data php occ maintenance:repair --include-expensive

maintenance_window_start UTC cinsinden bir saattir; 1 değeriyle ağır arka plan işleri 01:00 ile 05:00 UTC arasında çalışır. Sayfa tüm kontrollerin geçtiğini bildirene kadar genel bakışı yenileyin, ardından yönetici hesabı için Kişisel ayarlar → Güvenlik altında iki aşamalı doğrulamayı açın.

Nextcloud parola sıfırlama e-postalarını ve paylaşımlar ile dosya değişiklikleri hakkındaki bildirimleri gönderir; posta sunucusunu Yönetim ayarları → Temel ayarlar altındaki E-posta sunucusu bölümünde smtp.example.com sunucusu, 587 numaralı port ve None/STARTTLS şifreleme seçeneğiyle ayarlayın, ardından aynı sayfadan bir deneme e-postası gönderin.

Yedekleme ve geri yükleme

Kılavuz neyin yedekleneceğini listeler: config klasörü, data klasörü, themes klasörü, kurduysanız özel uygulamalar ve veritabanı. Dosyalar ile veritabanı birbiriyle uyumlu olsun diye Nextcloud'u bakım moduna alın, klasörleri kopyalayın, veritabanının dökümünü alın ve bakım modundan çıkın:

sudo mkdir -p /opt/backups
cd /var/www/nextcloud
sudo -E -u www-data php occ maintenance:mode --on
sudo rsync -Aax /var/www/nextcloud/ /opt/backups/nextcloud-dirbkp_$(date +%F)/
sudo rsync -Aax /srv/nextcloud/data/ /opt/backups/nextcloud-databkp_$(date +%F)/
sudo mariadb-dump --single-transaction --default-character-set=utf8mb4 -r /opt/backups/nextcloud-sqlbkp_$(date +%F).bak nextcloud
sudo -E -u www-data php occ maintenance:mode --off

/opt/backups klasörünü başka bir makineye kopyalayın (örneğin SSH üzerinden rsync -aAx ile) ve tarihli birkaç kopya saklayın.

Geri yüklemek için bakım modunu açın, klasörleri geri kopyalayın, veritabanını yeniden oluşturun ve dökümü içe aktarın:

cd /var/www/nextcloud
sudo -E -u www-data php occ maintenance:mode --on
sudo rsync -Aax /opt/backups/nextcloud-dirbkp_2026-10-09/ /var/www/nextcloud/
sudo rsync -Aax /opt/backups/nextcloud-databkp_2026-10-09/ /srv/nextcloud/data/
sudo mariadb -e "DROP DATABASE nextcloud"
sudo mariadb -e "CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci"
sudo mariadb nextcloud < /opt/backups/nextcloud-sqlbkp_2026-10-09.bak
sudo -E -u www-data php occ maintenance:mode --off

Yedek, eşitleme istemcilerinizin en son gördüğü durumdan eskiyse sudo -E -u www-data php occ maintenance:data-fingerprint komutunu çalıştırın; böylece istemciler daha yeni yerel dosyaları silmek yerine değişikliği algılar.

Nextcloud güncelleme

Önce sürüm notlarını okuyun ve taze bir yedek alın; güncelleme aracı veritabanınızı ve verilerinizi yedeklemez. Her seferinde yalnızca bir ana sürüm yükseltin (örneğin 35'ten 36'ya), her zaman mevcut sürümünüzün en son ara sürümünden başlayın ve bir sonraki ana sürümün PHP sürümünüzü hâlâ desteklediğini kontrol edin. Yerleşik güncelleme aracını web sunucusu kullanıcısıyla çalıştırın:

sudo -E -u www-data php /var/www/nextcloud/updater/updater.phar

Güncelleme aracı kodu değiştirir ve occ upgrade komutunu sizin için çalıştırıp çalıştırmayacağını sorar. Hayır derseniz veya araç durursa yükseltmeyi kendiniz tamamlayın:

cd /var/www/nextcloud
sudo -E -u www-data php occ upgrade
sudo -E -u www-data php occ maintenance:mode --off
sudo -E -u www-data php occ db:add-missing-indices

Apache, PHP, MariaDB ve Redis'i sudo apt update && sudo apt upgrade ile güncel tutun.

Sorun giderme

Access through untrusted domain

Nextcloud'u trusted_domains listesinde olmayan bir sunucu adıyla açtınız. Adı occ config:system:set trusted_domains 2 --value=other.example.com ile ekleyin (bir sonraki boş sırayı kullanın) veya her zaman yapılandırılmış alan adını kullanın.

occ, yerel önbellek için APCu'nun kullanılamadığını bildiriyor

APCu, PHP CLI için kapalı. /etc/php/8.x/cli/conf.d/90-nextcloud.ini dosyasının apc.enable_cli = 1 içerdiğini ve php -i | grep apc.enable_cli komutunun On gösterdiğini kontrol edin. Arka plan işi servisi de aynı CLI yapılandırmasını kullanır.

Başlangıç sayfası dışındaki sayfalar Not Found döndürüyor

Adres yeniden yazma çalışmıyor. apache2ctl -M ile rewrite modülünün açık olduğunu, Directory bloğunda AllowOverride All bulunduğunu kontrol edin ve htaccess.RewriteBase değerini değiştirdikten sonra occ maintenance:update:htaccess komutunu yeniden çalıştırın.

Genel bakış, arka plan işlerinin uzun süredir çalışmadığını söylüyor

Zamanlayıcı çalışmıyor veya iş başarısız oluyor. systemctl status nextcloudcron.timer ve journalctl -u nextcloudcron.service -n 50 çıktılarına bakın. Sık görülen nedenler servis dosyasındaki yanlış bir yol veya eksik apc.enable_cli ayarıdır.

Güncelleme aracı PHP sürümü desteklenmediği için duruyor

Bir sonraki Nextcloud ana sürümü, işletim sisteminizin getirdiğinden daha yeni bir PHP gerektiriyor. Bir süre daha ara sürüm almaya devam eden mevcut sürümünüzde kalın ve Nextcloud'u yükseltmeden önce daha yeni bir işletim sistemi sürümüne geçin.

Sonraki adımlar

• Bu kurulumu konteyner tabanlı Nextcloud All-in-One ile karşılaştırın.
• Yönetici erişimini WireGuard VPN sunucusu ile gizli tutun.
• Temel sıkılaştırmayı Yeni bir Linux sunucusunu güvenli hale getirin rehberinde gözden geçirin.
• Dosya eşitleme ve iş birliği için sunucuları Nextcloud hosting sayfasında karşılaştırın.
• Ayarlama, uygulamalar ve kullanıcı yönetimi için Nextcloud yönetici kılavuzunu okuyun.