Magento 2 kurulumu: Magento 2.4.9 adım adım nasıl kurulur?

Bu rehber, Magento 2.4.9'un bir Linux sunucuya kurulumunu adım adım anlatıyor. Aşağıdaki tüm gereksinimler ve komutlar, Adobe'nin Experience League'deki resmi kurulum kılavuzundan alınmıştır. “Magento nasıl doğru kurulur?” diye merak ettiyseniz, müşteri sunucularında izlediğimiz sıra tam olarak budur.

Rehber; SSH erişiminiz, root veya sudo yetkiniz ve sunucuya yönlendirilmiş bir alan adınız olduğunu varsayar. Yerel bir test kurulumu için aynı adımlar bir container veya sanal makine (VM) içinde de çalışır.

Magento 2.4.9 kurulum gereksinimleri

Magento Open Source ve Adobe Commerce 2.4.9, 12 Mayıs 2026'da yayınlandı. Adobe yalnızca test ettiği servis kombinasyonlarını destekler. Şirket içi (on-premises) 2.4.9 için sistem gereksinimleri tablosu şunları listeler:

Adobe, destek ekibinin bir sorunu incelemeden önce listedeki kombinasyonlardan birine geçmenizi isteyebileceğini belirtiyor. Canlı bir mağazada bu tablonun dışına çıkmayın.

PHP eklentileri ve ayarları

Magento Open Source şu PHP eklentilerini gerektirir: bcmath, ctype, curl, dom, fileinfo, filter, ftp, gd, hash, iconv, intl, json, libxml, mbstring, openssl, pcre, pdo_mysql, reflection, simplexml, soap, sockets, sodium, tokenizer, xmlwriter, xsl, zip ve zlib. Sunucunuzda hangilerinin yüklü olduğunu şu komutlarla kontrol edin:

php -v
php -m

