Ricerca nel sito web

Come installare Neos CMS su Debian 11


Su questa pagina

  1. Prerequisiti
  2. Installazione del server Web Apache2
  3. Installazione del server database MariaDB
  4. Impostazione del database e dell'utente MariaDB
  5. Installazione dei pacchetti PHP 8.1
  6. Installazione di Composer
  7. Installazione di Neos Base Distribution
  8. Impostazione dell'host virtuale Apache2
  9. Configurazione dell'installazione di Neos CMS
  10. Conclusione

Neos è un sistema di gestione dei contenuti gratuito e open source con editing intuitivo, completa internazionalizzazione, massima flessibilità e facilità di integrazione con sistemi di terze parti.

Neos è una gestione dei contenuti aziendali integrata con modellazione dei contenuti personalizzata che fornisce un modo efficace per modificare e gestire i contenuti, ottimizzazione SEO come reindirizzamenti automatici e metadati SEO e ruoli potenti e gestione degli utenti.

In questo tutorial, esploreremo come installare l'ultima versione di Neos CMS su un server Debian 11. Per questo esempio, configureremo Neos CMS con il server database MariaDB, PHP 8.1 e il server web Apache2.

Prerequisiti

Per seguire questo tutorial, avrai bisogno di un server Debian 11 con l'utente non root e i privilegi sudo/amministratore e il firewall UFW abilitato. Inoltre, avrai bisogno di un nome di dominio che punti all'indirizzo IP del tuo server Debian, specialmente se stai installando Neos CMS per la produzione.

Installazione del server Web Apache2

Il Neos CMS può essere eseguito su più server Web e per questa demo utilizzerai il server Web Apache2.

Prima di iniziare l'installazione dei pacchetti, esegui il seguente comando apt per aggiornare e rinfrescare i tuoi repository Debian.

sudo apt update

Quindi, installa il server Web Apache2 con il comando apt di seguito. Ti verrà chiesto di confermare l'installazione. Premere ye ENTER per procedere con l'installazione.

sudo apt install apache2

Una volta completata l'installazione di Apache2, controlla e verifica il servizio apache2 tramite il comando systemcl di seguito.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Vedrai che l'output di apache2 è abilitato e verrà eseguito automaticamente all'avvio. E lo stato del servizio apache2 è in esecuzione.

Infine, apri le porte HTTP e HTTPS sul server Debian e consenti il traffico in esso tramite il comando ufw di seguito. Il profilo dell'applicazione ufw \WWW Full\ consentirà l'accesso a entrambe le porte HTTP e HTTPS.

sudo ufw allow "WWW Full"
sudo ufw status

Vedrai l'output dello stato corrente del firewall UFW è attivo e l'elenco delle porte e dei profili delle applicazioni abilitati.

Installazione del server database MariaDB

Il Neos CMS supporta due database, MariaDB e PostgreSQL. In questo esempio, eseguirai Neos CMS con il server database MariaDB. Al momento della stesura di questo articolo, l'attuale Neos CMS richiedeva almeno MariaDB 10.2.2.

Esegui il seguente comando apt per installare MariaDB sul tuo server Debian. La versione predefinita di MariaDB sul repository Debian è MariaDB 10.5, che è compatibile con l'installazione di Neos CMS.

sudo apt install mariadb-server

Quando viene richiesto di confermare il processo, immettere y e INVIO per procedere con l'installazione.

Una volta installato MariaDB, controlla il servizio MariaDB e verifica che il servizio sia in esecuzione tramite il comando systemctl come di seguito.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Vedrai che l'output del servizio MariaDB è abilitato, il che significa che verrà eseguito automaticamente all'avvio del sistema. E lo stato corrente del servizio MariaDB è in esecuzione.

Infine, dovrai proteggere l'installazione del tuo server MariaDB. Per fare ciò, puoi utilizzare lo script mysql_secure_installation incluso per impostazione predefinita nel pacchetto MariaDB.

Esegui il seguente comando mysql_secure_installation.

sudo mysql_secure_installation

Sarai guidato passo dopo passo per proteggere l'installazione del tuo server MariaDB. Questo processo include la configurazione della password root di MariaDB. Quindi, assicurati di utilizzare una password sicura per l'installazione del tuo server MariaDB.

Nei prompt successivi, ti verrà chiesto informazioni sulla configurazione come la rimozione dell'utente anonimo predefinito, il divieto di accesso remoto per l'utente root, la rimozione del test del database predefinito e il ricaricamento dei privilegi delle tabelle. Immettere Y per tutti questi prompt e premere INVIO per procedere.

Impostazione del database e dell'utente MariaDB

Dopo aver installato e protetto il server MariaDB, creerai un nuovo database MariaDB e un nuovo utente per l'installazione di Neos CMS. Per farlo, devi accedere alla shell MariaDB.

Esegui il comando mysql di seguito per accedere alla shell MariaDB tramite l'utente root predefinito. Quando viene richiesta la password, inserisci la tua password di root MariaDB.

sudo mysql -u root -p

