Come installare Magento 2 (2026): Guida completa all'installazione per principianti - IT

Magento è una delle piattaforme di e-commerce più potenti disponibili. Ma installandolo? È lì che la maggior parte delle persone rimane bloccata. A differenza delle piattaforme più semplici, Magento necessita di configurazioni server specifiche, motori di ricerca, e un'accurata configurazione. Salta un passaggio, e passerai ore a risolvere i problemi.

Questa guida ti guida attraverso l'intero Magento 2 processo di installazione. Imparerai di cosa ha bisogno il tuo server, come installare utilizzando Composer (il metodo consigliato), e come configurare tutto correttamente. Che tu stia configurando un ambiente di sviluppo o un negozio di produzione, si applicano questi passaggi.

Una breve nota sulle versioni: Magento Open Source 2.4.8 è la versione attuale. Adobe ha rinominato Magento Commerce in Adobe Commerce, ma la versione open source rimane gratuita. Questa guida copre entrambi, sebbene il processo di installazione sia quasi identico.

Ultimo aggiornamento: febbraio 2026. Tutti i requisiti e i comandi verificati rispetto alla documentazione attuale.

Requisiti di sistema di Magento

Magento è affamato di risorse. Non funzionerà su hosting condiviso economico. Prima che inizi, conferma che il tuo server soddisfa questi requisiti.

Sistema operativo

Magento richiede Linux x86-64. Ubuntu 22.04 o 24.04 LTS, RHEL, CentOS, e Debian funzionano tutti. Windows e macOS non sono supportati per la produzione. Puoi utilizzare macOS per lo sviluppo locale, ma non distribuirlo.

Server web

Hai bisogno di Apache 2.4 o Nginx 1.18 (o più tardi). Apache richiede mod_rewrite abilitato. Nginx è spesso preferito per le prestazioni, ma funzionano entrambi bene. Scegli in base alla tua familiarità.

Requisiti PHP

Magento 2.4.7 e 2.4.8 richiedono PHP 8.1 o 8.2. Le versioni precedenti non funzioneranno. Avrai anche bisogno di estensioni PHP specifiche installate:

• ext-bcmath
• ext-ctype
• arricciatura est
• ext-dom
• est-gd
• est-intl
• ext-mbstring
• ext-openssl
• ext-pdo_mysql
• ext-sapone
• ext-xsl
• ext-zip
• ext-socket

Anche la configurazione di PHP è importante. Impostato memory_limit ad almeno 2 GB. Aumento max_execution_time per 18000 per l'installazione. Abilita OPcache (un potenziatore delle prestazioni di PHP) per un'esecuzione più rapida.

Banca dati

Magento 2.4.7 e successivamente richiedono MySQL 8.0 o MariaDB 10.4 (o più alto). Le versioni precedenti di MySQL non funzioneranno. Il database necessita del supporto del motore di archiviazione InnoDB e della corretta codifica UTF-8.

Motore di ricerca (Necessario)

Ecco cosa fa inciampare molte persone: Magento 2.4+ richiede un motore di ricerca. MySQL non gestisce più le ricerche nel catalogo. È necessario installare uno dei due:

• Ricerca elastica 7.17 o 8.x
• OpenSearch 1.2 o 2.x (un fork di Elasticsearch, pienamente compatibile)

OpenSearch è consigliato per le nuove installazioni. È open source e riceve aggiornamenti regolari. Tratteremo la sua installazione più tardi.

Requisiti aggiuntivi

