Mautic 7 Composer, Apache, MariaDB ve HTTPS ile nasıl kurulur

Mautic açık kaynaklı bir pazarlama otomasyonu platformudur: kişileri izler, segmentler oluşturur, çok adımlı kampanyalar yürütür ve e-posta gönderir; potansiyel müşterileri yakalamak için formlar ve açılış sayfaları sunar. Bu rehber Mautic 7'yi, Mautic belgelerinin Mautic 6'dan beri Mautic'i kurmanın, güncellemenin ve yönetmenin varsayılan yolu olarak gösterdiği resmi Composer projesinden kurar. PHP ve MariaDB ile birlikte Apache, Mautic'i yerel bir portta çalıştırır; önde Caddy otomatik HTTPS sağlar, kurulum kabuktan yapılır, cron arka plan görevlerini yürütür ve bir transactional e-posta servisi iletilerinizi teslim eder. Yedekleme, güncelleme ve sorun giderme kurulumu tamamlar.

Adım 1 — Apache, PHP, MariaDB ve Composer'ı kurun

Web sunucusunu, Mautic listesindeki tüm eklentileriyle PHP'yi, veritabanı sunucusunu ve Composer'ı dağıtımınızdan kurun:

sudo apt update
sudo apt install apache2 libapache2-mod-php php-cli php-mysql php-xml php-imap php-zip php-intl php-curl php-gd php-mbstring php-bcmath mariadb-server composer unzip git
php -v
php -m | grep -E 'imap|intl|bcmath|zip|gd|mbstring|curl|xml|mysql'
composer --version

php -v Ubuntu 24.04'te 8.3, Debian 12'de 8.2 yazar; grep ise gerekli her eklentiyi listeler.

Adım 2 — Varlık derlemesi için Node.js'i kurun

Mautic 5'ten beri npm zorunludur: Composer projesi kurulum ve her güncelleme sırasında npm ci çalıştırır ve Mautic'in ön yüz varlıklarını derler. Mautic'in resmi Docker imajı NodeSource'tan Node.js 24 kullanır; aynısını NodeSource'un apt deposundan kurun:

sudo apt install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

NODE_MAJOR=24
sudo tee /etc/apt/sources.list.d/nodesource.sources <<EOF
Types: deb
URIs: https://deb.nodesource.com/node_${NODE_MAJOR}.x/
Suites: nodistro
Components: main
Signed-By: /etc/apt/keyrings/nodesource.gpg
EOF
sudo apt update
sudo apt install nodejs
node -v
npm -v

node -v bir v24 sürümü yazmalıdır.

Adım 3 — PHP'yi ayarlayın ve veritabanını oluşturun

Web sunucusunun PHP sınırlarını Mautic'in resmi imajının kullandığı değerlere yükseltin. Dosya yolu PHP sürümünüzü içerdiği için önce onu bir değişkene okuyun:

PHPV=$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;')
echo $PHPV
sudo nano /etc/php/$PHPV/apache2/conf.d/99-mautic.ini

memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 512M
post_max_size = 512M
date.timezone = UTC

max_execution_time = 300, Mautic'in en az 240 saniye şartını karşılar. Composer ve cron'un kullandığı komut satırı PHP'si, çalışma süresi sınırı olmayan kendi varsayılanlarını korur.

Veritabanı kullanıcısı için openssl rand -hex 24 ile bir parola üretin, ardından MariaDB kabuğunu root olarak açın (sudo mariadb) ve veritabanıyla kullanıcıyı oluşturun. change-me yerine ürettiğiniz parolayı yazın:

CREATE DATABASE mautic CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mautic'@'localhost' IDENTIFIED BY 'change-me';
GRANT ALL PRIVILEGES ON mautic.* TO 'mautic'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Ubuntu ve Debian'ın varsayılan yapılandırmasında MariaDB yalnızca localhost üzerinde dinler; bu nedenle güvenlik duvarı kuralı gerekmez.