Ora esegui le seguenti query per creare un nuovo database e un nuovo utente per Neos CMS. Nelle seguenti query, creerai il database neosdb, l'utente MariaDB [email protetto].

Assicurati di sostituire la password per l'utente [email protetta] con una password di archiviazione.

CREATE DATABASE neosdb;
CREATE USER IDENTIFIED BY 'Password';
FLUSH PRIVILEGES;

Dopodiché, esegui la seguente query per verificare i privilegi per l'utente [email protetto].

SHOW GRANTS FOR ;

Se il tuo database e il tuo utente sono configurati correttamente, vedrai che l'output dell'utente [e-mail protetto] ha il privilegio per il database neosdb.

Infine, inserisci la seguente query per disconnetterti dalla shell MariaDB.

quit

Installazione dei pacchetti PHP 8.1

Ora installerai i pacchetti PHP sul tuo server Debian. L'ultima versione di Neos CMS richiedeva almeno PHP 7.3 e, per questo esempio, installerai PHP 8.1 da un repository di terze parti.

Nella tabella seguente, puoi vedere l'ultima versione di Neos CMS v8 che richiede PHP 8.0 o 8.1.

Neos version    Flow version    compatible PHP version
-------------------------------------------------------
4.3             5.3             7.1 - 7.4*
5.x             6.x             7.2 - 7.4
7.x             7.x             7.3 - 7.4 / 8.0 - 8.1
8.x             8.x             8.0 - 8.1

Prima di installare PHP, eseguire il seguente comando apt per installare alcuni pacchetti di base per la gestione di repository di terze parti. Immettere Y quando viene richiesto di confermare l'installazione e premere INVIO per procedere.

sudo apt install ca-certificates apt-transport-https software-properties-common wget curl lsb-release

Ora esegui il seguente comando per aggiungere il repository di PHP 8.x al tuo server Debian. Questo repository fornisce più versioni di pacchetti PHP per i sistemi Debian.

curl -sSL https://packages.sury.org/php/README.txt | sudo bash -x

Durante il processo, vedrai un output simile al seguente:

Successivamente, installa i pacchetti PHP 8.1 utilizzando il seguente comando apt. Questi comandi installeranno alcune estensioni PHP e pacchetti aggiuntivi come ImageMagick per il processo di immagine che verrà utilizzato da Neos CMS.

sudo apt install php8.1 php8.1-cli php8.1-common php8.1-imap php8.1-redis php8.1-snmp php8.1-xml php8.1-zip php8.1-imagick php8.1-mbstring php8.1-curl libapache2-mod-php php8.1-mysql imagemagick

Immettere Y quando viene richiesto di confermare l'installazione e premere INVIO per procedere.

Al termine dell'installazione di PHP, apri il file /etc/php/8.1/apache2/php.ini utilizzando nano editor.

sudo nano /etc/php/8.1/apache2/php.ini

Modificare la configurazione predefinita come di seguito.

date.timezone = Europe/Stockholm

Salva il file ed esci dall'editor quando hai finito.

Infine, esegui quanto segue per riavviare il servizio Apache2 e applicare le nuove modifiche alle configurazioni PHP.

sudo systemctl restart apache2

Installazione del compositore

Composer è lo strumento di gestione dei pacchetti per i pacchetti PHP. Installerai Composer sul tuo server Debian che verrà utilizzato per installare le dipendenze PHP per Neos CMS.

Eseguire il seguente comando per installare Composer sul sistema Debian. Questo comando scaricherà lo script del programma di installazione di Composer, quindi lo eseguirà. La directory di installazione di destinazione per Composer è /usr/bin con il nome file composer.

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer

Ora, verifica l'installazione di Composer usando il seguente comando.

sudo -u www-data composer -v

Vedrai l'output della versione di Composer installata sul tuo sistema Debian.

Installazione della distribuzione di base Neos

A questo punto, hai terminato l'installazione delle dipendenze dei pacchetti per Neos CMS, che include il server Web Apache2, il server database MariaDB, PHP 8.1 e PHP Composer.

Ora scaricherai il codice sorgente di Neos CMS e installerai le dipendenze del pacchetto PHP tramite il comando Composer.

Esegui il seguente comando git per scaricare il codice sorgente di Neos CMS nella directory /var/www/neos.

git clone https://github.com/neos/neos-base-distribution.git /var/www/neos

Successivamente, spostati nella directory /var/www/neos ed esegui il comando composer per installare le dipendenze PHP per Neos CMS.

cd /var/www/neos
composer install

Una volta completata l'installazione delle dipendenze PHP, eseguire il seguente comando per modificare la proprietà e l'autorizzazione della directory /var/www/neos all'utente www-data.

sudo ./flow core:setfilepermissions www-data www-data

Con il codice sorgente di Neos CMS e le dipendenze PHP installate, sei pronto per passare alla creazione di una configurazione di host virtuale Apache2 per la tua installazione.

Configurazione dell'host virtuale Apache2

Se stai eseguendo Neos CMS nell'ambiente di produzione, assicurati che il tuo nome di dominio punti all'indirizzo IP del tuo server Debian. Inoltre, assicurati di aver generato i certificati SSL per l'installazione del tuo dominio.

