Magento 2 Kurulumu ve Sunucu Gereksinimleri

Magento 2 kurulum süreci, “dosyaları sunucuya at, kurulum sihirbazını çalıştır” mantığıyla ilerlemez. Doğru PHP sürümü, uyumlu bir veritabanı, OpenSearch, önbellek servisleri ve Composer birlikte hazırlanmalıdır. Bu yazıda Ekim 2026 itibarıyla güncel Magento sistem gereksinimlerini, Composer ile kurulum adımlarını ve kurulumdan sonra yapılması gereken ayarları anlatıyoruz. Kurulumu sizin yerinize planlamamızı isterseniz Magento 2 kurulum ve geliştirme sayfamızdan bize ulaşabilirsiniz.

Magento’nun ne olduğunu ve hangi işletmelere uygun olduğunu henüz netleştirmediyseniz önce e-ticaret yazılımı nasıl seçilir yazımıza göz atmanızı öneririz.

Magento sistem gereksinimleri (Ekim 2026)

Adobe, her sürüm için test ettiği yazılım kombinasyonlarını resmi sistem gereksinimleri sayfasında yayınlar ve yalnızca bu kombinasyonları desteklediğini açıkça belirtir. Aşağıdaki tablo, kendi sunucunuza (on-premises) kurulum için Adobe dokümantasyonundaki değerleri özetliyor:

Tablodan çıkan birkaç önemli not:

• Magento PHP sürümü: 2.4.9 için Adobe’nin test ettiği sürüm PHP 8.5’tir. Sunucunuzdaki PHP sürümü, kurmak istediğiniz Magento sürümüyle eşleşmelidir.
• Veritabanı: MySQL 8.0’ın desteği 30 Nisan 2026’da sona erdi. Yeni kurulumlarda MySQL 8.4 veya MariaDB tercih edin; Adobe 2.4.9’u MariaDB 12.3 ile test ettiğini özellikle belirtiyor.
• Arama motoru: OpenSearch zorunludur. Elasticsearch 7.17’nin desteği 15 Ocak 2026’da bitti.
• Redis yerine Valkey: Güncel tablolarda önbellek ve oturum için Valkey yer alıyor. Valkey, Redis ile uyumlu açık kaynak bir alternatiftir.
• Web sunucusu: 2.4.9 tablosunda test edilen web sunucusu nginx 1.30’dur. Eski sürümlerde Apache 2.4 de listelenirdi.
• İşletim sistemi: 64 bit Linux (Ubuntu, Debian, RHEL ve benzerleri) gerekir. Windows ve macOS desteklenmez; bunlar yalnızca Docker gibi araçlarla geliştirme ortamı olarak kullanılabilir.
• Bellek: Adobe, Marketplace ve diğer kaynaklardan eklenti güncellemelerinin 2 GB’a kadar RAM gerektirebileceğini, daha az RAM varsa swap dosyası oluşturulmasını belirtiyor. Bu bir alt sınırdır; canlı mağaza için çok daha fazlası gerekir.

Bu değerler zamanla değişir. Kuruluma başlamadan önce Adobe Experience League’deki “System requirements” sayfasını mutlaka kontrol edin.

Hangi sürümü kurmalısınız?

Yeni bir projede genellikle en güncel kararlı sürümle başlamak doğru tercihtir; Ekim 2026 itibarıyla bu sürüm 2.4.9’dur ve Adobe bu hat için standart desteğin 31 Mayıs 2029’a kadar sürdüğünü belirtiyor. 2.4.8 hattının desteği 31 Mayıs 2028’de, 2.4.7 hattının standart desteği ise 31 Mayıs 2027’de bitiyor. Alfa veya beta sürümler (ör. 2.4.10-alpha1) yalnızca test içindir, canlı mağazaya kurulmamalıdır.

Tek istisna, ihtiyaç duyduğunuz kritik bir eklentinin henüz yeni sürümle uyumlu olmamasıdır. Bu durumda eklenti üreticisinin uyumluluk takvimini sorun; bir önceki hatla başlamak zorunda kalırsanız güncelleme planını baştan yapın. Hangi eklentiyi kullanacağınıza karar vermeden önce “2.4.9 ve PHP 8.5 ile uyumlu mu?” sorusunu mutlaka sorun.

Sunucuyu nasıl planlamalısınız?

Magento kurulumu için paylaşımlı hosting uygun değildir. En azından root erişimli bir VPS veya ayrılmış sunucu, ya da Magento’ya özel yönetilen bir hosting gerekir. Kapasiteyi belirlerken şu sorulara bakın:

• Kaç ürününüz ve kaç mağaza görünümünüz (dil, ülke) olacak?
• Günlük ziyaretçi ve kampanya dönemlerindeki zirve trafik ne kadar?
• OpenSearch ve veritabanı aynı sunucuda mı, ayrı sunucularda mı çalışacak?
• Yedekleme, izleme ve güvenlik duvarını kim yönetecek?