Adım 4 — Mautic'i Composer ile indirin

Mautic çalışırken yapılandırmasını, önbelleğini, loglarını ve medya dosyalarını yazar; bu yüzden projenin tamamı web sunucusu kullanıcısı www-data'ya aittir ve her Composer ile konsol komutu bu kullanıcıyla çalışır. Composer ve npm'in önbellekleri için yazılabilir bir ev dizini de gerekir; onlara web kökünün dışında kalan /var/lib/mautic-build dizinini verin:

sudo mkdir -p /var/www/mautic /var/lib/mautic-build
sudo chown www-data:www-data /var/www/mautic /var/lib/mautic-build
cd /var/www/mautic
sudo -u www-data env HOME=/var/lib/mautic-build composer create-project mautic/recommended-project:^7.0 /var/www/mautic --no-interaction

^7.0 en son Mautic 7 sürümünü seçer. Komut Mautic'i, eklentilerini ve temalarını indirir, npm ci çalıştırır ve varlıkları üretir; bu birkaç dakika sürer. Bitince yapıyı kontrol edin:

ls /var/www/mautic

bin, config, docroot, var ve composer.json görmelisiniz. Web'e yalnızca docroot sunulur; yapılandırma ve loglar bunun dışında kalır.

Adım 5 — Kurulumu komut satırından çalıştırın

Mautic'in bir web kurulum sihirbazı da vardır, ancak siz bitirmeden adresi bulan herkes ona erişebilir. Komut satırı kurulumu bu açığı kapatır. Onu www-data olarak; genel adresiniz, Adım 3'teki veritabanı bilgileri ve güçlü bir yönetici parolasıyla çalıştırın (Mautic 5.1 sürümünden beri karmaşık parola ister):

cd /var/www/mautic
sudo -u www-data php bin/console mautic:install https://mautic.example.com --db_driver=pdo_mysql --db_host=localhost --db_port=3306 --db_name=mautic --db_user=mautic --db_password='change-me' --db_backup_tables=false --admin_firstname=Ada --admin_lastname=Admin --admin_username=admin --admin_email[email protected] --admin_password='Change-me-to-a-long-Passw0rd'

Kurulum gereksinimleri kontrol eder, şemayı oluşturur, varsayılan verileri yükler ve yönetici kullanıcıyı oluşturur. Kritik bir eksik varsa bir hata mesajıyla durur. Sonrasında config/local.php dosyası oluşur; veritabanı ayarlarını ve gizli anahtarı tutar, www-data'ya aittir ve docroot içinde değildir.

Adım 6 — Mautic'i yerel bir portta Apache ile sunun

Apache, PHP'yi docroot ile gelen .htaccess kurallarıyla sunar; Caddy onun önünde duracaktır. Apache'yi 80 numaralı porttan 127.0.0.1:8080 adresine taşıyın ve varsayılan siteyi kapatın:

sudo sed -i 's/^Listen 80$/Listen 127.0.0.1:8080/' /etc/apache2/ports.conf
sudo a2dissite 000-default
sudo a2enmod rewrite setenvif
sudo nano /etc/apache2/sites-available/mautic.conf

Bu sanal sunucuyu yapıştırın. AllowOverride All, Mautic'in .htaccess kurallarını etkinleştirir; SetEnvIf satırı ise Caddy öyle bildirdiğinde PHP'ye özgün isteğin HTTPS kullandığını söyler. Bu porta yalnızca Caddy erişebildiği için bu başlığa güvenilebilir:

<VirtualHost 127.0.0.1:8080>
    ServerName mautic.example.com
    DocumentRoot /var/www/mautic/docroot

    SetEnvIf X-Forwarded-Proto "^https$" HTTPS=on

    <Directory /var/www/mautic/docroot>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/mautic-error.log
    CustomLog ${APACHE_LOG_DIR}/mautic-access.log combined
</VirtualHost>

