Come installare DokuWiki su Debian 12

DokuWiki è un software wiki open-source semplice e versatile che non richiede un database. È noto per la sua facilità di manutenzione, leggibilità e gestione degli utenti, rendendolo ideale per creare e gestire documentazione in ambienti aziendali o collaborativi. Alimentato da PHP, il suo software wiki versatile e il supporto integrato per i Controlli di Accesso (ACL) supportano i principali driver di autenticazione. DokuWiki offre una facile amministrazione, è facile da installare, mantenere e fare backup da un host all’altro.

In questa guida, ti guideremo attraverso l’installazione di DokuWiki sul server Debian 12. Installerai DokuWiki con LAMP Stack (Apache2, MariaDB e PHP), UFW e certificati SSl/TLS tramite Letsencrypt.

Prerequisiti

Assicurati di avere quanto segue per procedere con questa guida:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore.
• Un nome di dominio puntato all’indirizzo IP del server.

Installazione delle dipendenze

Per impostazione predefinita, il pacchetto DokuWiki è disponibile nel repository Debian. Ma, per assicurarti di avere l’ultima versione di DokuWiki installata, installerai DokuWiki manualmente sul tuo server Debian.

In questa sezione, installerai le dipendenze per DokuWiki, inclusi i pacchetti LAMP Stack (Apache2, MariaDB e PHP), UFW e Certbot.

Prima di iniziare, aggiorna il tuo repository Debian utilizzando il comando qui sotto.

sudo apt update

Installa i pacchetti LAMP Stack, UFW e Certbot utilizzando il seguente comando apt install. Digita Y e premi INVIO quando richiesto.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

Una volta terminata l’installazione, verifica lo stato del servizio Apache e MariaDB per assicurarti che il servizio sia in esecuzione.

Esegui il seguente comando per controllare il servizio apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Quando apache2 è in esecuzione, dovresti ottenere un output ‘attivo (in esecuzione)’. E l’output ‘abilitato’ conferma che apache2 si avvierà all’avvio del sistema.

Ora esegui il seguente comando per verificare il servizio mariadb.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Assicurati che il servizio mariadb sia ‘abilitato’ e ‘attivo (in esecuzione)’ sulla tua macchina Debian.

Configurazione di UFW

In questa guida, proteggerai il tuo server Debian con UFW (Uncomplicated Firewall). In tal caso, devi aprire la porta SSH per il tuo accesso remoto e le porte per i protocolli HTTP e HTTPS per eseguire l’installazione di DokuWiki.

Esegui il seguente comando per aggiungere i profili OpenSSH e ‘WWW Full‘ a UFW.

Il profilo OpenSSH aprirà la porta SSH predefinita 22, mentre il profilo ‘WWW Full’ apre sia le porte HTTP che HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

Ora, esegui il seguente comando per avviare e abilitare UFW sulla tua macchina Debian.

sudo ufw enable

Inserisci y quando ti viene chiesto di confermare, e dovresti ottenere un output come ‘Il firewall è attivo e abilitato all’avvio del sistema‘. L’UFW verrà eseguito automaticamente all’avvio del sistema.

Infine, esegui il seguente comando per verificare lo stato di UFW. Assicurati che entrambi i profili OpenSSH e ‘WWW Full’ siano elencati nelle tue regole abilitate da UFW.

sudo ufw status

Configurazione di php.ini

Nella sezione seguente, configurerai PHP modificando il file php.ini predefinito e regolando alcune delle configurazioni per l’installazione di DokuWiki.

Esegui il seguente comando dell’editor nano per aprire il file di configurazione PHP ‘/etc/php/8.2/apache2/php.ini‘.

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

Cambia la configurazione predefinita con la seguente. Assicurati di regolare il parametro memory_limit con la tua attuale RAM del server.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

Salva e chiudi il file quando hai finito.

Ora, esegui il comando systemctl qui sotto per riavviare il servizio apache2 e applicare gli effetti delle tue modifiche.

sudo systemctl restart apache2

Configurazione del server MariaDB

Ora che hai configurato PHP, il passo successivo è configurare l’installazione del tuo server MariaDB, quindi creare un nuovo database e un utente che utilizzerà DokuWiki.

Inizia il processo di configurazione di MariaDB eseguendo il comando mariadb-secure-installation qui sotto.

sudo mariadb-secure-installation

Inserisci Y quando ti viene chiesto di applicare la nuova configurazione a MariaDB, oppure puoi anche digitare n per No per rifiutarla. Di seguito sono riportate alcune delle configurazioni di MariaDB a cui ti verrà chiesto:

• L’installazione predefinita di MariaDB viene fornita senza una password, premi INVIO quando ti viene chiesto di inserire la password.
• Ora inserisci Y per impostare la password di root di MariaDB. Quindi, digita la nuova password per MariaDB e ripeti la password.
• Inserisci Y per rimuovere l’utente anonimo dalla tua installazione di MariaDB.
• Inserisci Y di nuovo quando ti viene chiesto di disabilitare il login remoto per l’utente root di MariaDB.
• Inserisci Y per rimuovere il database di test predefinito dalla tua MariaDB.
• Infine, inserisci Y per ricaricare i privilegi delle tabelle e applicare le nuove modifiche.

