Ubuntu'da adım adım Magento 2.4.9 kurulumu

Magento 2.4.9'un gereksinimleri

Adobe'nin kendi sunucularınızdaki Magento Open Source ve Adobe Commerce 2.4.9 için listelediği sürümler bunlar. 2.4.8'e göre çok şey değişti: PHP 8.2, MariaDB 10.6, Elasticsearch ve OpenSearch 2 artık desteklenmiyor.

Sunucu seçimi

Sunucuyu ana sayfaya göre değil; arama, indeksleme ve ödeme sayfasına göre boyutlandırın. 50.000 ürünlük bir katalog, mağaza ön yüzü yavaşlamadan çok önce OpenSearch ve veritabanı için bellek ister.

• VPS mi, dedicated mı: çoğu mağaza için iyi bir VPS yeterlidir. Yoğun saatlerde garantili CPU gerekiyorsa dedicated donanım seçin.
• Konum: müşterilerinize yakın bir veri merkezi seçin. Almanya ve Avrupa'nın büyük bölümü için Frankfurt veya Amsterdam, Türkiye için İstanbul, Birleşik Krallık için Londra.
• Disk: yalnızca NVMe. Magento çok sayıda küçük dosya okur ve yazar; veritabanı da indeksleme sırasında diski yoğun kullanır.
• Yedekler: sağlayıcının aldığı anlık görüntüler (snapshot) tek başına bir yedek planı değildir. Günlük veritabanı dökümlerini ve medya kopyalarını ikinci bir konumda saklayın.

Ubuntu'yu hazırlama

Bu adımlar yeni kurulmuş bir Ubuntu 24.04 LTS sunucusu ve sudo yetkili bir kullanıcı varsayar. Örnek adları ve parolaları kendi değerlerinizle değiştirin.

# mağaza için ayrı bir kullanıcı
adduser magento
usermod -aG sudo magento

# güncellemeler, saat dilimi, swap
apt update && apt upgrade -y
timedatectl set-timezone Europe/Berlin
fallocate -l 4G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

# güvenlik duvarı: yalnızca SSH, HTTP ve HTTPS
ufw default deny incoming
ufw allow OpenSSH
ufw allow 80,443/tcp
ufw enable

# kaba kuvvet saldırılarına karşı koruma ve otomatik güvenlik güncellemeleri
apt install -y fail2ban unattended-upgrades

• SSH anahtarıyla giriş yapın ve parolayla girişi şu dosyada kapatın: /etc/ssh/sshd_config (PasswordAuthentication no).
• Mağaza Cloudflare arkasındaysa 80 ve 443 numaralı portlara yalnızca Cloudflare'in IP aralıklarından erişime izin verin. Böylece ziyaretçiler sunucuya doğrudan ulaşamaz.
• Veritabanı, OpenSearch ve Valkey yalnızca 127.0.0.1 adresini dinler. Hiçbiri için açık port gerekmez.

tuned-adm ve neden önemli

tuned, belirli bir iş yükü türü için bir dizi çekirdek ve sistem ayarı uygulayan bir Linux servisidir: CPU frekans davranışı, disk zamanlaması, bellek ve ağ parametreleri. Bir profil seçersiniz; tuned onu uygular ve yeniden başlatmadan sonra da korur.

apt install -y tuned
systemctl enable --now tuned
tuned-adm recommend          # tuned'ın bu makine için önerdiği profil
tuned-adm profile virtual-guest
tuned-adm active
tuned-adm verify

Servislerin kurulumu

nginx 1.30

Ubuntu'nun kendi nginx paketi 1.30'dan eskidir. nginx.org deposunu kullanın:

curl -fsSL https://nginx.org/keys/nginx_signing.key | gpg --dearmor -o /usr/share/keyrings/nginx.gpg
echo "deb [signed-by=/usr/share/keyrings/nginx.gpg] http://nginx.org/packages/ubuntu noble nginx" > /etc/apt/sources.list.d/nginx.list
apt update && apt install -y nginx

PHP 8.5 ve PHP-FPM

add-apt-repository -y ppa:ondrej/php
apt install -y php8.5-fpm php8.5-cli php8.5-bcmath php8.5-curl php8.5-gd php8.5-intl \
  php8.5-mbstring php8.5-mysql php8.5-soap php8.5-xml php8.5-xsl php8.5-zip php8.5-sockets

Şu değerleri /etc/php/8.5/fpm/php.ini dosyasında ve CLI'ın php.ini:

memory_limit = 2G
max_execution_time = 1800
realpath_cache_size = 10M
realpath_cache_ttl = 7200
opcache.memory_consumption = 512
opcache.max_accelerated_files = 130000
opcache.validate_timestamps = 0   # canlı mod (production): her yayına almadan sonra PHP-FPM'i yeniden başlatın (reload)

Mağazaya kendi PHP-FPM havuzunu verin; havuz magento kullanıcısıyla çalışsın. Ayrıca pm.max_children değerini sunucudaki belleğe göre ayarlayın: kabaca boş RAM'in 150 MB'a bölümü.

MariaDB 12.3

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | bash -s -- --mariadb-server-version="mariadb-12.3"
apt install -y mariadb-server
mariadb-secure-installation

mariadb -e "CREATE DATABASE magento;
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'change-this-password';
GRANT ALL ON magento.* TO 'magento'@'localhost';"

Sunucunuzdaki /etc/mysql/mariadb.conf.d/90-magento.cnf ve şu ayarlarla başlayın:

[mysqld]
innodb_buffer_pool_size = 4G          # tek sunuculu kurulumda RAM'in yaklaşık yarısı
tmpdir = /dev/shm                     # geçici tablolar bellekte
log_bin_trust_function_creators = 1   # Magento tetikleyiciler (trigger) oluşturur

OpenSearch 3

curl -fsSL https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | gpg --dearmor -o /usr/share/keyrings/opensearch.gpg
echo "deb [signed-by=/usr/share/keyrings/opensearch.gpg] https://artifacts.opensearch.org/releases/bundle/opensearch/3.x/apt stable main" > /etc/apt/sources.list.d/opensearch-3.x.list
apt update && OPENSEARCH_INITIAL_ADMIN_PASSWORD='Change-This-1!' apt install -y opensearch

Sunucunuzdaki /etc/opensearch/opensearch.yml ve şunları ayarlayın: network.host: 127.0.0.1 ve discovery.type: single-node. Java heap boyutunu jvm.options dosyasında katalog boyutuna göre 1–4 GB olarak ayarlayın, ardından şunu çalıştırın: systemctl enable --now opensearch.

Valkey 9

2.4.9'da önbellek ve oturumlar için Redis'in yerini Valkey alır ve aynı Magento ayarlarını kullanır. Ubuntu 24.04 yalnızca Valkey 7.2 paketini sunar; bu yüzden sürüm 9'u şu adresteki resmi sürümden kurun: valkey.io (kaynaktan derleyerek) ya da bir container olarak çalıştırın. Ubuntu 26.04, apt üzerinden Valkey 9 sunar. Valkey'i şu adrese bağlayın: 127.0.0.1 ve önbellek, tam sayfa önbelleği ve oturumlar için ayrı veritabanı numaraları kullanın.

Varnish 8

curl -s https://packagecloud.io/install/repositories/varnishcache/varnish80/script.deb.sh | bash
apt install -y varnish

Varnish, TLS sonlandırmanızın (nginx veya Cloudflare) arkasında 80 numaralı portu dinler ve nginx ile 8080 gibi dahili bir port üzerinden konuşur. Magento kurulduktan sonra VCL dosyasını şu komutla oluşturun: bin/magento varnish:vcl:generate.

Composer 2.10

curl -sS https://getcomposer.org/installer -o composer-setup.php
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version

Magento 2.4.9'u indirme

Kodu almanın üç yolu var. Canlı bir mağaza için Composer kullanın: ileride sorunsuz upgrade yapmanın ve güvenlik yamaları almanın tek yolu budur.

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

git clone --branch 2.4.9 --depth 1 \
  https://github.com/magento/magento2.git magento
cd magento && composer install

curl -LO https://github.com/magento/magento2/archive/refs/tags/2.4.9.tar.gz
tar xzf 2.4.9.tar.gz && mv magento2-2.4.9 magento
cd magento && composer install --no-dev

Magento'yu kurma

Önce dosya sahibini ayarlayın, ardından kurulum aracını magento kullanıcısıyla çalıştırın:

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

bin/magento setup:install \
  --base-url=https://www.example.com/ \
  --db-host=localhost --db-name=magento --db-user=magento --db-password='change-this-password' \
  --admin-firstname=Admin --admin-lastname=Store --admin-email=you@example.com \
  --admin-user=youradmin --admin-password='a-long-unique-password' \
  --backend-frontname=a-private-admin-path \
  --language=en_US --currency=EUR --timezone=Europe/Berlin --use-rewrites=1 \
  --search-engine=opensearch --opensearch-host=127.0.0.1 --opensearch-port=9200 \
  --opensearch-enable-auth=1 --opensearch-username=admin --opensearch-password='Change-This-1!' \
  --session-save=redis --session-save-redis-host=127.0.0.1 --session-save-redis-db=2 \
  --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0 \
  --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1

Aradığınız redis seçenekleri Valkey ile çalışır. Ardından canlı moda (production) geçin; cron ve indeksleyicileri ayarlayın:

bin/magento deploy:mode:set production
bin/magento cron:install
bin/magento indexer:set-mode schedule
bin/magento indexer:reindex

Kurulumdan sonra

• Varnish: yönetim panelinde şu bölüme gidin: Stores › Configuration › Advanced › System › Full Page Cache, Varnish'i seçin, VCL dosyasını oluşturun ve Varnish'e aktarın.
• Oturum kilidi: oturumlar Valkey'de tutuluyorsa 'disable_locking' => '1' değerini session › redis altında, app/etc/env.phpdosyasında ayarlayın. Sunucularımızdan birinde bu ayar, sayfa yüklendikten sonraki müşteri verisi isteklerini 2,2 sn'den 0,6 sn'ye indirdi.
• İki adımlı giriş yönetim paneli için açık kalsın. Her yönetici kullanıcı için doğrulama uygulamasını kurun.
• E-posta: sipariş e-postaları spam klasörüne düşmesin diye bir SMTP servisi bağlayın.
• Yedekler: her gece ikinci bir konuma veritabanı dökümü ve medya kopyası alın, en az bir kez de yedekten geri dönmeyi test edin.

Sık yapılan hatalar

Yardım mı gerekiyor?

MageBooster; Türkiye, Almanya, Birleşik Krallık ve Avrupa genelinde Magento, Mage-OS ve Hyvä mağazalarını kurar ve bakımını yapar. Kurulumun tamamını sizin için yapabilir ya da mevcut kurulumunuzu kontrol edebiliriz.