SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-10-23

VPS uzerinde Flarum kurulumu ve PHP forum yapilandirmasi

VPS uzerinde PHP, Composer ve MariaDB kullanarak Flarum kurulumunu adim adim ogrenin. /public dizinini TLS ile sunma, e-posta ayarlari ve eklenti hatalarini giderme rehberi.

PHP ve MariaDB ile bir VPS üzerine Flarum kurulumu

Flarum’u bir VPS üzerine kurarak PHP ve MariaDB ile çalışan bir forum elde edilebilir. Docker, Ruby veya ayrı bir iş çalıştırıcısı gerekmez. Tercih edilmesinin nedeni budur. Bir VPS üzerine Discourse kurulumu, Ruby, PostgreSQL, Redis ve arka plan çalışanını içeren bir Docker yığını anlamına gelir. Discourse’un kendi kurulum kılavuzu, yedekleme veya e-posta hizmeti eklenmeden önce 2 GB RAM önerir; 1 GB yalnızca swap ile çalışır. Discourse, günde binlerce gönderinin paylaşıldığı yoğun bir toplulukta bu kaynak ihtiyacını karşılar. Birkaç yüz kişilik bir forumda ise her ay ücret ödenen, ancak hiç kullanılmayan bir altyapıya dönüşür. Flarum, hâlihazırda çalıştırılıyor olabilecek bir PHP yığınına sığar. Bu nedenle nginx ve MariaDB kullanan 1 GB RAM’li bir VPS, mevcut diğer servislerin yanında Flarum’u da barındırabilir. Seçim hâlâ açık ise self-host edilen forum yazılımlarının kapsamlı karşılaştırması diğer seçenekleri ele alır.

Bu kılavuzdaki kurulum Flarum 1.x sürümüne, yani şu anda 1.8 serisine sabitlenmiştir. Flarum 2.0.0, 9 October 2026 tarihinde kararlı sürüm oldu. Ancak 12 October 2026 itibarıyla Flarum’un kendi yükseltme kılavuzunda, birçok eklentinin 2.0 için şu ana kadar yalnızca beta sürümlerini etiketlediği belirtiliyor. Ayrıca 1.x serisi kritik hatalar ve güvenlik sorunları için düzeltme almaya devam ediyor. Burada çekirdek sürümünden çok eklentiler önem taşıyor. Bu nedenle eklentilere bağlı bir forum için 1.8 hâlâ daha güvenli sürümdür. Üçüncü taraf eklentilere ihtiyacınız yoksa 2.0 mevcut sürümdür. Bu sürüm için PHP 8.3 veya daha yeni bir sürüm gerekir. Ubuntu 24.04 bu gereksinimi karşılar ve Flarum belgelerinde kurulum composer create-project flarum/flarum:^2.0.0 . ile yapılır. Aşağıdaki komutlar 1.8 için hazırlanmıştır.

Sunucuda Flarum 1.8 için gerekenler

Flarum'un belgelenen gereksinimleri PHP 7.3 veya üzeri, MySQL 5.6+ ya da MariaDB 10.0.5+ ve mod_rewrite destekli nginx veya Apache'dir. Ubuntu 24.04, PHP 8.3 ve MariaDB 10.11 ile birlikte gelir. Bu nedenle dağıtım paketleri, üçüncü taraf depo gerektirmeden her iki gereksinimi de karşılar. Flarum 2.0, minimum sürümleri PHP 8.3+, MySQL 5.7+ / 8.0.30+ veya MariaDB 10.3+ olarak yükseltir. Aynı Ubuntu paketleri bu gereksinimleri de karşılar. Flarum'un gerektirdiği PHP eklentileri curl, dom, fileinfo, gd, json, mbstring, openssl, pdo_mysql, tokenizer ve zip'tir. Ayrıca shell erişimi gerekir. Çünkü burada Composer isteğe bağlı değildir: her Flarum eklentisi bir Composer paketidir ve Composer çalıştırılmadan eklenti eklenemez.