Bir de RabbitMQ konusu var: Magento bazı arka plan işlerini (toplu işlemler, ihracat, bazı entegrasyonlar) mesaj kuyruğu üzerinden yürütür. Küçük kurulumlarda bu kuyruklar veritabanı üzerinden de çalışabilir; ancak yoğun entegrasyonlu projelerde RabbitMQ kurmak daha sağlıklıdır.

Küçük ve orta ölçekli projelerde tüm servislerin tek güçlü bir sunucuda çalışması mümkündür. Trafik ve katalog büyüdükçe veritabanı, arama ve önbellek servislerini ayırmak gerekir.

Önce yerel geliştirme ortamı kurun

Canlı sunucuya geçmeden önce Magento’yu bilgisayarınızda veya bir test sunucusunda denemek, hem sistemi tanımanızı hem de eklentileri güvenle test etmenizi sağlar. Windows ve macOS doğrudan desteklenmediği için yerel ortamda genellikle Docker tabanlı araçlar kullanılır. Bu araçlar PHP, veritabanı, OpenSearch ve Valkey servislerini konteynerler halinde ayağa kaldırır; böylece canlı sunucuyla aynı sürümleri yerelde çalıştırabilirsiniz. İyi bir projede en az üç ortam bulunur: yerel geliştirme, test (staging) ve canlı.

Magento composer kurulum adımları

Adobe’nin önerdiği kurulum yöntemi Composer’dır. Aşağıdaki adımlar Magento Open Source için genel akışı gösteriyor; sunucu ayarları projeye göre değişir.

1. Erişim anahtarlarını alın

Adobe Commerce Marketplace hesabınızda “Access Keys” bölümünden bir genel (public) ve bir özel (private) anahtar oluşturun. Composer sizden kullanıcı adı istediğinde genel anahtarı, parola istediğinde özel anahtarı girersiniz. Bu anahtarlar ücretsizdir ve Magento Open Source için de gereklidir.

2. Projeyi Composer ile indirin

Magento Open Source için Adobe dokümantasyonundaki komut şudur:

• composer create-project –repository-url=https://repo.magento.com/ magento/project-community-edition magento2

Adobe Commerce lisansınız varsa paket adı magento/project-enterprise-edition olur. Belirli bir sürümü kurmak için paket adının sonuna sürüm numarasını ekleyebilirsiniz (ör. magento/project-community-edition=2.4.9).

3. Dosya izinlerini ayarlayın

Web sunucusunun çalıştığı kullanıcı ile dosyaların sahibi olan kullanıcı uyumlu olmalıdır. var, generated, vendor, pub/static, pub/media ve app/etc klasörlerinde yazma izni gerekir. İzinleri herkese açık (777) yapmak hızlı bir çözüm gibi görünse de güvenlik açığı yaratır.

4. Veritabanını oluşturun

Magento için boş bir veritabanı ve yalnızca bu veritabanına yetkili bir kullanıcı oluşturun.

5. setup:install komutunu çalıştırın

Kurulum komut satırından bin/magento setup:install ile yapılır. Komutta başlıca şu bilgiler verilir:

• Mağaza: –base-url, –language (ör. tr_TR), –currency (ör. TRY), –timezone (ör. Europe/Istanbul), –use-rewrites=1
• Veritabanı: –db-host, –db-name, –db-user, –db-password
• Yönetici: –admin-firstname, –admin-lastname, –admin-email, –admin-user, –admin-password
• Arama: –search-engine=opensearch, –opensearch-host, –opensearch-port

Adobe, yönetim paneli adresini belirleyen –backend-frontname seçeneğini boş bırakmanızı öneriyor. Bu durumda kurulum rastgele bir yönetici adresi üretir ve kurulum sonunda ekrana yazar. Tahmin edilmesi zor bir adres, kaba kuvvet saldırılarını zorlaştırır.

6. Üretim moduna geçin

Kurulum varsayılan olarak geliştirme modunda başlayabilir. Canlı mağaza için bin/magento deploy:mode:set production komutuyla üretim moduna geçin. Bu modda statik dosyalar ve kod önceden derlenir, site daha hızlı çalışır.

Kurulumdan sonra yapılması gerekenler