Siteyi etkinleştirin, yapılandırmayı test edin ve Apache'yi yeniden başlatın:

sudo a2ensite mautic
sudo apache2ctl configtest
sudo systemctl restart apache2
sudo ss -tlnp | grep apache2
curl -I http://127.0.0.1:8080/

configtest komutu Syntax OK yazar, ss Apache'yi yalnızca 127.0.0.1:8080 üzerinde gösterir ve curl Mautic'ten bir HTTP yanıtı alır; bu genellikle giriş sayfasına bir yönlendirmedir.

Adım 7 — Caddy ile HTTPS ekleyin ve güvenilen proxy'leri ayarlayın

/etc/caddy/Caddyfile dosyasına bir site bloğu ekleyin ve Caddy'yi yeniden yükleyin:

mautic.example.com {
    reverse_proxy 127.0.0.1:8080
}

sudo systemctl reload caddy
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

https://mautic.example.com adresini açın ve Adım 5'teki yönetici hesabıyla giriş yapın. Ardından Settings (dişli simgesi) → Configuration → System Settings bölümünü açın ve şunları ayarlayın:

• Site URL: https://mautic.example.com.
• Trusted proxies: 127.0.0.1. Mautic belgeleri bu ayarı SSL sonlandıran bir proxy arkasında zorunlu sayar; ayrıca Mautic'in gerçek ziyaretçi IP adresini 127.0.0.1 yerine Caddy'nin X-Forwarded-For başlığından görmesini sağlar, izleme buna dayanır.
• Trusted hosts: mautic.example.com; böylece Mautic yalnızca kendi alan adınıza yanıt verir.

Adım 8 — Cron görevlerini planlayın

Segmentler, kampanyalar ve segment e-postaları yalnızca cron görevleriyle işlenir. Mautic segment güncelleme, kampanya güncelleme, kampanya tetikleme, mesaj kuyruğu ve özel alan görevlerini zorunlu olarak listeler ve aynı dakikada başlamamaları için zamanlarının kaydırılmasını önerir. /etc/cron.d/mautic dosyasını sudo nano /etc/cron.d/mautic ile oluşturun; her satır www-data olarak çalışır:

0,15,30,45 * * * * www-data php /var/www/mautic/bin/console mautic:segments:update --no-interaction --no-ansi
5,20,35,50 * * * * www-data php /var/www/mautic/bin/console mautic:campaigns:update --no-interaction --no-ansi
10,25,40,55 * * * * www-data php /var/www/mautic/bin/console mautic:campaigns:trigger --no-interaction --no-ansi
2,17,32,47 * * * * www-data php /var/www/mautic/bin/console mautic:messages:send --no-interaction --no-ansi
7,22,37,52 * * * * www-data php /var/www/mautic/bin/console mautic:broadcasts:send --no-interaction --no-ansi
12,42 * * * * www-data php /var/www/mautic/bin/console mautic:custom-field:create-column --no-interaction --no-ansi
13,43 * * * * www-data php /var/www/mautic/bin/console mautic:custom-field:delete-column --no-interaction --no-ansi
8,23,38,53 * * * * www-data php /var/www/mautic/bin/console mautic:import --no-interaction --no-ansi
3,33 * * * * www-data php /var/www/mautic/bin/console mautic:reports:scheduler --no-interaction --no-ansi

İlk üç zamanlama Mautic belgelerinden gelir; diğerleri boş dakikalara dağıtılmıştır. mautic:broadcasts:send segment e-postalarını gönderir, mautic:import büyük CSV içe aktarmalarını arka planda işler, mautic:reports:scheduler ise planlanmış raporları e-postayla yollar. Mautic, geri dönen e-postaları işlemek için mautic:email:fetch ve kuyruğa alınmış webhook'lar için mautic:webhooks:process gibi isteğe bağlı başka görevler de belgeler; bu özellikleri kullandığınızda onları ekleyin. Çıktısını görmek için bir görevi elle çalıştırın, ardından cron'un dosyayı okuduğunu doğrulayın:

sudo -u www-data php /var/www/mautic/bin/console mautic:segments:update --no-interaction
journalctl -u cron --since "30 min ago"

Adım 9 — Bir e-posta servisi bağlayın

Mautic e-postayı smtp://user:[email protected]:587 biçiminde bir SMTP DSN ile Symfony Mailer üzerinden gönderir. Settings → Configuration → Email Settings bölümünde gönderen adını ve denetiminizdeki bir alan adına ait bir adresi girin, ardından transactional e-posta sağlayıcınızın veya SMTP relay'inizin verdiği SMTP sunucusunu, 587 numaralı portu, kullanıcı adını ve parolayı yazın; Symfony Mailer 587 numaralı porttaki bağlantıyı STARTTLS ile şifreler. Sağlayıcınızın verdiği SPF, DKIM ve DMARC kayıtlarını yayınlayın; aksi halde iletileriniz spam klasörüne düşer.

Teslimatı uçtan uca test etmek için yalnızca kendi kişi kaydınızı içeren bir segment oluşturun, ona bir e-posta gönderin ve iletinin ulaştığını, bağlantılarının da https://mautic.example.com üzerinden izlendiğini kontrol edin.

Yedekleme ve geri yükleme

Mautic'in durumu MariaDB veritabanı ile proje klasöründen oluşur: config/local.php (veritabanı ayarları ve gizli anahtar), docroot/media içindeki yüklenmiş medya ve composer.json ile composer.lock dosyalarınız. Veritabanını, Mautic'i engellemeden tutarlı bir InnoDB anlık görüntüsü veren --single-transaction ile dökün ve projeyi önbellekler ve node_modules olmadan arşivleyin:

sudo mkdir -p /opt/backups
sudo chown $USER:$USER /opt/backups
chmod 700 /opt/backups
sudo mariadb-dump --single-transaction --quick mautic | gzip > /opt/backups/mautic-db-$(date +%F).sql.gz
sudo tar czf /opt/backups/mautic-files-$(date +%F).tar.gz -C /var/www --exclude=mautic/node_modules --exclude=mautic/var/cache mautic

/etc/apache2/sites-available/mautic.conf, /etc/cron.d/mautic ve PHP ayar dosyasının da kopyalarını saklayın. Geri yüklemek için Apache'yi durdurun, dosyaları açın, dökümü içe aktarın ve önbelleği temizleyin. Tarihleri kendi yedeğinizinkilerle değiştirin:

sudo systemctl stop apache2
sudo tar xzf /opt/backups/mautic-files-2026-10-09.tar.gz -C /var/www
sudo chown -R www-data:www-data /var/www/mautic
gunzip -c /opt/backups/mautic-db-2026-10-09.sql.gz | sudo mariadb mautic
sudo -u www-data php /var/www/mautic/bin/console cache:clear
sudo systemctl start apache2

Yeni bir sunucuda önce Adım 1–3'ü ve Adım 6'yı çalıştırın, geri yükleyin, ardından node_modules klasörünü yeniden oluşturmak için /var/www/mautic içinde sudo -u www-data env HOME=/var/lib/mautic-build composer install komutunu çalıştırın. Her yedeği sunucunun dışına kopyalayın ve düzenli olarak bir geri yükleme deneyin.

Mautic'i güncelleme

Mautic'in güncelleme rehberi, çalışan ve test edilmiş bir yedek olmadan asla güncelleme yapılmamasını ve daha yüksek bir PHP sürümü gibi yeni gereksinimler için sürüm notlarının kontrol edilmesini söyler. ^7.0 Composer kısıtı tüm Mautic 7 sürümlerine zaten izin verir; yeni bir ana sürüm için önce sürüm notlarında anlatıldığı gibi composer.json içindeki Mautic paket sürümlerini değiştirin. Ardından mevcut Composer dosyalarını saklayın, güncelleyin ve belgelerdeki veritabanı adımlarıyla bitirin:

cd /var/www/mautic
sudo -u www-data cp composer.json composer.json.bak
sudo -u www-data cp composer.lock composer.lock.bak
sudo -u www-data env HOME=/var/lib/mautic-build composer update --with-dependencies
sudo -u www-data php bin/console cache:clear
sudo -u www-data php bin/console mautic:update:apply --finish
sudo -u www-data php bin/console doctrine:migration:migrate --no-interaction
sudo -u www-data php bin/console cache:clear

Güncelleme başarısız olursa iki .bak dosyasını geri koyun ve önceki sürümlere dönmek için yukarıdaki gibi composer install çalıştırın, ardından veritabanını yedeğinizden geri yükleyin. Önerilen proje tüm klasörün bir Git deposunda tutulmasını önerir; böylece bir güncelleme docroot/.htaccess gibi iskelet dosyalarını değiştirdiğinde git diff bunu gösterir. PHP, Apache ve MariaDB'yi sudo apt update && sudo apt upgrade ile güncel tutun.

Sorun giderme

Apache Address already in use hatasıyla başlamıyor

Başka bir servis, genellikle Caddy, zaten 80 numaralı portu dinliyor. Adım 6'nın ports.conf dosyasını Listen 127.0.0.1:8080 olarak değiştirdiğinden emin olun, sudo ss -tlnp | grep -E ':80 |:8080 ' ile kontrol edin, ardından sudo systemctl restart apache2 çalıştırın.

Composer bir PHP eklentisi eksik olduğu için duruyor

Mautic'in Composer dosyaları gereksinimler sayfasındaki eklentilere ek olarak ext-imap, ext-zip, ext-iconv, ext-pdo ve ext-zlib ister. Eksik php- paketini Adım 1'deki gibi kurun, php -m ile doğrulayın ve Composer komutunu yeniden çalıştırın. PHP 8.4 kullanan sürümlerde php-imap mevcut değildir; Ubuntu 24.04 veya Debian 12 kullanın.

Giriş döngüye giriyor veya Mautic http:// bağlantıları üretiyor

Mautic isteğin HTTPS üzerinden geldiğini bilmiyor. Apache sitesindeki SetEnvIf satırını kontrol edin, System Settings içinde Trusted proxies değerini 127.0.0.1, Site URL değerini https:// adresi olarak ayarlayın ve önbelleği temizleyin.

Segmentler, kampanyalar veya segment e-postaları hiç çalışmıyor

Cron görevleri eksik veya hata veriyor. /etc/cron.d/mautic dosyasının root kullanıcısına ait olduğunu, adında nokta bulunmadığını ve bir satır sonuyla bittiğini kontrol edin, journalctl -u cron çıktısını okuyun ve hatayı görmek için başarısız komutu www-data olarak elle çalıştırın. Uygulama hataları /var/www/mautic/var/logs içinde loglanır.

E-postalar teslim edilmiyor

Email Settings içindeki SMTP sunucusunu, portu, kullanıcı adını ve parolayı kontrol edin, sağlayıcınızın gönderen alan adını doğruladığından emin olun ve /var/www/mautic/var/logs içindeki en yeni log dosyasını okuyun. Sunucu ile sağlayıcı arasındaki her güvenlik duvarı, sağlayıcınızın 587 numaralı portuna giden bağlantılara izin vermelidir.

Sonraki adımlar

• Daha hafif bir bülten aracıyla karşılaştırın: listmonk nasıl kurulur.
• Pazarlamayı satışa Odoo nasıl kurulur rehberiyle bağlayın.
• E-posta pazarlaması için sunucu seçeneklerini E-posta pazarlama hosting sayfasında inceleyin.
• Her isteğe bağlı görev ve seçenekleri için Mautic'in cron görevleri belgelerini okuyun.