Sunucunuzdaki php.inidosyasında date.timezonedeğerini ayarlayın, memory_limit değerini yükseltin (Adobe'nin örneğinde 2Gkullanılır) ve realpath önbelleğini ayarlayın:

memory_limit = 2G
realpath_cache_size = 10M
realpath_cache_ttl = 7200

1. Adım: Veritabanını ve OpenSearch'ü hazırlayın

Boş bir veritabanı ve buna özel bir kullanıcı oluşturun:

mysql -u root -p
CREATE DATABASE magento;
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'a-strong-password';
GRANT ALL ON magento.* TO 'magento'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Magento 2.4'ten bu yana her kurulum, katalog araması için Elasticsearch veya OpenSearch kullanmak zorundadır ve arama motoru kurulumdan önce çalışıyor olmalıdır. 2.4.9 için bu, OpenSearch 3 demektir. Devam etmeden önce yanıt verdiğini doğrulayın:

curl -X GET "http://localhost:9200/"

OpenSearch farklı bir sunucuda çalışıyorsa Adobe, 9200 numaralı portu dışarıya açmak yerine HTTP Basic kimlik doğrulamalı bir TLS reverse proxy arkasına almanızı öneriyor.

2. Adım: Erişim anahtarlarınızı alın

Magento, Adobe'nin repo.magento.com adresindeki Composer deposundan kurulur. Bunun için bir erişim anahtarı çiftine ihtiyacınız var:

1. Commerce Marketplace'e giriş yapın.
2. Hesabınızda My Profile > Access Keys bölümünü açın ve yeni bir anahtar çifti oluşturun.
3. Composer kullanıcı adı sorduğunda genel anahtarı (public key)girin. Parola olarak da özel anahtarı (private key) girin.

Anahtarları Composer'ın auth.jsondosyasına kaydederseniz bu bilgiler size tekrar sorulmaz.

3. Adım: Magento 2.4.9'u Composer ile indirin

Dosya sistemi sahibi kullanıcıya geçin (root değil, web kök dizininin sahibi olan kullanıcı), web kök dizininize gidin ve projeyi oluşturun. Magento 2 Open Source'u belirli bir sürümle kurmak için:

cd /var/www
composer create-project --repository-url=https://repo.magento.com/ \
  magento/project-community-edition=2.4.9 magento2

Adobe Commerce için bunun yerine magento/project-enterprise-edition paketini kullanın. “Could not find package” hatası alırsanız komutta yazım hatası olup olmadığını kontrol edin ve anahtarlarınızın bu sürüme erişimi olduğunu doğrulayın.

4. Adım: Dosya izinlerini ayarlayın

Web sunucusu grubunun kurulumdan önce bazı dizinlere yazma erişimi olmalıdır. Adobe'nin hızlı başlangıç kılavuzu şu komutları kullanır (Ubuntu örneği, grup: www-data):

cd /var/www/magento2
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data .
chmod u+x bin/magento

Kesinlikle chmod 777kullanmayın. Eğitimlerde sık görülen bir kısayoldur, ancak canlı bir sunucuda ciddi bir güvenlik riskidir.

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

Magento 2.4.9 kurulumunun en önemli adımı budur. Komutu Magento kök dizininde çalıştırın:

bin/magento setup:install \
  --base-url=https://www.example.com/ \
  --db-host=localhost \
  --db-name=magento \
  --db-user=magento \
  --db-password='a-strong-password' \
  --admin-firstname=Jane \
  --admin-lastname=Doe \
  [email protected] \
  --admin-user=jane.admin \
  --admin-password='Use-a-long-passphrase-1' \
  --language=en_US \
  --currency=USD \
  --timezone=America/Chicago \
  --use-rewrites=1 \
  --search-engine=opensearch \
  --opensearch-host=localhost \
  --opensearch-port=9200 \
  --opensearch-index-prefix=magento2 \
  --opensearch-timeout=15

Bilmeniz gereken birkaç seçenek:

• –base-url protokolü ve sondaki eğik çizgiyi (/) içermelidir.
• –admin-password en az 7 karakterden oluşmalı, harf ve rakam içermelidir. Çok daha uzun bir parola kullanın ve tek tırnak içine alın.
• –backend-frontname yönetim paneli yolunu belirler. Adobe, bu seçeneği boş bırakıp yükleyicinin rastgele bir yol oluşturmasına izin vermenizi öneriyor. Yönetim paneli URL'si kurulumun sonunda ekrana yazdırılır; daha sonra görmek için şu komutu kullanabilirsiniz: bin/magento info:adminuri.
• –use-secure=1, –base-url-secure ve –use-secure-admin=1 mağaza ön yüzü ve yönetim paneli için HTTPS'i etkinleştirir. Üçü de gereklidir.
• bin/magento info:language:list, info:currency:list ve info:timezone:list komutları geçerli değerleri listeler.

Yükleyici, hataları düzeltmek veya SSL ayarlarını sonradan eklemek için yeniden çalıştırılabilir. Tüm seçeneklerin listesi için şunu çalıştırın: bin/magento help setup:install.

6. Adım: Cron'u kurun

Magento; indeksleme, e-postalar, site haritaları, döviz kurları ve daha fazlası için cron'a ihtiyaç duyar. Magento crontab'ını dosya sistemi sahibi kullanıcıyla kurun:

bin/magento cron:install
crontab -l

Komut, girdilerini #~ MAGENTO START ve #~ MAGENTO END işaretleri arasına yazar ve diğer cron görevlerinize dokunmaz. Mevcut bir Magento bloğunu yeniden yazmak için --force seçeneğini kullanın.

7. Adım: Canlı moda (production mode) geçin

Yeni bir kurulum varsayılan (default) modda çalışır. Canlı bir mağazada, kodu derleyip statik dosyaları yayınlayan canlı moda (production mode) geçin:

bin/magento deploy:mode:set production
bin/magento deploy:mode:show

Kodu aktif olarak değiştirdiğiniz yerel ve test (staging) ortamlarında developer modunu kullanın.

8. Adım: Magento kurulumu sonrası kontrol listesi

• nginx sanal sunucunuzda (virtual host) belge kök dizini olarak pub/ dizinini gösterin; bunun için Magento ile birlikte gelen nginx.conf.sample örnek dosyasını kullanın.
• Önbellek ve oturumlar için Valkey'i, tam sayfa önbellek için Varnish'i yapılandırın.
• Yönetim panelindeki iki faktörlü kimlik doğrulama ve müşteri e-postalarının çalışması için giden e-posta ayarlarını yapın.
• Şu komutları çalıştırın: bin/magento indexer:reindex ve bin/magento cache:flush, ardından mağaza ön yüzünü ve yönetim panelini açıp kontrol edin.
• Ürünleri içe aktarmadan önce yedeklemeyi ve izlemeyi kurun.

Kurulumu izleyerek mi öğrenmek istersiniz? Ücretsiz Magento 2 video derslerimiz kurulumu ve yapılandırmayı anlatıyor. PHP 8.5, OpenSearch, Valkey ve Varnish'i kendiniz yönetmek istemiyorsanız yönetilen Magento 2 hosting size hazır ve ince ayarı yapılmış bir 2.4.9 ortamı sunar.

Sık karşılaşılan Magento 2 kurulum hataları

• Could not find package. Genellikle paket adında veya sürümde yazım hatası vardır ya da erişim anahtarlarınızın o sürüm (edition) için yetkisi yoktur. Komutu ve Commerce Marketplace'teki anahtarlarınızı kontrol edin.
• setup:install sırasında arama motoru bağlantı hataları. OpenSearch çalışmıyordur ya da sunucu adı, port veya kimlik bilgileri hatalıdır. Yükleyiciyi yeniden çalıştırmadan önce web sunucusundan curl ile test edin.
• var, generated veya pub/static dizinlerinde izin hatası (Permission denied). Komutlar root olarak çalıştırılmıştır ya da dosyaların sahibi web sunucusu grubu değildir. 4. Adımdaki izinleri dosya sistemi sahibi kullanıcıyla yeniden uygulayın.
• Eksik PHP eklentisi. Composer ya da yükleyici eksik eklentinin adını verir. Eklentiyi paket yöneticinizle kurun, PHP-FPM'i yeniden başlatın ve şu komutla doğrulayın: php -m.

Yükleyici birden fazla kez çalıştırılabildiği için sorunun nedenini giderip setup:install komutunu yeniden çalıştırabilirsiniz. Varsayılan olarak mevcut bir veritabanının üzerine yazmaz; --cleanup-database seçeneği bu davranışı değiştirir.

Sıkça sorulan sorular

Magento 2.4.9'u paylaşımlı hostinge kurabilir miyim?

Genellikle hayır. SSH, Composer, belirli eklentilere sahip PHP 8.5 ve çalışan bir OpenSearch servisi gerekir. Paylaşımlı hosting paketlerinin çoğu bu kombinasyonu sunmaz.

Elasticsearch hâlâ destekleniyor mu?

Adobe'nin arama motoru kılavuzu kurulumların Elasticsearch veya OpenSearch kullanması gerektiğini söylüyor, ancak 2.4.9 gereksinimler tablosunda yalnızca OpenSearch 3 yer alıyor. Yeni 2.4.9 kurulumlarında OpenSearch kullanın.

nginx yerine Apache kullanabilir miyim?

2.4.9 gereksinimler tablosunda nginx 1.30 yer alıyor, Apache ise listelenmiyor. Apache yine de çalışabilir, ancak test edilen ve desteklenen seçenek nginx'tir.

Open Source ile Adobe Commerce kurulumu arasındaki fark nedir?

Adımlar aynıdır. Fark, kullanılan meta paket (project-community-edition veya project-enterprise-edition) ve erişim anahtarlarınızın Adobe Commerce için lisanslı olup olmamasıdır.

Kaynaklar

• Adobe: Sistem gereksinimleri
• Adobe: Şirket içi kurulum için hızlı başlangıç
• Adobe: Gelişmiş şirket içi kurulum
• Adobe: PHP ayarları
• Adobe: Arama motoru ön koşulları
• Adobe: Cron'u yapılandırma ve çalıştırma
• Adobe: Uygulama modunu ayarlama
• Adobe: Magento Open Source 2.4.9 sürüm notları