• Compositore 2.2+ – Gestore delle dipendenze PHP (necessari per l'installazione)
• RAM – Minimo 2GB, 4Consigliato GB
• Conservazione – Almeno 10GB SSD (Preferibile NVMe)
• Certificato SSL – Obbligatorio per HTTPS (autofirmato non funzionerà)
• TLS 1.2 – Richiesto per l'accesso al repository PayPal e Magento

Hosting consigliato

Hosting condiviso non funzionerà per Magento. Hai bisogno di un VPS o server dedicato con accesso root completo. Aspettatevi di spendere almeno $ 20-50 al mese per risorse adeguate. Per negozi ad alto traffico, server dedicati o hosting cloud fornire una migliore scalabilità.

Preinstallazione: Preparazione del server

Prima di installare Magento, il tuo server necessita di una configurazione adeguata. Questi passaggi presuppongono Ubuntu 22.04, ma i comandi sono simili per altre distribuzioni.

Passo 1: Aggiorna il tuo sistema

Inizia con un nuovo aggiornamento del sistema:

sudo apt update && sudo apt upgrade -y

Passo 2: Installa PHP e le estensioni richieste

Aggiungi il repository PHP e installa PHP 8.2 con tutte le estensioni richieste:

sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install php8.2 php8.2-fpm php8.2-mysql php8.2-xml php8.2-curl php8.2-gd php8.2-intl php8.2-mbstring php8.2-soap php8.2-xsl php8.2-zip php8.2-bcmath php8.2-sockets -y

Passo 3: Configura le impostazioni PHP

Modifica il tuo file di configurazione PHP:

sudo nano /etc/php/8.2/fpm/php.ini

Trova e modifica questi valori:

memory_limit = 2G
max_execution_time = 18000
zlib.output_compression = On

Riavviare PHP-FPM (Gestore processi PHP FastCGI) per applicare le modifiche:

sudo systemctl restart php8.2-fpm

Passo 4: Installa MySQL 8.0

sudo apt install mysql-server -y
sudo mysql_secure_installation

Crea un database e un utente per Magento:

sudo mysql -u root -p

CREATE DATABASE magento2;
CREATE USER 'magento_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON magento2.* TO 'magento_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Passo 5: Installa Nginx

sudo apt install nginx -y
sudo systemctl enable nginx

Passo 6: Installa Composer

Composer gestisce le dipendenze di Magento. Installalo a livello globale:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version

Verifica compositore 2.2+ è installato. Le versioni precedenti causano problemi di dipendenza.

Passo 7: Installa OpenSearch

OpenSearch richiede Java. Installa prima OpenJDK:

sudo apt install openjdk-11-jdk -y

Aggiungi il repository OpenSearch e installa:

curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | sudo apt-key add -
echo "deb https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-2.x.list
sudo apt update
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=YourSecurePassword123! apt install opensearch -y

Configura OpenSearch modificandolo /etc/opensearch/opensearch.yml:

cluster.name: magento2
network.host: localhost
http.port: 9200
discovery.type: single-node
plugins.security.disabled: true

Avvia e abilita il servizio:

sudo systemctl enable opensearch
sudo systemctl start opensearch

Verifica che sia in esecuzione:

curl -X GET "localhost:9200"

Dovresti vedere una risposta JSON con le informazioni sul cluster.

Installazione di Magento tramite Composer

Il metodo Composer è l'unico approccio di installazione consigliato. Gestisce correttamente le dipendenze e rende gli aggiornamenti semplici. Evita download di archivi o cloni Git per i siti di produzione.

Passo 1: Ottieni le chiavi di autenticazione Magento

Hai bisogno delle chiavi di autenticazione per scaricare Magento. Crea un account gratuito su marketplace.magento.com, poi:

1. Go to My Profile > Access Keys
2. Clic “Crea una nuova chiave di accesso”
3. Nominalo (per esempio, “Installazione del server”)
4. Copia la chiave pubblica (nome utente) e chiave privata (parola d'ordine)

Memorizza queste chiavi nel file di autenticazione globale di Composer:

composer global config http-basic.repo.magento.com <public_key> <private_key>

Passo 2: Creare la directory web

Crea e vai alla tua radice web:

sudo mkdir -p /var/www/magento2
cd /var/www/magento2

Passo 3: ScaricaMagento

Esegui il comando create-project di Composer. Per Magento Open Source:

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition .

Per Adobe Commercio (versione a pagamento):

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition .

Vengono scaricati oltre 300 MB di file. Essere pazientare.

Passo 4: Imposta autorizzazioni file

Le autorizzazioni adeguate impediscono “Accesso negato” errori e problemi di sicurezza:

sudo find var generated vendor pub/static pub/media app/etc -type f -exec chmod 644 {} \;
sudo find var generated vendor pub/static pub/media app/etc -type d -exec chmod 755 {} \;
sudo chown -R www-data:www-data /var/www/magento2
sudo chmod u+x bin/magento

Passo 5: Esegui il comando di installazione

Ora esegui l'installazione vera e propria. Personalizza questi parametri per la tua configurazione:

bin/magento setup:install \
  --base-url="https://yourdomain.com/" \
  --db-host="localhost" \
  --db-name="magento2" \
  --db-user="magento_user" \
  --db-password="your_strong_password" \
  --admin-firstname="Admin" \
  --admin-lastname="User" \
  --admin-email="[email protected]" \
  --admin-user="admin" \
  --admin-password="Admin123!" \
  --language="en_US" \
  --currency="USD" \
  --timezone="America/New_York" \
  --use-rewrites=1 \
  --search-engine="opensearch" \
  --opensearch-host="localhost" \
  --opensearch-port="9200"

L'installazione richiede 5-15 minuti a seconda della velocità del server. Fai attenzione a eventuali errori.

Al termine, vedrai un messaggio con l'URL dell'amministratore. È randomizzato per sicurezza (per esempio, /admin_abc123). Scrivilo.

Passo 6: Esegui i comandi post-installazione

Completa la configurazione con questi comandi essenziali:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Il static-content:deploy il comando genera file CSS e JavaScript. Il -f flag impone la distribuzione in modalità sviluppatore.

Configurazione di Nginx per Magento

Magento necessita di una configurazione Nginx specifica. Crea un nuovo blocco server:

sudo nano /etc/nginx/sites-available/magento2

Aggiungi questa configurazione (modificare dominio e percorsi):

upstream fastcgi_backend {
    server unix:/var/run/php/php8.2-fpm.sock;
}

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    set $MAGE_ROOT /var/www/magento2;
    set $MAGE_MODE production;

    include /var/www/magento2/nginx.conf.sample;
}

Abilita il sito e testa la configurazione:

sudo ln -s /etc/nginx/sites-available/magento2 /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Magento fornisce un esempio di configurazione Nginx su nginx.conf.sample. La direttiva include sopra la usa direttamente.

Configurazione dei lavori Cron

Magento fa molto affidamento sui lavori cron (attività pianificate) per l'indicizzazione, messaggi di posta elettronica, Sitemap, e altro ancora. Senza cron, il tuo negozio non funzionerà correttamente.

Esegui questo comando per generare le voci crontab:

bin/magento cron:install

Ciò aggiunge tre lavori cron. Verificare che esistano:

crontab -l

Dovresti vedere le voci eseguite ogni minuto per le attività pianificate di Magento.

Ottimizzazione delle prestazioni: Redis e Vernice

Un negozio Magento di produzione necessita di memorizzazione nella cache per prestazioni accettabili. Redis gestisce le sessioni e la cache backend. Vernice (un acceleratore HTTP) gestisce la memorizzazione nella cache dell'intera pagina.

Installazione di Redis

sudo apt install redis-server -y
sudo systemctl enable redis-server

Verificare che Redis funzioni:

redis-cli ping

Dovrebbe rispondere con “PONG”.

Configura Magento per utilizzare Redis per la memorizzazione nella cache:

bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0
bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1
bin/magento setup:config:set --session-save=redis --session-save-redis-host=127.0.0.1 --session-save-redis-db=2

Utilizzo di database separati (0, 1, 2) mantiene isolati i diversi tipi di cache.

Installazione di vernice

Varnish si trova davanti al tuo server web e memorizza nella cache le pagine:

sudo apt install varnish -y

Magento genera il file di configurazione di Varnish:

bin/magento varnish:vcl:generate --backend-host=localhost --backend-port=8080 --output-file=/etc/varnish/default.vcl

Dovrai regolare Nginx per ascoltare sulla porta 8080 internamente mentre Varnish gestisce il porto 80. Questa configurazione richiede una configurazione aggiuntiva che va oltre lo scopo di questa guida, ma la documentazione di Magento lo copre approfonditamente.

Configurazione della sicurezza

La protezione di Magento richiede più passaggi. Non saltarli.

Sicurezza del pannello di amministrazione

Log into the Magento admin panel and navigate to Stores > Configuration > Advanced > Admin.

Sotto Sicurezza, configurare queste impostazioni:

• Condivisione dell'account amministratore: Imposta su “No” (impedisce a più persone di utilizzare un unico login)
• Password a vita: Imposta su 90 giorni
• Numero massimo di errori di accesso: Imposta su 5
• Orario di blocco: Imposta su 30 minuti

Autenticazione a due fattori

Magento 2.4+ consente l'autenticazione a due fattori (2fa) per impostazione predefinita. Ciò aggiunge un secondo passaggio di verifica oltre alle password. Non puoi disabilitarlo, quindi configuralo correttamente:

1. Go to Stores > Configuration > Security > 2FA
2. Abilita Google Autenticatore (o un altro provider supportato)
3. Al primo accesso, scansiona il codice QR con la tua app di autenticazione

Autorizzazioni sui file

Dopo l'installazione, restringere le autorizzazioni:

sudo find /var/www/magento2 -type d -exec chmod 755 {} \;
sudo find /var/www/magento2 -type f -exec chmod 644 {} \;
sudo chmod -R 770 /var/www/magento2/var
sudo chmod -R 770 /var/www/magento2/pub/static
sudo chmod -R 770 /var/www/magento2/pub/media
sudo chmod -R 770 /var/www/magento2/generated

URL di amministrazione

Magento genera un URL di amministrazione casuale durante l'installazione. Mantienilo così. Non cambiarlo in qualcosa di prevedibile come /admin. Se hai bisogno, trovalo più tardi:

bin/magento info:adminuri

Configurazione SSL/HTTPS

Utilizza sempre HTTPS in produzione. Dopo aver installato un certificato SSL (Crittografiamo è gratuito), configurare Magento:

bin/magento setup:store-config:set --base-url="https://yourdomain.com/"
bin/magento setup:store-config:set --base-url-secure="https://yourdomain.com/"
bin/magento setup:store-config:set --use-secure=1
bin/magento setup:store-config:set --use-secure-admin=1
bin/magento cache:flush

Risoluzione dei problemi comuni di installazione

Anche con un'attenta configurazione, i problemi accadono. Ecco i problemi e le soluzioni più comuni.

Installazione bloccata a 70%

Questo di solito significa PHP max_execution_time è troppo basso. Modifica php.ini e impostalo su 18000, quindi riavviare PHP-FPM. In alternativa, eseguire l'installazione tramite riga di comando anziché tramite il programma di installazione web.

“La classe non esiste” Errori

Questi errori ReflectionException indicano file generati danneggiati. Cancellateli:

rm -rf var/cache var/page_cache var/generation generated/code
bin/magento setup:di:compile
bin/magento cache:flush

Errori di autorizzazione negata

Le autorizzazioni dei file causano circa 38% di errori di installazione. Garantire l'utente del server web (www-dati su Ubuntu) possiede tutti i file:

sudo chown -R www-data:www-data /var/www/magento2

Estensione PHP mancante

Messaggi di errore come “Manca l'estensione PHP richiesta ext-mbstring” significa che devi installare quell'estensione:

sudo apt install php8.2-mbstring -y
sudo systemctl restart php8.2-fpm

Connessione Elasticsearch/OpenSearch non riuscita

Se Magento non riesce a connettersi al tuo motore di ricerca:

1. Controlla se il servizio è in esecuzione: sudo systemctl status opensearch
2. Testare la connettività: curl localhost:9200
3. Controlla che le regole del firewall non blocchino la porta 9200
4. Verifica che il nome host e la porta nel comando di installazione corrispondano alla tua configurazione

Memoria esaurita

Errori di memoria PHP durante la compilazione indicano che è necessaria più RAM o spazio di swap:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Pagine vuote o 500 Errori

Abilita la modalità sviluppatore per visualizzare gli errori effettivi:

bin/magento deploy:mode:set developer

Controllare i file di registro su var/log/exception.log e var/log/system.log per i dettagli.

Elenco di controllo post-installazione

Dopo l'installazione riuscita, completare questi passaggi:

• Accedi al pannello di amministrazione e configura le impostazioni del negozio (nome, fuso orario, moneta)
• Imposta i metodi di spedizione
• Configura gateway di pagamento
• Crea gruppi di clienti e regole fiscali
• Configura modelli di posta elettronica e SMTP
• Configura robots.txt e mappe dei siti
• Installa le estensioni essenziali tramite Composer
• Configura backup automatici
• Passa alla modalità di produzione: bin/magento deploy:mode:set production

Domande frequenti

Posso installare Magento su hosting condiviso?

Tecnicamente sì, ma non è raccomandato. Magento richiede configurazioni PHP specifiche, Accesso SSH, e compositore. La maggior parte degli host condivisi non li fornisce. Raggiungerai rapidamente anche i limiti di memoria. Hosting VPS è l'opzione pratica minima.

Quanto tempo richiede l'installazione di Magento?

La preparazione del server richiede 30-60 minuti se hai familiarità con Linux. L'effettiva installazione di Magento richiede 10-20 minuti. Gli utenti alle prime armi dovrebbero budget 2-4 ore per l'intero processo, inclusa la risoluzione dei problemi.

Ho bisogno di Elasticsearch o OpenSearch?

sì, uno di questi è obbligatorio per Magento 2.4+. MySQL non gestisce più le ricerche nel catalogo. OpenSearch è la scelta consigliata per le nuove installazioni poiché è completamente open source e gestito attivamente.

Qual è la differenza tra Magento Open Source e Adobe Commerce?

Magento Open Source è gratuito e supportato dalla comunità. Adobe Commerce (precedentemente Magento Commerce) è la versione a pagamento con funzionalità aggiuntive come la funzionalità B2B, strumenti di marketing avanzati, e opzioni di hosting nel cloud. Adobe Commerce parte da $ 22.000 all'anno. Entrambi condividono lo stesso processo di installazione.

Posso migrare da WooCommerce a Magento?

sì, ma richiede un'attenta pianificazione. Dovrai esportare prodotti, i clienti, e ordini da WooCommerce e importarli in Magento. Esistono diverse estensioni di migrazione, sebbene i negozi complessi possano richiedere uno sviluppo personalizzato. Prendi in considerazione l'assunzione di uno specialista Magento per cataloghi di grandi dimensioni.

Come aggiorno Magento dopo l'installazione?

Utilizza Composer per aggiornare: composer update magento/product-community-edition --with-all-dependencies. Eseguire sempre prima il backup del database e dei file. Testare gli aggiornamenti in un ambiente di staging prima della produzione. Correre bin/magento setup:upgrade dopo l'aggiornamento.

Perché il mio negozio Magento è lento?

Magento senza cache è lento in base alla progettazione. Genera pagine in modo dinamico. Abilita Redis per la memorizzazione nella cache del backend e Varnish per la memorizzazione nella cache dell'intera pagina. Abilita la modalità produzione, che precompila il codice. Usare un CDN per gli asset statici. Considera l'idea di aggiornare il tuo risorse del server se il traffico è elevato.