Installare Kliqqi su Ubuntu — Guida passo passo

Kliqqi è un CMS per community social che puoi ospitare su un server Ubuntu. Questa guida spiega i requisiti, come preparare il database, installare i file, configurare Apache e completare la procedura guidata di installazione. Include checklist operative, consigli di sicurezza e criteri di verifica.

Panoramica

Kliqqi permette di creare community social responsive, simili a Twitter o Facebook. In questa guida troverai tutti i comandi e le configurazioni necessari per installarlo su un server Ubuntu con Apache, PHP e MySQL (o MariaDB).

Importante: mantieni aggiornato PHP e MySQL/MariaDB e usa un dominio reale per la configurazione del VirtualHost. Definizione rapida: CMS — sistema di gestione dei contenuti: software che consente di creare e amministrare contenuti web senza riscrivere codice.

Requisiti

Prima di iniziare, assicurati di avere su Ubuntu Server i seguenti componenti installati e funzionanti:

• Apache2 (web server)
• PHP — almeno versione 5.4 (preferibile 7.x o superiore per sicurezza)
• MySQL o MariaDB — almeno versione 5.1 (preferibile versioni più recenti)

Nota: PHP 5.4 è obsoleto; usa una versione supportata dalla tua distribuzione per motivi di sicurezza. Abilita i moduli PHP tipici (pdo, mysqli, mbstring, xml) e il modulo Apache rewrite.

Creare il database per Kliqqi

Accedi al server e crea il database e l’utente MySQL per Kliqqi. Esegui i comandi seguenti con un utente root o con privilegi sudo:

mysql -u root -p
CREATE DATABASE kliqqi;

Creare l’utente database per Kliqqi

Nel prompt MySQL crea un utente con i privilegi sul database kliqqi (sostituisci password con una password sicura):

GRANT ALL PRIVILEGES ON `kliqqi`.* TO 'kliqquser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;

Importante: non usare “password” in produzione; scegli una passphrase forte. Se il database è su un host diverso da localhost, sostituisci l’host appropriato.

Scaricare e installare Kliqqi

Scarica l’archivio stabile dal sito ufficiale. Nell’esempio usiamo wget con ripresa (-c) e salvataggio con -O:

wget -c https://www.kliqqi.com/download/2268/ -O Kliqqi1112017.zip
unzip Kliqqi1112017.zip
sudo mv Kliqqi1112017 /var/www/kliqqi
sudo chown -R www-data:www-data /var/www/kliqqi

Nota: il nome della cartella dopo l’estrazione può variare. Adatta il comando mv al nome effettivo prodotto da unzip.

Abilitare mod_rewrite e impostazioni Apache consigliate

Kliqqi potrebbe richiedere rewrite e override dalle .htaccess. Abilita i moduli necessari:

sudo a2enmod rewrite
sudo service apache2 restart

Configurare il VirtualHost di Apache (solo HTTP)

Crea il file di configurazione in /etc/apache2/sites-available/kliqqi.conf e inserisci il blocco seguente (modifica ServerName con il tuo dominio):

    ServerName kliqqi.exampleserver.xyz
    DocumentRoot /var/www/kliqqi

    
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    

    ErrorLog ${APACHE_LOG_DIR}/kliqqi.exampleserver.xyz-error.log
    CustomLog ${APACHE_LOG_DIR}/kliqqi.exampleserver.xyz-access.log combined

Abilita il sito e ricarica Apache:

sudo a2ensite kliqqi
sudo service apache2 reload

Consiglio: se usi HTTPS, configura un certificato (Let’s Encrypt/Certbot) e abilita redirect da HTTP a HTTPS.

Procedura guidata di installazione (Installation Wizard)

Apri il browser e punta a:

http://tuo-dominio/install/install.php

Seleziona la lingua nella prima schermata e poi procedi al passo successivo.

Configurazione del database nell’installer

Inserisci i dati del database creato in precedenza (host, nome_db, utente, password) e clicca su “Check Settings” o equivalente per verificare la connessione.

Se la verifica è positiva, l’installer aggiornerà il file di configurazione e procederà alla creazione degli schemi.

Creare l’amministratore

Durante l’installazione ti verrà chiesto di creare le credenziali amministrative. Annota queste credenziali in modo sicuro.

Dopo il completamento clicca su “Login to dashboard” per accedere al pannello di amministrazione.

Una volta autenticato potrai personalizzare impostazioni, temi, utenti, gruppi e policy.

