# Installazione

Aprire il programma *Putty* e collegarsi all’host remoto dove si dovrà installare vtenext tramite connessione SSH.

Si consiglia di aggiornare i pacchetti linux

```bash
sudo apt update && sudo apt upgrade -y
```

Riavviare il server in caso di aggiornamenti del kernel così da rendere attivo l'ultimo kernel.

Dopo aver aggiornato il sistema è necessario installare i pacchetti, se non presenti, che permetteranno il funzionamento di vtenext.

##### Installare Apache

```bash
sudo apt install apache2
```

Una volta installato, attivare i moduli rewrite ed headers

```bash
a2enmod rewrite headers
```

Modificare il virtualhost che sarà utilizzato per vtenext in modo da consentire i rewrite necessari per il funzionamento delle RESTAPI aggiungendo la seguente parte

```ini
<Directory /var/www/html/VTE_FOLDER>
Options -Indexes +FollowSymLinks +MultiViews
AllowOverride All
Require all granted
</Directory>
```

##### Installare PHP

Vedi [scheda requisiti](https://usermanual.vtenext.com/books/requisiti-di-installazione) per maggiori dettagli sui moduli richiesti

```bash
sudo apt install php php-cli php-bcmath php-gd php-imap php-ldap php-mysql php-curl php-imagick php-mbstring php-xml php-apcu php-zip libapache2-mod-php
```

Modificare il file php.ini in modo da configurare i parametri come richiesto da vtenext

```bash
sudo nano /etc/php/8.3/apache2/php.ini
```

```ini
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE
display_errors = Off
memory_limit = 256M
log_errors = On
file_uploads = On
output_buffering = On
```

**Salvare il file ed applicare la stessa modifica al file** */etc/php/8.3/cli/php.ini*

Riavviare il servizio apache per rendere le configurazioni attive

```bash
sudo systemctl restart apache2
```

##### Installare MySQL

```bash
sudo apt install mysql-server mysql-client
```

Per il corretto funzionamento del tool [Importazione Dati](https://usermanual.vtenext.com/books/manuale-vtenext-2604/page/1716-importazione-dati) di vtenext, è necessario che il servizio MySQL lavori con sql\_mode non strict e che il comando "local infile" sia concesso.  
Per farlo è possibile creare un file di configurazione in /etc/mysql/conf.d chiamato ad esempio vtenext.cnf con il seguente contenuto

```ini
[mysqld]
sql_mode = ''
local-infile

[mysql]
local-infile
```

Riavviare poi il servizio MySQL

```bash
sudo systemctl restart mysql
```

Creare un utente dedicato ed il nuovo database che sarà utilizzato poi nel wizard di installazione che segue nella sezione "Deploy VTENEXT"

Accedere con un utente mysql privilegiato e creare l'utenza chiamata ad esempio "vtenext"

```sql
CREATE USER 'vtenext'@'localhost' IDENTIFIED BY 'PasswordComplessa';
```

Creare il database ed assegnare i GRANT all'utente appena creato

```sql
CREATE DATABASE vtenext CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL PRIVILEGES ON vtenext.* TO 'vtenext'@'localhost';
FLUSH PRIVILEGES;
```

##### Deploy VTENEXT

Decomprimere il pacchetto vtenext nella cartella */var/www/html/* ed assegnare proprietario e gruppo alla cartella e ai file contenuti ricorsivamente con il comando

```bash
chown -R www-data:www-data /var/www/html/CARTELLA/
```

Aprire il browser digitate nella barra degli indirizzi l’url per giungere alla cartella appena generata nel server e si avvierà la procedura di configurazione di vtenext.

[![install_vtenext_1.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-06/install-vtenext-1.png)](https://usermanual.vtenext.com/uploads/images/gallery/2020-05-May/5.PNG)

Premere il pulsante **Install** e accettare le condizioni di licenza per proseguire.

[![install_vtenext_2.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-06/install-vtenext-2.png)](https://usermanual.vtenext.com/uploads/images/gallery/2020-05-May/6.PNG)

Se tutti i pacchetti sono stati installati e le impostazioni del file php.ini sono state settate correttamente si visualizzerà la seguente schermata.

Per modificare i parametri di **RECOMMENDED PHP SETTINGS** digitare s*udo nano/etc/php/8.3/apache2/php.ini* e cercare i valori da modificare, riavviare Apache e premere il pulsante **Check Again.**

[![install_vtenext_3.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-06/install-vtenext-3.png)](https://usermanual.vtenext.com/uploads/images/gallery/2020-05-May/7.PNG)

Premere il pulsante **Next**. Configurare i parametri del database e premere il pulsante **Next.**

[![install_vtenext_4.png](https://usermanual.vtenext.com/uploads/images/gallery/2026-06/install-vtenext-4.png)](https://usermanual.vtenext.com/uploads/images/gallery/2020-05-May/8.PNG)

**Confermare le configurazioni e avviare l’installazione.**