Flarum, standart bir PHP uygulamasıdır. Ubuntu 24.04 üzerinde zaten bir LAMP yığını çalıştırıyorsanız, sonraki iki bölümde anlatılanların çoğu kurulmuş demektir. Bu durumda doğrudan veritabanı bölümüne geçebilirsiniz.

Flarum’un gerektirdiği PHP sürümünü ve eklentileri yükleme

sudo apt update
sudo apt install -y nginx mariadb-server composer
sudo apt install -y php8.3-fpm php8.3-cli php8.3-curl php8.3-gd php8.3-mbstring php8.3-mysql php8.3-xml php8.3-zip
php -m | grep -E 'curl|dom|gd|mbstring|pdo_mysql|zip'
composer --version

Paket adları Flarum’un listesiyle bire bir eşleşmez. dom eklentisi php8.3-xml içinde yer alır. fileinfo, json, openssl ve tokenizer ise Ubuntu üzerinde PHP 8.3 içine yerleşik gelir veya yukarıdaki paketlerin bağımlılık olarak yüklediği php8.3-common ile birlikte kurulur. Bu nedenle bunlar için ek bir kurulum gerekmez. grep çıktısında yedi satır bulunmalıdır: altı eklenti ve PHP 8.3’ün her zaman yüklediği, adında dom geçen random modülü. composer --version çıktısı 2.x sürümünü göstermelidir. Eksik bir eklenti hemen düzeltilmelidir. Örneğin php8.3-xml kurulmazsa Composer Flarum’u hiç yükleyemez. Bunun nedeni, bağımlılıklardan birinin ext-dom bildirmesidir. Hata iletisinde eklentinin adı da gösterilir. Önemli satır şu şekilde sona erer:

require ext-dom * -> it is missing from your system. Install or enable PHP's dom extension.

Ancak Composer, Flarum listesindeki her eklentiyi denetlemez. Flarum 1.8’in kullandığı görsel kitaplığı yalnızca gd önerir. Bu nedenle bu eklenti bulunmayan bir sunucu kurulumu sorunsuz tamamlar, ancak Flarum’un yüklenen bir avatarı veya logoyu ilk kez işlemesi gerektiğinde daha sonra hata verir.

Komut satırı PHP sürümü ile FastCGI işlem yöneticisinin (PHP-FPM) aynı sürüm olduğunu doğrulayın. Composer komut satırı ikilisiyle çalışırken forumunuz FPM üzerinde çalışır. Bu nedenle php -v ve sudo php-fpm8.3 -v aynı olmalıdır. Üçüncü taraf bir depodan birden fazla PHP sürümü yüklenmiş makinelerde bu sürümler farklılaşabilir. Böyle bir durumda bir sürüm için yüklenen eklenti diğer sürüm tarafından görülemez.

Veritabanını ve özel bir veritabanı kullanıcısını oluşturun

sudo mariadb-secure-installation
sudo mariadb
CREATE DATABASE flarum CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'flarum'@'localhost' IDENTIFIED BY 'use-a-long-random-password';
GRANT ALL PRIVILEGES ON flarum.* TO 'flarum'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Flarum için root yerine özel bir veritabanı kullanıcısı tanımlayın. Yetkilendirme yalnızca flarum.* üzerinde geçerli olmalıdır; böylece yazmadığınız bir eklentide oluşabilecek SQL injection açığı, diğer veritabanlarınıza erişemez. Karakter seti de önemlidir: utf8mb4, emoji ve Latin alfabesi dışındaki karakterleri doğru şekilde saklar. MySQL'in eski utf8 karakter seti ise üç baytlık bir kodlamadır ve dört baytlık bir karakterle karşılaştığında gönderiyi keser. Devam etmeden önce kullanıcının çalıştığını doğrulayın.

mariadb -u flarum -p flarum -e 'SELECT DATABASE();'