Dopo che la configurazione di MariaDB è terminata, devi creare un nuovo database e un utente che saranno utilizzati da DokuWiki.

Accedi al server MariaDB eseguendo il comando mariadb qui sotto. Inserisci la tua password di root di MariaDB quando richiesto.

sudo mariadb -u root -p

Ora esegui le seguenti query per creare un nuovo database dokuwikidb, utente dokuwiki, con la password ‘p4ssword‘. Assicurati di cambiare la password con la tua nuova password.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

Successivamente, verifica l’utente dokuwiki per assicurarti dei privilegi sul database dokuwikidb.

SHOW GRANTS FOR dokuwiki@localhost;

Nell’output seguente, hai configurato l’utente dokuwiki con pieni privilegi per il database dokuwikidb.

Infine, digita quit per uscire dal server MariaDB e passare al passaggio successivo.

Download del codice sorgente di DokuWiki

In questa sezione, scaricherai il codice sorgente di DokuWiki e imposterai la directory di installazione con i permessi appropriati.

Passa alla directory /var/www/ e scarica l’ultima versione stabile di DokuWiki utilizzando il comando wget qui sotto.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Ora estrai il file dokuwiki-stable.tgz e rinomina la directory estratta in dokuwiki. Questo significa che la tua directory di installazione di DokuWiki sarà disponibile in /var/www/dokuwiki.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

Infine, esegui il comando qui sotto per cambiare la proprietà della directory /var/www/dokuwiki all’utente www-data e al gruppo www-data. In questo modo, il tuo server web Apache2 sarà in grado di leggere il codice sorgente di DokuWiki.

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

Configurazione dell’host virtuale Apache2

Dopo aver scaricato DokuWiki, ora creerai un nuovo file di host virtuale Apache2 per eseguire DokuWiki. Assicurati che il tuo nome di dominio sia pronto prima di iniziare. In questo esempio, utilizzeremo il dominio wiki.howtoforge.local.

Ora, esegui il comando dell’editor nano qui sotto per creare una nuova configurazione dell’host virtuale Apache2 /etc/apache2/sites-available/dokuwiki.conf.

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

Inserisci la seguente configurazione e assicurati di cambiare il nome di dominio wiki.howtoforge.local con il tuo dominio.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined  

Quando hai finito, salva e chiudi il file.

Successivamente, esegui il seguente comando per abilitare l’host virtuale dokuwiki.conf e verificare la sintassi di Apache per assicurarti che non ci siano errori.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

Se hai una sintassi corretta e non ci sono errori, vedrai un output ‘Sintassi OK‘.

Infine, esegui il comando qui sotto per riavviare il server Apache2 e applicare le tue modifiche.

sudo systemctl restart apache2

Proteggere DokuWiki con certificati SSL/TLS

A questo punto, il tuo DokuWiki è in esecuzione e accessibile. Ma per assicurarti che la tua installazione sia sicura, imposterai i certificati SSl/TLS tramite Letsencrypt.

Esegui il comando certbot qui sotto per generare certificati SSL/TLS per il tuo nome di dominio DokuWiki. Assicurati di cambiare l’indirizzo email e il nome di dominio con le tue informazioni.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Una volta terminato il processo, la tua installazione di DokuWiki dovrebbe essere automaticamente configurata con HTTPS. E i tuoi certificati SSL/TLS dovrebbero essere disponibili nella directory /etc/letsencrypt/live/yourdomain.com.

Installazione di DokuWiki tramite Web Installer

Apri il tuo browser web e visita il tuo nome di dominio per l’installazione di DokuWiki, come https:/wiki.howtoforge.local/install.php. Dovresti vedere l’installer web di DokuWiki.

Seleziona l’opzione Abilita ACL, inserisci il tuo utente admin, email e password per DokuWiki, quindi fai clic su Salva.

Una volta completata l’installazione, dovresti ottenere un output ‘La configurazione è stata completata con successo.‘.

Pictu re

Ora torna al tuo terminale e elimina lo script install.php utilizzando il comando qui sotto.

sudo rm /var/www/dokuwiki/install.php

Successivamente, fai clic sul link ‘il tuo nuovo DokuWiki‘ per continuare. E dovresti ottenere la homepage di DokuWiki come segue.

Ora fai clic sul pulsante Accedi e dovresti ottenere la pagina di accesso di DokuWiki come segue.

Inserisci il tuo utente admin e la password, quindi fai clic su Accedi. Quando hai successo, dovresti essere presentato con il dashboard di DokuWiki.

Conclusione

Congratulazioni! Hai ora completato l’installazione di DokuWiki sul server Debian 12. Hai installato DokuWiki con il LAMP Stack (Apache2, MariaDB e PHP). Hai anche protetto la tua installazione di DokuWiki con UFW (Uncomplicated Firewall) e certificati SSL/TLS da Letsencrypt.