UnoPim 3.1 installeren: systeemeisen, Docker, Composer en een checklist voor productie

UnoPim is een open source PIM-systeem (product information management) gebouwd op Laravel en uitgebracht onder de MIT-licentie. De huidige versie is 3.1.3, uitgebracht op 29 september 2026. Deze gids laat de twee manieren van installeren zien, de punten die vaak worden gemist, en wat wij controleren voordat een UnoPim-installatie live gaat.

Nieuw met PIM? Lees eerst wat een PIM-systeem is en wanneer een Magento-webshop er een nodig heeft .

Systeemeisen van UnoPim

Twee details worden vaak gemist. Ten eerste is pdo_mysql nodig, ook als je PostgreSQL gebruikt. Ten tweede wordt MariaDB sinds 3.1.0 volwaardig ondersteund; gebruik DB_CONNECTION=mariadb en installeer mariadb-dump op de server voor back-ups bij upgrades.

Optie 1: UnoPim installeren met Docker

Dit is de juiste keuze voor een test, een demo of een eerste blik op je eigen data. Het gebruikt kant-en-klare images, dus je hoeft de code niet uit te checken.

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

Zet vóór de eerste start de admin-login in een .env -bestand naast compose.yaml:

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

Open daarna http://localhost:8000/admin. Laat je het wachtwoord leeg, dan maakt UnoPim een willekeurig wachtwoord aan en slaat het op in storage/app/admin-credentials.txt in de container. Wijzig het na de eerste login.

De Docker-stack gebruikt standaard PostgreSQL 16, Redis en Elasticsearch 8. Wil je MySQL gebruiken, voeg dan compose.mysql.yamltoe. Beslis dit voordat je data laadt: later van database wisselen vraagt een nieuwe database.

Optie 2: UnoPim installeren met Composer op een server

Voor productie installeren we UnoPim direct op een Ubuntu-server met Nginx en PHP-FPM, zodat het net als elke andere applicatie kan worden bijgewerkt, geback-upt en gemonitord.

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

De installer vraagt je databasegegevens en maakt het admin-account aan. Laat de Nginx document root naar de map public wijzen en maak storage en bootstrap/cache schrijfbaar voor de webservergebruiker.

Sla de queue worker niet over

Imports, exports, volledigheidsscores, AI-taken, webhooks en het publiceren van het Digitaal Productpaspoort draaien allemaal op queues. Draait er geen worker, dan wachten deze jobs eindeloos en lijkt de admin vast te hangen. Start hem met alle vijf de queues:

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

Houd hem op een server draaiende met Supervisor:

[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

Herstart de worker na elke update, zodat hij de nieuwe code laadt.

Checklist voor productie

1. Alleen HTTPS, met APP_ENV=production en APP_DEBUG=false.
2. Bewaar APP_KEY veilig. Hiermee worden opgeslagen inloggegevens versleuteld, zoals sleutels van AI-aanbieders. Raak je hem kwijt, dan moet je ze opnieuw invoeren.
3. Redis voor cache en queues zodra meer dan een paar mensen in het PIM werken.
4. Elasticsearch voor grote catalogi. Zet ELASTICSEARCH_ENABLED=true wanneer zoeken en filters traag worden.
5. Uploadlimieten in PHP en Nginx die passen bij je grootste afbeeldingen en importbestanden.
6. Dagelijkse back-ups van de database en de map storage , en een geteste restore.
7. Admin-gebruikers en rollen per team, geen gedeelde login.
8. Een updateroutine. Lees vóór elke release UPGRADE.md en de changelog, en test eerst op staging.

UnoPim koppelen aan Magento

Een PIM loont pas als productdata zonder handmatige exports naar je webshop stroomt. UnoPim heeft REST-API’s en webhooks, en connectors staan in de UnoPim extensions-marketplace. Plan eerst de mapping: welke attributen, families en variantassen in UnoPim horen bij welke attribuutsets en configureerbare producten in Magento. Stap je over van Akeneo? Bekijk onze gids over het Akeneo-alternatief.

Veelgestelde vragen

Is UnoPim gratis?

Ja. UnoPim is open source onder de MIT-licentie. Je betaalt voor hosting, en voor installatie of ontwikkeling als je hulp nodig hebt.

Heeft UnoPim Elasticsearch nodig?

Nee. Het staat standaard uit en zoeken valt dan terug op de database. Zet het aan voor grote catalogi.

Welke database moet ik kiezen voor UnoPim?

MySQL, MariaDB en PostgreSQL worden allemaal ondersteund. Kies de database die je team al draait en back-upt. De Composer-installatie gebruikt standaard MySQL, de Docker-stack PostgreSQL.

Waarom draaien mijn UnoPim-imports niet?

Bijna altijd draait de queue worker niet, of is hij gestart zonder alle vijf de queues.

UnoPim laten inrichten?

Als officiële UnoPim-partner installeren en hosten we UnoPim, zetten we data over vanuit Akeneo of spreadsheets en koppelen we het aan Magento. Bekijk onze UnoPim-implementatieservice, of laat hieronder je gegevens achter voor een gratis analyse.