Bu komut flarum çıktısını vermelidir. ERROR 1045 (28000): Access denied for user 'flarum'@'localhost' hatası, parolanın yanlış olduğunu veya kullanıcının localhost dışındaki bir ana makine (host) için oluşturulduğunu gösterir.

Composer ile VPS üzerine Flarum kurulumu; sürüm 1.8'e sabitlenmiş

Önce kodun sahibi olacak bir sistem kullanıcısı oluşturulmalıdır. Composer'ın root olarak çalıştırılması, vendor/ ve storage/ altında root sahipli dosyalar bırakır. Bu nedenle PHP daha sonra kendi önbelleğine yazamaz ve forum her isteğe 500 hatasıyla yanıt verir.

sudo useradd --system --home-dir /srv/flarum --shell /bin/bash flarum
sudo install -d -o flarum -g flarum -m 755 /srv/flarum
sudo -iu flarum

Son komut, flarum kullanıcısı olarak /srv/flarum içinde bir kabuk oturumu açar. Kılavuzun geri kalanındaki tüm komutlar, sudo ile başlamadıkları sürece bu kullanıcıyla çalıştırılır.

composer create-project flarum/flarum:^1.8.0 .

^1.8.0 kısıtlaması sürüm sabitlemesidir. 1.8.x düzeltme sürümlerini kabul eder ve 2.0 sürümünü reddeder. Bu, 2.0.0 sürümü artık kararlı sürüm olduğundan önemlidir: kısıtlama olmadan composer create-project 2.0 sürümünü kurar. Composer iskeleti indirir, flarum/core ve bağımlılıklarını çözümler; sonuç olarak public/, storage/, vendor/, composer.json ve bir flarum komut satırı betiği oluşturulur.

Küçük bir VPS üzerinde sorunlar genellikle bu adımda ortaya çıkar ve iki farklı hata birbirine benzer. PHP Fatal error: Allowed memory size of 134217728 bytes exhausted, PHP'nin kendi memory_limit değeridir. Komutun önüne COMPOSER_MEMORY_LIMIT=-1 eklemek, bu sınırı tek çalıştırma için kaldırır. PHP hatası olmadan tek başına bir satırda görülen Killed ise çekirdeğin bellek yetersizliği sonlandırıcısıdır. Bu durum, makinenin gerçekten RAM kapasitesini tükettiğini gösterir ve dmesg | tail ile doğrulanabilir. Bu durumda swap eklenmelidir. PHP limitini yükseltmek sorunu kötüleştirir; çünkü çekirdek devreye girmeden önce PHP daha fazla bellek ister.

Neden yalnızca /public dizini web'e açık olmalıdır

Proje kök dizini, veritabanı parolanızın düz metin olarak bulunduğu config.php dosyasını, tüm bağımlılıkları içeren vendor/ dosyasını ve günlük kayıtları ile önbelleğe alınmış oturumları barındıran storage/ dizinini tutar. Bunların hiçbiri genel internete açık olmamalıdır. Flarum, web üzerinden erişilebilir olan her şeyi public/ adlı tek bir alt dizinde tutar; bu dizin index.php, bir assets/ klasörü ve çok az başka öğe içerir. Web sunucusu kök dizinini /srv/flarum/public olarak ayarladığınızda, dizin ağacının geri kalanı, hatırlamanız gereken bir kurala gerek kalmaksızın, yapısal olarak HTTP üzerinden erişilemez hale gelir.

Bunun yerine kök dizini /srv/flarum olarak ayarlarsanız, oluşacak zarar gerçektir. /config.php dosyasını talep etmek yararlı bir sonuç döndürmez, çünkü PHP dosyayı çalıştırır ve yalnızca bir dizi döndürür. Ancak /storage/logs/flarum.log, bir yabancıya yığın izlemelerinizi (stack traces) ve veritabanı hatalarınızı verir; /composer.lock ise onlara çalıştırdığınız her paketin tam sürümünü söyler ki bu da denenebilecek bilinen güvenlik açıklarının bir listesidir.