1. Cron işlerini kurun: bin/magento cron:install komutuyla Magento’nun zamanlanmış görevlerini etkinleştirin. Cron çalışmazsa indeksler güncellenmez, e-postalar gitmez, sitemap oluşmaz.
2. İndeksleri kontrol edin: bin/magento indexer:status ile indekslerin durumunu görün; canlı mağazada “Update by Schedule” modu genellikle daha uygundur.
3. Varnish’i bağlayın: Tam sayfa önbelleği için Stores > Configuration > Advanced > System > Full Page Cache bölümünden Varnish’i seçin.
4. Valkey’i yapılandırın: Oturum ve uygulama önbelleğini dosya sistemi yerine Valkey’e yönlendirin.
5. HTTPS’i zorunlu kılın: Geçerli bir SSL sertifikası kurun; vitrin ve panel için güvenli adresleri kullanın.
6. İki adımlı doğrulamayı ayarlayın: Magento 2.4 ile yönetici girişinde iki adımlı doğrulama varsayılan olarak gelir; yöneticilerinizin kurulumunu tamamlayın.
7. Yedekleme ve izleme: Veritabanı ve medya klasörünün düzenli yedeğini alın, sunucu kaynaklarını izleyin.

Magento kurulumunda sık yapılan hatalar

• Uyumsuz PHP sürümü: Sunucuda hazır gelen PHP sürümünü kullanmak, kurulumun yarıda kalmasına veya garip hatalara yol açar.
• Eksik PHP eklentileri: intl, bcmath, gd, soap, sodium, zip gibi eklentiler eksikse Composer veya kurulum durur.
• Düşük memory_limit: PHP bellek limiti düşük kalırsa derleme ve statik içerik üretimi yarıda kesilir.
• Cron’u unutmak: En sık gördüğümüz sorundur; ürünler görünmez, kampanyalar başlamaz.
• Geliştirme modunda canlıya çıkmak: Site yavaş çalışır ve hata mesajları ziyaretçiye görünebilir.
• Test ortamı olmadan çalışmak: Eklenti ve güncellemeleri doğrudan canlı sitede denemek, kesintilere neden olur.

Kurulumu kendiniz mi yapmalısınız?

Teknik altyapınız ve Linux sunucu deneyiminiz varsa test amaçlı bir Magento kurulumu birkaç saatlik bir iştir. Canlı bir mağaza için ise kurulum işin küçük bir kısmıdır: sunucu güvenliği, performans ayarı, ödeme ve kargo entegrasyonları, yedekleme ve güncelleme planı da hazırlanmalıdır. Sunucu maliyeti ve hosting seçenekleri için e-ticaret kurulum maliyeti yazımızdaki kalemler fikir verebilir.

Sonuç

Başarılı bir Magento 2 kurulumu, doğru sürüm kombinasyonuyla başlar: güncel 2.4.9 için PHP 8.5, MySQL 8.4 veya MariaDB 12.3, OpenSearch 3, Valkey, Varnish ve Composer 2.10. Ardından cron, indeks, önbellek ve güvenlik ayarları tamamlanmadan site canlıya alınmamalıdır.

Magento 2 kurulum sürecini sizin için planlayıp yönetmemizi isterseniz Magento ile e-ticarete başlama sayfamızı inceleyin. Kurulumu ekibinizle birlikte öğrenmek isterseniz birebir Magento 2 eğitimi seçeneğimize göz atabilirsiniz.

Sık Sorulan Sorular

Magento 2 için hangi PHP sürümü gerekir?

Ekim 2026 itibarıyla güncel Magento 2.4.9 için Adobe'nin test ettiği PHP sürümü 8.5'tir. 2.4.8 hattının son yaması PHP 8.4 ve 8.3 ile, 2.4.7 hattının son yaması PHP 8.3 ve 8.2 ile çalışır. Kurulumdan önce Adobe'nin sistem gereksinimleri sayfasını kontrol edin.

Magento kurulumu paylaşımlı hostingde yapılır mı?

Önerilmez. Magento; OpenSearch, Varnish, Valkey ve cron gibi servislere ihtiyaç duyar ve bunlar paylaşımlı hostingde genellikle kurulamaz. Root erişimli bir VPS, ayrılmış sunucu veya Magento'ya özel yönetilen hosting tercih edin.

Magento composer kurulum için hangi anahtarlar gerekir?

Adobe Commerce Marketplace hesabınızdaki Access Keys bölümünden ücretsiz bir genel ve bir özel anahtar oluşturursunuz. Composer kullanıcı adı olarak genel anahtarı, parola olarak özel anahtarı ister. Bu anahtarlar Magento Open Source kurulumu için de gereklidir.

Magento sistem gereksinimleri arasında Elasticsearch var mı?

Güncel sürümlerde arama motoru olarak OpenSearch kullanılır. Elasticsearch 7.17'nin desteği 15 Ocak 2026'da sona erdi ve 2.4.9'un gereksinim tablosunda Elasticsearch yer almıyor.

Kurulumdan sonra ilk yapılması gereken nedir?

Cron işlerini kurmak, üretim moduna geçmek, Varnish ve Valkey önbelleklerini bağlamak, HTTPS'i zorunlu kılmak ve yedekleme planını devreye almak ilk işler arasındadır. Özellikle cron çalışmazsa indeksler ve e-postalar düzgün çalışmaz.