UnoPim 3.1 nasıl kurulur: gereksinimler, Docker, Composer ve canlıya çıkış kontrol listesi

UnoPim, Laravel üzerine kurulu, MIT lisansıyla yayınlanan açık kaynaklı bir PIM (ürün bilgi yönetimi) sistemi. Güncel sürüm 29 Eylül 2026’da yayınlanan 3.1.3. Bu rehberde iki kurulum yolunu, sık atlanan noktaları ve bir UnoPim kurulumu canlıya çıkmadan önce neleri kontrol ettiğimizi bulacaksınız.

PIM’e yeni misiniz? Önce PIM sisteminin ne olduğunu ve bir Magento mağazasının ne zaman PIM’e ihtiyaç duyduğunu okuyun.

UnoPim sistem gereksinimleri

İki ayrıntı sık gözden kaçar. Birincisi, PostgreSQL kullansanız bile pdo_mysql gerekli. İkincisi, MariaDB desteği 3.1.0 ile tam destek haline geldi; DB_CONNECTION=mariadb kullanın ve güncelleme yedekleri için sunucuya mariadb-dump kurun.

1. yol: UnoPim’i Docker ile kurmak

Test, demo veya kendi verilerinize ilk bakış için doğru seçim bu. Hazır imajlar kullandığı için kodu indirmenize gerek yok.

curl -O https://raw.githubusercontent.com/unopim/unopim/3.x/compose.yaml
docker compose up -d

İlk başlatmadan önce yönetici giriş bilgilerini compose.yaml dosyasının yanındaki bir .env:

INSTALLER_ADMIN_EMAIL=you@example.com
INSTALLER_ADMIN_PASSWORD=choose-a-strong-password

Ardından http://localhost:8000/adminadresini açın. Şifreyi boş bırakırsanız UnoPim rastgele bir şifre oluşturur ve konteyner içinde storage/app/admin-credentials.txt dosyasına kaydeder. İlk girişten sonra değiştirin.

Docker yapısı varsayılan olarak PostgreSQL 16, Redis ve Elasticsearch 8 kullanır. Bunun yerine MySQL kullanmak için compose.mysql.yamldosyasını ekleyin. Bunu veri yüklemeden önce kararlaştırın: veritabanını sonradan değiştirmek yeni bir veritabanı gerektirir.

2. yol: UnoPim’i Composer ile sunucuya kurmak

Canlı kullanım için UnoPim’i doğrudan Nginx ve PHP-FPM bulunan bir Ubuntu sunucusuna kuruyoruz. Böylece diğer uygulamalar gibi güncellenebilir, yedeklenebilir ve izlenebilir.

composer create-project unopim/unopim
cd unopim
php artisan unopim:install

Kurulum aracı veritabanı bilgilerinizi sorar ve yönetici hesabını oluşturur. Nginx belge kökünü public klasörüne yönlendirin; storage ve bootstrap/cache klasörlerini web sunucusu kullanıcısı için yazılabilir yapın.

Kuyruk işçisini atlamayın

İçe aktarma, dışa aktarma, tamlık puanları, yapay zeka görevleri, webhook’lar ve Dijital Ürün Pasaportu yayınlama işlerinin hepsi kuyruklarla çalışır. Çalışan bir işçi yoksa bu işler sonsuza kadar bekler ve yönetim paneli takılmış gibi görünür. İşçiyi beş kuyruğun hepsiyle başlatın:

php artisan queue:work --queue=webhooks,system,completeness,default,publication

Sunucuda Supervisor ile sürekli çalışır halde tutun:

[program:unopim-worker]
command=php /var/www/unopim/artisan queue:work --queue=webhooks,system,completeness,default,publication --sleep=3 --tries=3
user=www-data
autostart=true
autorestart=true
stdout_logfile=/var/log/unopim-worker.log

Her güncellemeden sonra işçiyi yeniden başlatın ki yeni kodu yüklesin.

Canlıya çıkış kontrol listesi

1. HTTPS only, with APP_ENV=production ve APP_DEBUG=false.
2. Dikkat: APP_KEY güvende kalsın. Yapay zeka sağlayıcı anahtarları gibi kayıtlı erişim bilgilerini şifreler. Kaybederseniz bunları yeniden girmeniz gerekir.
3. Önbellek ve kuyruklar için Redis, PIM’de birkaç kişiden fazlası çalışmaya başladığında.
4. Büyük kataloglar için Elasticsearch. Arama ve filtreler yavaşladığında ELASTICSEARCH_ENABLED=true yapın.
5. Yükleme sınırlarını PHP ve Nginx’te en büyük görsellerinize ve içe aktarma dosyalarınıza göre ayarlayın.
6. Günlük yedek: veritabanı ve storage klasörü, ayrıca denenmiş bir geri yükleme.
7. Ekip başına yönetici kullanıcıları ve roller, tek bir ortak giriş değil.
8. Bir güncelleme düzeni. Her sürümden önce UPGRADE.md dosyasını ve değişiklik kaydını okuyun, önce test ortamında deneyin.

UnoPim’i Magento’ya bağlamak

Bir PIM, ürün verileri elle dışa aktarma olmadan mağazanıza aktığında değer kazanır. UnoPim’in REST API’leri ve webhook’ları var, bağlantı eklentileri de UnoPim eklenti pazarında listeleniyor. Önce eşleştirmeyi planlayın: UnoPim’deki hangi özellikler, aileler ve varyant eksenleri Magento’daki hangi özellik setlerine ve yapılandırılabilir ürünlere karşılık geliyor. Akeneo’dan mı geçiyorsunuz? Akeneo alternatifi rehberimize.

Sıkça sorulan sorular

UnoPim ücretsiz mi?

Evet. UnoPim, MIT lisanslı açık kaynak bir yazılım. Barındırma için, yardıma ihtiyacınız olursa kurulum veya geliştirme için ödeme yaparsınız.

UnoPim için Elasticsearch gerekli mi?

Hayır. Varsayılan olarak kapalı; bu durumda arama veritabanı üzerinden yapılır. Büyük kataloglarda açın.

UnoPim için hangi veritabanını seçmeliyim?

MySQL, MariaDB ve PostgreSQL’in hepsi destekleniyor. Ekibinizin zaten işlettiği ve yedeklediği veritabanını seçin. Composer kurulumu varsayılan olarak MySQL, Docker yapısı ise PostgreSQL kullanır.

UnoPim içe aktarmalarım neden çalışmıyor?

Neredeyse her durumda kuyruk işçisi çalışmıyordur ya da beş kuyruğun hepsiyle başlatılmamıştır.

UnoPim kurulumunda yardım mı lazım?

Resmi UnoPim partneri olarak UnoPim’i kuruyor ve barındırıyor, verileri Akeneo’dan veya tablolardan taşıyor ve Magento’ya bağlıyoruz. UnoPim kurulum hizmetimizegöz atın ya da ücretsiz analiz için bilgilerinizi aşağıya bırakın.