PHP-FPM için özel bir havuz oluşturma

Flarum'un üç dizine yazma erişimine ihtiyacı vardır: yükleyicinin config.php oluşturabilmesi için proje kök dizini; günlükler ve önbellek için storage/; ve yüklenen avatarlar ile logolar için assets/. Dosyalar flarum kullanıcısına ait olduğundan, en temiz çözüm flarum kullanıcısı olarak çalışan bir PHP-FPM havuzu oluşturmaktır. nginx, www-data kullanıcısı olarak çalışmaya devam eder ve yalnızca okuma işlemi yapar.

/etc/php/8.3/fpm/pool.d/flarum.conf dosyasını oluşturun:

[flarum]
user = flarum
group = flarum
listen = /run/php/php8.3-fpm-flarum.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = ondemand
pm.max_children = 10
pm.process_idle_timeout = 30s
php_admin_value[memory_limit] = 256M
php_admin_value[upload_max_filesize] = 16M
php_admin_value[post_max_size] = 17M
sudo systemctl restart php8.3-fpm
ls -l /run/php/php8.3-fpm-flarum.sock

Soket, srw-rw---- 1 www-data www-data olarak listelenmelidir. Ana süreç root olarak çalışır ve soketi oluşturur; bu sayede sahipliği www-data kullanıcısına devredebilirken, çalışan süreçler flarum olarak yürütülür. Soket mevcut değilse, sudo journalctl -u php8.3-fpm -n 30 hata mesajı olarak FPM rejected çıktısını verir. pm = ondemand, çalışan süreçleri yalnızca bir istek geldiğinde başlatır; bu sayede sessiz bir forum, ziyaretçiler arasında neredeyse hiç bellek tüketmez.

Nginx sunucu bloğu

Flarum, proje kök dizininde .nginx.conf adında bir Nginx kod parçacığı ile gelir. Bu dosya; yeniden yazma (rewrite) kurallarını, önbellek başlıklarını ve sıkıştırma ayarlarını içerir. Bu içeriği kopyalamak yerine dahil edin; böylece Flarum güncellemeleriyle gelen değişiklikler, herhangi bir düzenleme yapmanıza gerek kalmadan sunucunuza yansır.

server {
    listen 80;
    listen [::]:80;
    server_name forum.example.com;

    root /srv/flarum/public;
    index index.php;
    client_max_body_size 16M;

    include /srv/flarum/.nginx.conf;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm-flarum.sock;
    }
}

Bunu /etc/nginx/sites-available/flarum olarak kaydedin ve ardından etkinleştirin.

sudo ln -s /etc/nginx/sites-available/flarum /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

nginx -t, syntax is ok ve test is successful isteklerine yanıt vermelidir. include satırı, genellikle gözden kaçırılan kısımdır ve bu satırın eksikliği çok belirgin bir soruna yol açar: ana sayfa sorunsuz yüklenir ancak tüm tartışma bağlantıları Nginx üzerinden 404 hatası döndürür. Flarum, /d/1-hello-world gibi bir URL'yi PHP içerisinde yönlendirir. Bu yol disk üzerinde fiziksel bir dosya değildir; bu nedenle kod parçacığındaki try_files $uri $uri/ /index.php?$query_string kuralı olmadan Nginx, d adında bir dizin arar, bulamaz ve PHP'ye sormadan 404 yanıtı döner. Apache, aynı yönlendirmeyi zaten public/ dizininde bulunan .htaccess dosyası üzerinden gerçekleştirir; bu dosya yalnızca ilgili <Directory> bloğunda AllowOverride All ayarı yapılmışsa devreye girer.

Yükleyiciyi çalıştırmadan önce TLS ekleyin

