Guida tecnica all’installazione di Mage-OS

Mage-OS è un’alternativa open source a Magento Open Source, 100% compatibile, ma con un approccio più moderno e comunitario. Basato sullo stesso core di Magento, Mage-OS si propone come punto di riferimento per garantire continuità e innovazione nel panorama E-Commerce.
In questa guida, vedremo come installare Mage-OS in locale o su server, con tutti i dettagli tecnici necessari.

Requisiti tecnici per installare Mage-OS

1. Server (locale o remoto)

• Sistema operativo: Linux (Ubuntu 20.04+ consigliato) o macOS. Windows funziona con WSL2.
  
• RAM minima consigliata: 8 GB
  
• Storage: SSD consigliato
  

2. Software

• PHP: 8.1 o 8.2 (PHP 8.3 è sperimentale)
  
  • Estensioni richieste:
    
    • ext-bcmath
      
    • ext-ctype
      
    • ext-curl
      
    • ext-dom
      
    • ext-gd
      
    • ext-intl
      
    • ext-mbstring
      
    • ext-openssl
      
    • ext-pdo_mysql
      
    • ext-simplexml
      
    • ext-soap
      
    • ext-xsl
      
    • ext-zip
      
    • ext-sockets (per RabbitMQ)
      
• Composer: 2.5+
  
• MySQL: 8.0 (oppure MariaDB 10.4–10.6)
  
• Elasticsearch: 7.17+ oppure OpenSearch 1.3+
  
• Node.js: v18+ (per asset frontend)
  
• Yarn: v1+ (consigliato)
  

Installazione di Mage-OS

1. Preparazione della directory (comandi da effettuare in bash)

mkdir mageos && cd mageos

2. Inizializzazione via Composer  (comandi da effettuare in bash)

Mage-OS fornisce un metapackage chiamato mageos/project-community-edition:

composer create-project mageos/project-community-edition . --repository=https://repo.mage-os.org

I comandi sopra descritti servono a

• Inizializza una nuova installazione Mage-OS
  
• Usa il repository Mage-OS al posto di repo.magento.com
  
• Scarica l’intero core in vendor/
  

Se hai già Composer 2.6+, puoi usare la modalità interattiva:

composer init
composer config minimum-stability stable
composer config prefer-stable true
composer config repositories.mageos composer https://repo.mage-os.org
composer require mageos/project-community-edition

3. Configurazione del webserver (consigliato Nginx)

Per ambienti locali o di staging, una configurazione base Nginx potrebbe essere (se si dovessero utilizzare sistemi locali come DDEV la configurazione viene autogenerata) :

server {
    listen 80;
    server_name mageos.local;
    root /var/www/mageos/pub;

    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~* \.(jpg|jpeg|png|gif|ico|css|js|woff|woff2|svg|ttf)$ {
        expires max;
        log_not_found off;
    }
}

Nel caso di ambienti locali e a seconda del sistema utilizzato non bisogna dimenticare di aggiornare il file /etc/hosts con (per esempio):

127.0.0.1 mageos.local

4. Setup del database

Crea un database vuoto chiamato ad esempio mageos:

(dopo essere entrato in shell mysql)

CREATE DATABASE mageos CHARACTER SET utf8mb4 COLLATE 
utf8mb4_general_ci;

5. Installazione via CLI

Una volta configurati database e webserver è possibile avviare il setup di mageos

bin/magento setup:install \
  --base-url="http://mageos.local" \
  --db-host="127.0.0.1" \
  --db-name="mageos" \
  --db-user="root" \
  --db-password="password" \
  --admin-firstname="Admin" \
  --admin-lastname="User" \
  --admin-email="admin@example.com" \
  --admin-user="admin" \
  --admin-password="Admin123!" \
  --language="it_IT" \
  --currency="EUR" \
  --timezone="Europe/Rome" \
  --use-rewrites=1

Dopo l’installazione

1. Compilazione e deploy statici

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f it_IT en_US

2. Pulizia cache

bin/magento cache:flush

3. Attiva la modalità developer (utilizzato sullo staging o in ambienti locali)

bin/magento deploy:mode:set developer

Consigli per ambienti di sviluppo e debug

• Usa Docker o DDEV per ambienti replicabili.
  
• Installa Xdebug per debugging.
  
  

Ambienti di produzione

Per la produzione si raccomanda:

• Modalità production
  
• CDN attivo
  
• Cache Varnish
  
• Redis per sessioni e cache
  
• Backup automatici
  
• Monitoraggio log via Sentry / New Relic
  
• Deployment via CI/CD (GitHub Actions, GitLab CI, ecc.)
  

Differenze con Magento Open Source

Link utili

• Mage-OS Official Site
  
• Mage-OS Repository
  
• Hyvä compatibility
  
• DDEV Setup for Mage-OS
  

Conclusione

Mage-OS è la scelta ideale per chi cerca continuità e innovazione senza dipendere da Adobe. L’installazione è simile a quella di Magento, ma con un approccio più snello, moderno e orientato alla community. Che tu stia sviluppando in locale o mettendo in piedi un progetto in produzione, questa guida ti fornisce le basi per iniziare al meglio.