Funzionalità principali dopo l’installazione

• Creare post e storie
• Creare e gestire gruppi
• Seguire altri utenti e avere follower
• Modificare profili e permessi

Checklist operativa (ruoli)

Amministratore (prima dell’installazione):

• Backup del server e snapshot (se possibile)
• Installare e aggiornare Apache, PHP, MySQL/MariaDB
• Creare database e utente dedicato
• Configurare VirtualHost e permessi filesystem
• Abilitare mod_rewrite e AllowOverride All

Sviluppatore/DevOps (post-installazione):

• Verificare error_log e access_log
• Impostare https e redirect HSTS
• Limitare permessi file e directory
• Eseguire test funzionali (login, creazione post, upload immagini)

Utente finale / Moderatore:

• Creare account admin e moderatori
• Definire policy di moderazione e contenuti
• Testare flusso di creazione gruppi e follow

SOP rapida: passo a passo (mini-playbook)

1. Aggiorna il sistema: sudo apt update && sudo apt upgrade
2. Installa LAMP stack (esempio semplificato): sudo apt install apache2 php libapache2-mod-php php-mysql mysql-server unzip wget
3. Crea DB e user (vedi comandi sopra)
4. Scarica ed estrai Kliqqi, sposta la cartella in /var/www
5. Imposta proprietario: sudo chown -R www-data:www-data /var/www/kliqqi
6. Crea VirtualHost e abilita sito
7. Apri il browser su /install/install.php e segui l’installer
8. Dopo l’installazione rimuovi la cartella installer se raccomandato dall’app

Criteri di accettazione (verifiche post-installazione)

• Il sito risponde su http(s)://tuo-dominio/ e mostra la home di Kliqqi
• L’amministratore può autenticarsi e raggiungere il pannello di controllo
• È possibile creare un post, un gruppo e un profilo utente
• I log di Apache non mostrano errori critici relativi a permessi o database

Test case / casi di verifica

• Login: credenziali admin valide -> successo
• Creazione post: testo + immagine -> visibile nella timeline
• Creazione gruppo: nome + descrizione -> ricerca e join
• Recupero password: invio email di reset (se configurata)

Sicurezza e hardening raccomandati

• Usa HTTPS: configura Certbot (Let’s Encrypt) o un certificato commerciale
• Imposta permessi restrittivi su /var/www/kliqqi (owner www-data)
• Mantieni PHP e MySQL aggiornati
• Disabilita directory listing (Options -Indexes)
• Proteggi l’accesso SSH (chiavi, port non standard, fail2ban)

Esempio rapido Certbot:

sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d tuo-dominio

Rischi e mitigazioni (matrice qualitativa)

• Rischio: permessi file errati -> Mitigazione: chown/chmod corretti (www-data)
• Rischio: PHP obsoleto -> Mitigazione: aggiornare versione PHP e testare compatibilità
• Rischio: mancata crittografia -> Mitigazione: abilitare HTTPS e HSTS
• Rischio: backup assenti -> Mitigazione: schedulare dump DB con mysqldump e snapshot filesystem

Backup e migrazione

Per eseguire un backup del database:

mysqldump -u root -p kliqqi > kliqqi-backup.sql

Per migrare il sito su altro server: copia la directory /var/www/kliqqi e importa il dump SQL nel nuovo DB.

Consigli pratici e quando Kliqqi potrebbe non essere la scelta migliore

• Kliqqi è adatto a community leggere/medie; per carichi molto elevati valuta soluzioni con architetture scalabili e cache avanzate.
• Se desideri funzionalità moderne out-of-the-box (microservizi, API GraphQL), verifica che Kliqqi soddisfi i requisiti; in alternativa considera CMS con ecosistemi più ampi.

Glossario (una riga)

• Apache: server web che serve contenuti HTTP/HTTPS.
• PHP: linguaggio server-side usato da Kliqqi.
• MySQL/MariaDB: sistema di gestione del database relazionale.
• VirtualHost: configurazione Apache per associare domini a cartelle.

Riepilogo

Kliqqi consente di lanciare rapidamente una community social su Ubuntu. Seguendo i passaggi descritti puoi preparare l’ambiente, configurare Apache, completare l’installazione guidata e mettere in sicurezza l’istanza. Verifica sempre i permessi, abilita HTTPS e pianifica backup regolari.

Importante: segnala nei commenti alternative che hai provato e le tue esperienze con Kliqqi o altri CMS social.