Sertifika işlemlerini kurulumdan sonra değil, şimdi yapın. Flarum, kurulum sırasında kendi temel URL adresini config.php dosyasına yazar ve bu URL'yi tarayıcınızdaki adresten alır. Kurulumu http:// üzerinden yaparsanız, Flarum'un oluşturduğu tüm varlık URL'leri http:// ile başlar. Bu durumda TLS (transport layer security) eklediğinizde, tarayıcı bu istekleri karma içerik (mixed content) olarak engelleyecek ve forum, JavaScript olmadan, biçimlendirilmemiş metin şeklinde yüklenecektir. Öncelikle nginx üzerinde Let's Encrypt için certbot kurulumu adımlarını tamamlayın, https://forum.example.com adresinin bir sayfa sunduğunu doğrulayın ve ardından buraya geri dönün.

Eğer kurulumu zaten düz HTTP üzerinden yaptıysanız, onarım tek satırlık bir işlemdir. /srv/flarum/config.php dosyasını düzenleyin, url anahtarının 'url' => 'https://forum.example.com', değerini içerdiğinden emin olun ve ardından flarum kullanıcısı olarak php flarum cache:clear komutunu çalıştırın.

Yükleyiciyi çalıştırın ve config.php dosyasını kilitleyin

Tarayıcınızda https://forum.example.com adresini açın. Flarum web yükleyicisi sizden veritabanı adını, oluşturduğunuz veritabanı kullanıcısını ve parolasını, forum başlığını ve yönetici hesabı bilgilerinizi isteyecektir. Yükleyici, config.php dosyasını yazar ve gerekli tabloları oluşturur. İşlem tamamlandığında, veritabanı parolanızı içeren dosyayı koruma altına alın.

sudo chmod 640 /srv/flarum/config.php

Dosya, FPM'in çalıştırıldığı kullanıcı olan flarum tarafından okunabilir ve yazılabilir durumda kalır; sunucudaki diğer tüm hesaplar için ise erişilemez hale getirilir. Ardından kurulumu kabuk üzerinden kontrol edin.

php flarum info

Bu komut; çekirdek sürümünü, PHP sürümünü, etkinleştirilen eklentileri, posta sürücüsünü ve kullanılan dizin yollarını yazdırır. Bir sorun yaşandığında çalıştırılması gereken ilk komut budur ve size yardımcı olacak herkesin isteyeceği ilk bilgileri sağlar.

Kayıt ve parola sıfırlama e-postaları neden sessizce başarısız olur

Bu bölüm, forumunuzun ilk haftasını atlatıp atlatamayacağını belirler. Yeni bir forumun gönderdiği ilk iki e-posta, kayıt onayı ve parola sıfırlama iletileridir; her ikisi de bir yabancının topluluğunuzun gerçek olup olmadığına karar verdiği kritik anda gönderilir. Her ikisi de sessizce başarısız olur. E-postayı almayan kişi size ulaşamaz ve yönetici panelinizde hiçbir uyarı ışığı yanmaz.

Flarum, Yönetim ve ardından E-posta altında yapılandırılan dört farklı posta sürücüsüne sahiptir: smtp, mail, mailgun ve log. smtp seçeneğini tercih edin ve iletileri gerçekten teslim edecek bir posta servisine yönlendirin. mail sürücüsü, iletiyi yerel bir sendmail ikili dosyasına iletir; ancak bu dosya yeni kurulmuş bir Ubuntu VPS üzerinde mevcut olmadığından ileti hiçbir yere ulaşmaz ve herhangi bir hata üretilmez. log sürücüsü ise ileti gövdesini storage/logs/ dosyasına yazar ve hiçbir yere göndermez; çünkü bu sürücü yalnızca geliştirme aşaması için tasarlanmıştır.

Ayarları kaydedin ve aynı sayfadaki Test E-postası Gönder düğmesine basın. Bu düğme, sahip olduğunuz tek geri bildirim mekanizmasıdır; bu nedenle kimseyi davet etmeden önce mutlaka kullanın. İleti ulaşmazsa günlük kayıtlarını inceleyin.

tail -n 50 /srv/flarum/storage/logs/flarum.log

