Magento installeren: zo installeer je Magento 2.4.9 stap voor stap

Deze gids loopt stap voor stap door een Magento-installatie van versie 2.4.9 op een Linux-server. Elke vereiste en elk commando hieronder komt uit de officiële installatiegids van Adobe op Experience League. Heb je je ooit afgevraagd: “Magento, hoe installeer ik dat goed?”, dan is dit de volgorde die wij op servers van klanten aanhouden.

We gaan ervan uit dat je SSH-toegang hebt, root- of sudo-rechten, en een domein dat naar de server wijst. Voor een lokale testinstallatie werken dezelfde stappen in een container of VM.

Vereisten voor de Magento-installatie van 2.4.9

Magento Open Source en Adobe Commerce 2.4.9 zijn op 12 mei 2026 uitgebracht. Adobe ondersteunt alleen de exacte combinaties van services die het heeft getest. Voor on-premises 2.4.9 noemt de tabel met systeemvereisten:

Adobe geeft aan dat het supportteam je kan vragen eerst over te stappen op een vermelde combinatie voordat het problemen onderzoekt. Blijf voor een productiewebshop binnen deze tabel.

PHP-extensies en -instellingen

Magento Open Source vereist deze PHP-extensies: bcmath, ctype, curl, dom, fileinfo, filter, ftp, gd, hash, iconv, intl, json, libxml, mbstring, openssl, pcre, pdo_mysql, reflection, simplexml, soap, sockets, sodium, tokenizer, xmlwriter, xsl, zip en zlib. Controleer wat je hebt met:

php -v
php -m

In php.inistel je date.timezonein, verhoog je memory_limit (het voorbeeld van Adobe gebruikt 2G) en stel je de realpath-cache in:

memory_limit = 2G
realpath_cache_size = 10M
realpath_cache_ttl = 7200

Stap 1: database en OpenSearch voorbereiden

Maak een lege database en een eigen gebruiker aan:

mysql -u root -p
CREATE DATABASE magento;
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'a-strong-password';
GRANT ALL ON magento.* TO 'magento'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Sinds Magento 2.4 moet elke installatie Elasticsearch of OpenSearch gebruiken voor het zoeken in de catalogus, en de zoekmachine moet draaien voordat je installeert. Voor 2.4.9 betekent dat OpenSearch 3. Controleer of hij reageert voordat je verdergaat:

curl -X GET "http://localhost:9200/"

Draait OpenSearch op een andere host, dan raadt Adobe aan het achter een TLS-reverse proxy met HTTP Basic-authenticatie te zetten in plaats van poort 9200 open te stellen.

Stap 2: access keys ophalen

Magento wordt geïnstalleerd vanuit de Composer-repository van Adobe op repo.magento.com. Je hebt een paar access keys nodig:

1. Log in op de Commerce Marketplace.
2. Open My Profile > Access Keys en maak een nieuw paar aan.
3. Vraagt Composer om een gebruikersnaam, gebruik dan de public key. Gebruik als wachtwoord de private key.

Sla je de keys op in het Composer-bestand auth.json, dan krijg je geen vraag meer.

Stap 3: Magento 2.4.9 downloaden met Composer

Schakel over naar de eigenaar van het bestandssysteem (de gebruiker die eigenaar is van de webroot, niet root), ga naar je webroot en maak het project aan. Zo installeer je Magento 2 Open Source in een specifieke versie:

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

Gebruik voor Adobe Commerce magento/project-enterprise-edition . Zie je de foutmelding “Could not find package”, controleer dan het commando op typfouten en kijk of je keys toegang hebben tot die editie.

Stap 4: bestandsrechten instellen

De groep van de webserver heeft vóór de installatie schrijfrechten nodig op een paar mappen. De quick-startgids van Adobe gebruikt deze commando's (Ubuntu-voorbeeld met www-data):

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

Gebruik geen chmod 777. Het is een veelgebruikte shortcut in tutorials en een reëel beveiligingsrisico op een live server.

Stap 5: setup:install uitvoeren

Dit is de kern van de installatie van Magento 2.4.9. Voer het uit vanuit de Magento-root:

bin/magento setup:install \
  --base-url=https://www.example.com/ \
  --db-host=localhost \
  --db-name=magento \
  --db-user=magento \
  --db-password='a-strong-password' \
  --admin-firstname=Jane \
  --admin-lastname=Doe \
  --admin-email=admin@example.com \
  --admin-user=jane.admin \
  --admin-password='Use-a-long-passphrase-1' \
  --language=en_US \
  --currency=USD \
  --timezone=America/Chicago \
  --use-rewrites=1 \
  --search-engine=opensearch \
  --opensearch-host=localhost \
  --opensearch-port=9200 \
  --opensearch-index-prefix=magento2 \
  --opensearch-timeout=15

Een paar opties die je moet begrijpen:

• –base-url heeft het schema en een afsluitende slash nodig.
• –admin-password moet minstens 7 tekens lang zijn, met letters en cijfers. Kies iets veel langers en zet het tussen enkele aanhalingstekens.
• –backend-frontname bepaalt het adminpad. Adobe raadt aan deze optie weg te laten, zodat de installer een willekeurig pad genereert. De admin-URL wordt aan het eind getoond, en je kunt hem later opvragen met bin/magento info:adminuri.
• –use-secure=1, –base-url-secure en –use-secure-admin=1 zetten HTTPS aan voor de storefront en de admin. Je hebt ze alle drie nodig.
• bin/magento info:language:list, info:currency:list en info:timezone:list tonen geldige waarden.

Je kunt de installer opnieuw uitvoeren om fouten te herstellen of later SSL-instellingen toe te voegen. Voor de volledige lijst met opties voer je dit uit: bin/magento help setup:install.

Stap 6: cron installeren

Magento is afhankelijk van cron voor indexering, e-mails, sitemaps, wisselkoersen en meer. Installeer de Magento-crontab als eigenaar van het bestandssysteem:

bin/magento cron:install
crontab -l

Het commando zet zijn regels tussen de markeringen #~ MAGENTO START en #~ MAGENTO END en laat je andere cronjobs met rust. Gebruik --force om een bestaand Magento-blok te herschrijven.

Stap 7: overschakelen naar production mode

Een verse installatie draait in default mode. Schakel voor een live webshop over naar production mode, die de code compileert en de statische bestanden deployt:

bin/magento deploy:mode:set production
bin/magento deploy:mode:show

Gebruik developer mode op lokale omgevingen en stagingomgevingen waar je actief aan de code werkt.

Stap 8: Magento-installatiechecklist na de setup

• Laat je nginx-virtual host wijzen naar pub/ als document root, met het voorbeeldbestand nginx.conf.sample dat met Magento wordt meegeleverd.
• Configureer Valkey voor cache en sessies, en Varnish voor de full-page cache.
• Richt uitgaande e-mail in, zodat tweefactorauthenticatie voor de admin en klantmails werken.
• Voer bin/magento indexer:reindex en bin/magento cache:flushuit en open daarna de storefront en de admin.
• Regel back-ups en monitoring voordat je producten importeert.

Zie je het liever voorgedaan? Onze gratis Magento-videotutorials behandelen installatie en setup. Wil je PHP 8.5, OpenSearch, Valkey en Varnish liever niet zelf beheren, dan levert onze managed Magento-hosting een kant-en-klare, getunede 2.4.9-omgeving.

Veelvoorkomende fouten bij de Magento-installatie

• Could not find package. Meestal een typfout in de pakketnaam of versie, of access keys zonder recht op die editie. Controleer het commando en je keys in de Commerce Marketplace.
• Verbindingsfouten met de zoekmachine tijdens setup:install. OpenSearch draait niet, of de host, poort of inloggegevens kloppen niet. Test het met curl vanaf de webserver voordat je de installer opnieuw uitvoert.
• Permission denied op var, generated of pub/static. De commando's zijn als root uitgevoerd, of de bestanden zijn geen eigendom van de webservergroep. Zet de rechten uit stap 4 opnieuw als eigenaar van het bestandssysteem.
• Ontbrekende PHP-extensie. Composer of de installer noemt de ontbrekende extensie. Installeer die met je pakketbeheerder, herstart PHP-FPM en controleer met php -m.

Omdat je de installer meerdere keren kunt uitvoeren, kun je de oorzaak oplossen en setup:install opnieuw uitvoeren. Standaard overschrijft hij geen bestaande database; de optie --cleanup-database verandert dat.

Veelgestelde vragen

Kan ik Magento 2.4.9 op shared hosting installeren?

Meestal niet. Je hebt SSH, Composer, PHP 8.5 met specifieke extensies en een draaiende OpenSearch-service nodig. De meeste shared-hostingpakketten bieden die combinatie niet.

Wordt Elasticsearch nog ondersteund?

Volgens de zoekmachinegids van Adobe moeten installaties Elasticsearch of OpenSearch gebruiken, maar de tabel met vereisten voor 2.4.9 noemt alleen OpenSearch 3. Gebruik OpenSearch voor nieuwe 2.4.9-installaties.

Kan ik Apache gebruiken in plaats van nginx?

De tabel met vereisten voor 2.4.9 noemt nginx 1.30 en niet Apache. Apache kan nog steeds werken, maar nginx is de geteste en ondersteunde optie.

Wat is het verschil tussen Open Source en Adobe Commerce installeren?

De stappen zijn hetzelfde. Het verschil zit in het metapakket (project-community-edition of project-enterprise-edition) en of je access keys een licentie voor Adobe Commerce hebben.

Bronnen

• Adobe: systeemvereisten
• Adobe: quick-start on-premises installatie
• Adobe: geavanceerde on-premises installatie
• Adobe: PHP-instellingen
• Adobe: voorwaarden voor de zoekmachine
• Adobe: cron configureren en uitvoeren
• Adobe: de application mode instellen
• Adobe: release notes van Magento Open Source 2.4.9