So installieren Sie UnoPim 3.1: Anforderungen, Docker, Composer und eine Checkliste für den Produktivbetrieb

UnoPim ist ein Open-Source-PIM-System (Product Information Management) auf Basis von Laravel, veröffentlicht unter der MIT-Lizenz. Die aktuelle Version ist 3.1.3 vom 29. September 2026. Diese Anleitung zeigt die zwei Wege der Installation, die Punkte, die oft übersehen werden, und was wir prüfen, bevor eine UnoPim-Installation live geht.

Neu bei PIM? Lesen Sie zuerst, was ein PIM-System ist und wann ein Magento-Shop eines braucht .

UnoPim-Systemanforderungen

Zwei Details werden oft übersehen. Erstens: pdo_mysql ist auch dann nötig, wenn Sie PostgreSQL verwenden. Zweitens: MariaDB wird seit 3.1.0 vollständig unterstützt; verwenden Sie DB_CONNECTION=mariadb und installieren Sie mariadb-dump auf dem Server für Backups vor Upgrades.

Option 1: UnoPim mit Docker installieren

Das ist die richtige Wahl für einen Test, eine Demo oder einen ersten Blick auf Ihre eigenen Daten. Es nutzt fertige Images, Sie müssen den Code also nicht auschecken.

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

Legen Sie vor dem ersten Start die Admin-Zugangsdaten in einer .env -Datei neben compose.yaml:

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

Öffnen Sie dann http://localhost:8000/admin. Wenn Sie das Passwort leer lassen, erstellt UnoPim ein zufälliges und speichert es in storage/app/admin-credentials.txt im Container. Ändern Sie es nach dem ersten Login.

Der Docker-Stack nutzt standardmäßig PostgreSQL 16, Redis und Elasticsearch 8. Für MySQL fügen Sie compose.mysql.yamlhinzu. Entscheiden Sie das, bevor Sie Daten laden: Ein späterer Wechsel der Datenbank erfordert eine neue Datenbank.

Option 2: UnoPim mit Composer auf einem Server installieren

Für den Produktivbetrieb installieren wir UnoPim direkt auf einem Ubuntu-Server mit Nginx und PHP-FPM. So lässt es sich wie jede andere Anwendung aktualisieren, sichern und überwachen.

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

Der Installer fragt nach Ihren Datenbankdaten und legt das Admin-Konto an. Richten Sie das Nginx-Document-Root auf den Ordner public und machen Sie storage und bootstrap/cache für den Webserver-Benutzer beschreibbar.

Den Queue Worker nicht vergessen

Importe, Exporte, Vollständigkeitswerte, KI-Aufgaben, Webhooks und die Veröffentlichung des Digitalen Produktpasses laufen alle über Queues. Läuft kein Worker, warten diese Jobs ewig und das Admin wirkt hängen geblieben. Starten Sie ihn mit allen fünf Queues:

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

Auf einem Server halten Sie ihn mit Supervisor am Laufen:

[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

Starten Sie den Worker nach jedem Update neu, damit er den neuen Code lädt.

Checkliste für den Produktivbetrieb

1. Nur HTTPS, mit APP_ENV=production und APP_DEBUG=false.
2. Bewahren Sie APP_KEY sicher auf. Er verschlüsselt gespeicherte Zugangsdaten, etwa Schlüssel von KI-Anbietern. Geht er verloren, müssen Sie diese neu eingeben.
3. Redis für Cache und Queues, sobald mehr als ein paar Personen im PIM arbeiten.
4. Elasticsearch für große Kataloge. Setzen Sie ELASTICSEARCH_ENABLED=true , wenn Suche und Filter langsam werden.
5. Upload-Limits in PHP und Nginx, die zu Ihren größten Bildern und Importdateien passen.
6. Tägliche Backups der Datenbank und des Ordners storage , und eine getestete Wiederherstellung.
7. Admin-Benutzer und Rollen pro Team, kein gemeinsamer Login.
8. Eine Update-Routine. Lesen Sie vor jedem Release UPGRADE.md und das Changelog, und testen Sie es zuerst auf Staging.

UnoPim mit Magento verbinden

Ein PIM lohnt sich, wenn die Produktdaten ohne manuelle Exporte in Ihren Shop fließen. UnoPim hat REST-APIs und Webhooks, und Konnektoren finden Sie im UnoPim-Extension-Marktplatz. Planen Sie zuerst das Mapping: welche Attribute, Familien und Varianten-Achsen in UnoPim zu welchen Attributsets und konfigurierbaren Produkten in Magento passen. Sie wechseln von Akeneo? Lesen Sie unseren Leitfaden zur Akeneo-Alternative.

Häufig gestellte Fragen

Ist UnoPim kostenlos?

Ja. UnoPim ist Open Source unter der MIT-Lizenz. Sie zahlen für das Hosting und für Einrichtung oder Entwicklung, wenn Sie Hilfe brauchen.

Braucht UnoPim Elasticsearch?

Nein. Es ist standardmäßig aus, und die Suche nutzt dann die Datenbank. Schalten Sie es für große Kataloge ein.

Welche Datenbank sollte ich für UnoPim wählen?

MySQL, MariaDB und PostgreSQL werden alle unterstützt. Wählen Sie die, die Ihr Team bereits betreibt und sichert. Die Composer-Installation nutzt standardmäßig MySQL, der Docker-Stack PostgreSQL.

Warum laufen meine UnoPim-Importe nicht?

Fast immer läuft der Queue Worker nicht, oder er wurde nicht mit allen fünf Queues gestartet.

Brauchen Sie Hilfe bei UnoPim?

Als offizieller UnoPim-Partner installieren und hosten wir UnoPim, übernehmen Daten aus Akeneo oder Tabellen und verbinden es mit Magento. Sehen Sie sich unseren UnoPim-Implementierungsservicean, oder hinterlassen Sie unten Ihre Daten für eine kostenlose Analyse.