Reddedilen bir bağlantı, geri çevrilen bir oturum açma denemesi veya TLS anlaşma hatası, denenen ana bilgisayar ve port bilgileriyle birlikte burada listelenir. Connection could not be established with host smtp.example.com ifadesini içeren bir satır, portun engellendiğini veya yanlış olduğunu gösterir; bunun yaygın nedeni, servis sağlayıcıların varsayılan olarak 25 numaralı giden portu engellemesidir. Şifreleme alanı tls olarak ayarlanmış 587 numaralı port, neredeyse tüm posta servisleriyle çalışan standart kombinasyondur.

Posta sistemi çalışmadığında, kayıt olan bir ziyaretçi Flarum'un genel hata başlığı olan Oops! Something went wrong. Please reload the page and try again. ile karşılaşır; çünkü onay e-postası gönderilirken istek hata verir. Her iki durumda da kullanıcı sisteme giriş yapamaz ve bu durumu size bildirmek için ileti göndermez.

Postanın kabul edilmesi, gönderilmesinden ayrı bir sorundur. Alan adınız için SPF veya DKIM kayıtları yayınlanmamış bir VPS adresinden gelen postalar spam klasörüne düşer veya herhangi bir geri dönen ileti (bounce) olmaksızın doğrudan silinir. Bu durumda günlük kayıtlarınız gönderimin başarılı olduğunu gösterse bile alıcı hiçbir şey görmez. Self-hosted uygulamalardan güvenilir şekilde e-posta gönderme rehberi, hangi DNS kayıtlarının yayınlanması gerektiğini ve hangi aktarım (relay) servislerinin kullanılmaya değer olduğunu açıklar.

Eklentiler Composer paketleridir, bu nedenle yükseltmeler bir komutla yapılır

Flarum'da bir eklenti, bir Composer paketidir. Yükleme düğmesi veya bir klasöre bırakılacak zip dosyası yoktur. Bu, bilinçli bir tasarım kararıdır: sürümler birbirine göre çözümlenir, tam küme composer.lock dosyasında kaydedilir ve bir PHP kütüphanesine bağımlı olan eklenti, ilgili kütüphaneyi düzgün bir şekilde yükler. Bunun bedeli, bir eklenti eklemenin flarum kullanıcısı olarak üç komut çalıştırmak anlamına gelmesidir.

composer require 'fof/upload:*'
php flarum migrate
php flarum cache:clear

Ardından Yönetim ve ardından Eklentiler altından etkinleştirin. Her komut farklı bir iş yapar. composer require kodu diske yerleştirir. php flarum migrate, eklentinin beraberinde getirdiği veritabanı migrasyonlarını çalıştırır; eklenti kendi tablolarını bu şekilde oluşturur. php flarum cache:clear, tarayıcının yüklediği derlenmiş JavaScript ve CSS paketlerini yeniden oluşturur. Sonuncusunu atlamak klasik bir kafa karışıklığına yol açar: eklenti listelenir, anahtar açıktır ancak tarayıcıyı kaç kez yenilerseniz yenileyin hiçbir şey değişmez.

Bir eklentiyi kaldırmak tersi yönde işler. Önce yönetici panelinden devre dışı bırakın, ardından paketi kaldırın. Flarum, eklentinin tablolarını kasıtlı olarak yerinde bırakır, böylece daha sonra yeniden etkinleştirdiğinizde veri kaybı yaşanmaz. Tabloları da silmek isterseniz, kodu kaldırmadan önce migrasyonlarını geri alın.

php flarum migrate:reset --extension fof-upload
composer remove fof/upload
php flarum cache:clear

Bu komuttaki eklenti kimliği, eğik çizginin tire ile değiştirilmiş halidir. Yazmak yerine tıklamayı tercih ederseniz, composer require 'flarum/extension-manager:*' Composer'ı sarmalayan resmi bir yönetici sayfası ekler. Bu sayfa, web kullanıcısı ile aynı işlemleri çalıştırır, aynı bellek ve yazma izinlerine ihtiyaç duyar ve aynı şekillerde başarısız olur; bu nedenle bir şeyler ters gittiğinde komut satırı güvenilir yol olmaya devam eder.