Prima di creare la configurazione dell'host virtuale Apache, eseguire il seguente comando per abilitare i moduli Apache2 mod_ssl e mod_rewrite.

sudo a2enmod ssl rewrite

Ora, crea un nuovo file di configurazione dell'host virtuale /etc/apache2/sites-available/neos.conf utilizzando il seguente editor nano.

sudo nano /etc/apache2/sites-available/neos.conf

Cambia il nome del dominio con il tuo dominio e cambia il percorso del certificato SSL con il tuo percorso. Quindi, incolla la configurazione nel file.

<VirtualHost *:80>

    ServerName hwdomain.io
    ServerAdmin

        #SetEnv FLOW_CONTEXT Production
        DocumentRoot /var/www/neos/Web

        # Add security
        php_flag register_globals off

        ErrorLog ${APACHE_LOG_DIR}/hwdomain.io.error.log
        CustomLog ${APACHE_LOG_DIR}/hwdomain.io.access.log combined

        SSLEngine on
        SSLCertificateFile /etc/letsencrypt/live/hwdomain.io/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/hwdomain.io/privkey.pem

        <Directory /var/www/neos/Web>
                AllowOverride All
        </Directory>

        <Directory /var/www/neos/Web/>
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]
        </Directory>

    </VirtualHost>

</IfModule>

Salva il file ed esci dall'editor quando hai finito.

Successivamente, attiva la configurazione dell'host virtuale neos.conf utilizzando il seguente comando. Quindi, verifica i file di configurazione di Apache2.

sudo a2ensite neos.conf
sudo apachectl configtest

Se hai i file di configurazione Apche2 corretti, vedrai un output come \Syntax OK\.

Infine, riavvia il servizio apache2 per applicare le nuove modifiche tramite il comando systemctl come di seguito.

sudo systemctl restart apache2

Configurazione dell'installazione di Neos CMS

Per avviare la configurazione dell'installazione di Neos CMS, apri il tuo browser web e visita il nome di dominio della tua installazione di Neos CMS (es: https://hwdomain.io/).

Innanzitutto, vedrai il messaggio di benvenuto di Neos. Fai clic su \Vai alla configurazione\ per avviare la configurazione di Neos CMS.

Inizierà l'inizializzazione di Neos CMS.

Per avviare la configurazione di Neos CMS, ti verrà chiesta la password di configurazione.

Torna al tuo terminal server ed esegui il seguente comando per mostrare la password di configurazione per Neos CMS.

cat /var/www/neos/Data/SetupPassword.txt

Copia la password di configurazione generata e incollala nella pagina di configurazione di Neos. Quindi, fai clic su \Accedi\.

Ora ti verrà mostrata la pagina della verifica dei requisiti di Neos. Assicurati che sia installata una delle manipolazioni di immagini. Quindi fare clic su \Avanti\.

In questo esempio, stiamo usando la manipolazione delle immagini ImageMagick e sono installati i pacchetti php-imagick e ImageMagick.

Per le configurazioni del database, inserire il nome utente, la password e l'host del database. Quindi, scegli il database per l'installazione di Neos CMS. Successivamente, fare clic su \Avanti\ per procedere alla configurazione successiva.

Ora fai clic su dettagli nuovo utente amministratore e password, nome e cognome. Quindi fare clic su \Avanti\.

Per la nuova configurazione del sito Neos, seleziona \Neos.Demo\ nel pacchetto del sito e inserisci il nome di dominio della tua installazione Neos CMS nella configurazione del nome del sito.

Fare clic su \Avanti\ per procedere con l'installazione.

Al termine dell'installazione e della configurazione di Neos CMS, verrà visualizzata la pagina seguente.

Fai clic sul pulsante \Vai al front-end\ per ottenere la home page predefinita dell'installazione di Neos CMS. Oppure puoi fare clic su \Vai al backend\ per accedere alla dashboard di amministrazione di Neos CMS.

Di seguito è riportata la home page predefinita dell'installazione di Neos CMS con il pacchetto del sito \Neos.Demo\.

Quando fai clic sul pulsante \Vai al backend\, verrai reindirizzato alla pagina di accesso di Neos CMS. Inserisci il tuo nome utente e password per l'installazione di Neos CMS e fai clic su \Accedi\.

se il nome utente e la password del tuo neos CMS sono corretti, vedrai la dashboard di amministrazione del tuo Neos CMS.

Conclusione

In questa guida, hai installato Neos CMS con il web server Apache2, il database server MariaDB e PHP 8.1 sul server Debian 11. Inoltre, hai appreso l'installazione di PHP Composer per l'installazione delle dipendenze dei pacchetti PHP. Hai anche creato la configurazione dell'host virtuale Apache per Neos CMS con SSL sicuro abilitato.

Neos CMS è la nuova generazione di CMS ed è flessibile per diversi tipi di utilizzo. Ora puoi iniziare a gestire i tuoi contenuti e pubblicare il tuo sito utilizzando Neos CMS in pochissimo tempo.