Composer neden Flarum'u yükseltmeyi reddediyor?

Flarum'u ve tüm uzantıları yükseltmek için bir Composer komutu, ardından iki Flarum komutu çalıştırılır. Önce veritabanının yedeği alınmalıdır.

composer update --prefer-dist --no-plugins --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clear

İşlemin başarılı olduğunu varsaymak yerine çıktıyı okuyun. Çünkü asıl önemli durum, Composer'ın hiçbir işlem yapmayı reddetmesidir:

Your requirements could not be resolved to an installable set of packages.

Bu ileti, yüklü uzantılardan birinin, geçiş yaptığınız sürümü dışlayan bir flarum/core kısıtı tanımladığı anlamına gelir. Composer bu kısıtı ihlal etmez. Bu nedenle uzantı geliştiricisinin çalışmayacağını belirttiği bir birleşim oluşturmaktansa tüm kurulumu eski sürümde tutar. Sorumlu paketi bulun.

composer why-not flarum/core 1.8.20

Çıktıda, ilgili sürümü engelleyen tüm paketler ve her paketin tanımladığı kısıt listelenir. Bu noktada seçenekler, geliştiricinin uyumlu bir sürüm yayımlamasını beklemek veya uzantıyı kaldırıp kullanmamaktır. Composer modelinin bedeli budur. Başkalarının kullandığı bir foruma on beş uzantı kurmadan önce bunu anlamak gerekir. Yakın zamanda bir sürüm yayımlamış uzantılar tercih edilmeli ve liste, okunabilecek kadar kısa tutulmalıdır.

Bu komutlar sizi 1.x sürüm serisi içinde tutar. 1.8 sürümünden 2.0 sürümüne geçiş, Flarum belgelerinde kendi kılavuzu bulunan büyük bir yükseltmedir. Bu işlem için PHP 8.3, composer.json üzerinde düzenlemeler, MariaDB kurulumlarında config.php içinde bir driver değişikliği ve 2.0 sürümü bulunmayan tüm uzantıların kaldırılması gerekir.

Nelerin yedeklenmesi gerektiği

Veritabanını ve proje dizinini yedekleyin. Geri kalan her şey yeniden oluşturulabilir.

mariadb-dump -u flarum -p --single-transaction flarum > flarum-$(date +%F).sql
sudo tar czf flarum-files.tgz -C /srv flarum

Eski sistemlerde mariadb-dump, mysqldump olarak adlandırılır; Ubuntu 24.04 üzerinde her iki isim de çalışır. Veritabanı tüm gönderileri, tüm kullanıcıları ve tüm ayarları barındırır. Proje dizini ise config.php, composer.json (çalıştırdığınız eklentilerin asıl kaydını tutan dosya) ve yüklenen avatarlar ile logoların bulunduğu assets/ dizinini içerir. vendor/ dizinini yedeklemeyi atlayabilirsiniz, çünkü composer install bunu composer.lock üzerinden yeniden oluşturur ve storage/ kendi kendini yeniler. Her iki dosyayı da sunucudan başka bir yere kopyalayın; çünkü koruduğu makinede tutulan bir yedek, gerçek bir yedek değildir. Geri yükleme işlemi; aynı sürümde temiz bir Flarum kurulumu, composer install, kaydedilen dosyaların yerlerine konulması ve SQL dosyasının yüklenmesi anlamına gelir.

FAQ

Flarum 1 GB VPS üzerinde çalışabilir mi?

Evet, küçük bir topluluk için çalışabilir. Flarum normal çalışmada istekleri yanıtlayan PHP-FPM ile MariaDB'den oluşur ve pm = ondemand kullanıldığında PHP worker'ları yalnızca biri sayfa okurken çalışır. En yüksek bellek kullanımı kurulum sırasında görülür: composer create-project tüm bağımlılık grafiğini bellekte çözer ve out-of-memory killer tarafından durdurulma ihtimali en yüksek adım budur. Kurulumdan önce bir swap dosyası eklenmeli veya Composer daha büyük bir makinede bir kez çalıştırılıp dosya ağacı sunucuya kopyalanmalıdır.

Ön sayfa çalışırken tartışma bağlantıları neden 404 döndürüyor?

nginx server block içinde include /srv/flarum/.nginx.conf; eksiktir. Flarum, /d/1-hello-world gibi URL'leri PHP içinde işler ve bu yol diskteki bir dosya değildir. Snippet içindeki try_files $uri $uri/ /index.php?$query_string kuralı olmadan nginx, d adlı bir dizin arar, başarısız olur ve PHP'yi hiç çağırmadan 404 yanıtını kendisi döndürür. Apache üzerinde aynı yönlendirme public/.htaccess tarafından sağlanır; ancak <Directory> block'u AllowOverride All değerini ayarlamadıkça bu yapı yok sayılır.

HTTPS'yi etkinleştirdikten sonra forum neden tüm stilini kaybetti?

Flarum temel URL'sini config.php içinde saklar. Bu değer, installer çalıştırılırken kullanılan adresten alınır. Plain HTTP üzerinden kurulum yaptıysanız Flarum http:// asset URL'leri üretmeye devam eder. Tarayıcı, HTTPS sayfasındaki bu mixed content içeriğini engeller ve geriye stilsiz metin kalır. /srv/flarum/config.php içindeki url anahtarı https:// adresiyle güncellenmeli ve php flarum cache:clear dosyaların sahibi olan kullanıcı olarak çalıştırılmalıdır.

Kayıt onay e-postasını neden kimse almıyor?

Önce mail driver kontrol edilmelidir. mail driver'ı, yeni bir Ubuntu VPS üzerinde bulunmayan yerel bir sendmail binary'sine ihtiyaç duyar. log driver'ı ise storage/logs/ konumuna yazar ve e-posta göndermez. smtp değerine geçin. Şifrelemeyi tls olarak ayarlayıp 587 numaralı portu kullanın; çoğu sağlayıcı dışarıya giden 25 numaralı portu engeller. Ardından Send Test Mail düğmesine basın. Log başarılı bir gönderim gösteriyor ancak e-posta hâlâ ulaşmıyorsa sorun yapılandırmadan çok teslim edilebilirlikle ilgilidir. Bu durumda gönderim alan adınız için SPF ve DKIM kayıtlarını yayımlayın.

Flarum 1.8 mi, yoksa 2.0 mı kurulmalı?

Forum üçüncü taraf extension'lara bağlıysa şimdilik 1.8 kurulmalıdır. Flarum 2.0.0, 9 October 2026 tarihinde stable release oldu. Ancak 12 October 2026 itibarıyla Flarum upgrade guide, birçok extension'ın 2.0 için şu ana kadar yalnızca beta release etiketlediğini belirtiyor. Ayrıca 2.0 release'i olmayan her extension, 1.x sürümlerinde sona eren bir flarum/core kısıtlaması tanımlamaya devam ediyor. Bugün 2.0 kurulursa Composer bu extension'ları doğrudan reddeder. Bu, composer why-not kısıtlamasının teşhis etmek üzere tasarlandığı conflict'in aynısıdır. flarum/flarum:^1.8.0 ile sürümü sabitleyin ve bağımlı olduğunuz extension'lar stable 2.0 release'lerine sahip olduğunda Flarum upgrade guide üzerinden 2.0'a geçin. 1.x sürümünün artık yalnızca kritik bug'lar ve güvenlik sorunları için düzeltme aldığını unutmayın. Üçüncü taraf extension gerektirmeyen bir forum, flarum/flarum:^2.0.0 ile bugün 2.0 üzerinde başlatılabilir.

Bu yazı işinize yaradı mı?