Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04

di Raffaele Chiatto | Nov 16, 2026 | 0 commenti

Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 - Raffaele Chiatto

 

 

Chi si occupa di sicurezza informatica conosce bene il problema: i vulnerability assessment e i penetration test producono una grande quantità di risultati, sparsi tra gli output di strumenti diversi come Nmap, OpenVAS, Nessus, Burp Suite o Nuclei.

Ognuno ha il suo formato, i suoi livelli di severità e le sue duplicazioni.

Mettere ordine in questi dati, capire quali vulnerabilità sono davvero rilevanti e seguirne la risoluzione nel tempo diventa presto un lavoro a sé, soprattutto per chi deve dimostrare un processo strutturato di gestione delle vulnerabilità secondo NIS2 o ISO 27001.

Faraday è una piattaforma open source di vulnerability management nata proprio per risolvere questo problema.

Importa e normalizza i risultati di decine di strumenti di sicurezza in un’unica interfaccia web e organizza il lavoro in workspace, per cliente, progetto o perimetro.

Consente inoltre di filtrare, deduplicare e assegnare priorità alle vulnerabilità, di seguirne lo stato fino alla chiusura e di collaborare sullo stesso assessment.

Grazie alla sua API e ai plugin si integra facilmente in pipeline e processi già esistenti.

In questo articolo vediamo come installare la versione Community di Faraday su Ubuntu Server 26.04 LTS usando il pacchetto .deb ufficiale.

Partiamo dalla preparazione del sistema e dei prerequisiti, passiamo all’inizializzazione del database e all’avvio dei servizi, e arriviamo alla pubblicazione dell’interfaccia web dietro un reverse proxy Nginx in HTTPS.

Lungo il percorso affronteremo anche un paio di problemi concreti che si incontrano installando Faraday sulla nuova release di Ubuntu: una dipendenza non più disponibile nei repository e una configurazione di Nginx che, se scritta male, blocca il login.

 

INTRODUZIONE

NOTA SULLA COMPATIBILITÀ: la documentazione ufficiale certifica Ubuntu 22.04 e 24.04 LTS, Debian 12+ e Kali. Ubuntu 26.04 non è ancora nell’elenco; il pacchetto .deb è autocontenuto e i passaggi sono gli stessi, ma conviene testare prima su una VM non di produzione.

Componenti installati:

Componente Ruolo Porta
PostgreSQL Database dei workspace e delle vulnerabilità 5432 (solo locale)
Redis Coda e cache per i worker Celery 6379 (solo locale)
faraday-server API e interfaccia web 5985
faraday-worker, faraday-worker-reports, faraday-beat Elaborazione asincrona, import dei report, task schedulati –
Nginx Reverse proxy con TLS 443

 

 

PREREQUISITI

Serve un Ubuntu Server 26.04 a 64 bit (amd64) con accesso sudo, almeno 2 vCPU, 4 GB di RAM e 20 GB di disco liberi. Per lavorare con report grandi meglio 8 GB di RAM.

1. Aggiorna il sistema e installa gli strumenti di base:

2. Imposta hostname e fuso orario (esempio):

3. Configura il firewall lasciando aperti solo SSH e HTTP/HTTPS (la porta 5985 resta chiusa: ci arriverà solo Nginx):

 

 

INSTALLAZIONE DI POSTGRESQL E REDIS

Faraday richiede PostgreSQL 12+ (consigliato 14+) e Redis 6.0+ (consigliato 7.x): le versioni nei repository di Ubuntu 26.04 sono ampiamente sopra il minimo.

4. Installa e abilita entrambi i servizi:

5. Verifica che rispondano:

Dovremmo visualizzare l’output seguente:

Eseguire il comando:

Dovremmo visualizzare l’output seguente:

 

6. Controlla che il database usi la codifica UTF-8 (in caso contrario initdb fallisce, vedi Troubleshooting):

Entrambi i servizi ascoltano solo su localhost per impostazione predefinita: non vanno esposti all’esterno.

 

INSTALLAZIONE DI FARADAY SERVER (.DEB)

La Community Edition si scarica dalla pagina Releases di GitHub (https://github.com/infobyte/faraday/releases); il pacchetto si chiama faraday-server_amd64.deb.

7. Scarica il pacchetto. Copia il link esatto dell’asset .deb dalla release più recente (al momento v5.25.4) e usalo con wget:

Quindi creare il pacchetto ponte coin i seguenti comandi:

 

8. Installa con apt, che risolve automaticamente le dipendenze:

9. Aggiungi il tuo utente al gruppo faraday creato dal pacchetto, poi esci e rientra (o usa newgrp) per applicare il gruppo:

Il pacchetto crea l’utente di sistema faraday, i comandi faraday-manage e le unit systemd. Il file di configurazione è /home/faraday/.faraday/config/server.ini.

 

INIZIALIZZAZIONE DEL DATABASE E UTENTE ADMIN

faraday-manage initdb crea utente e database PostgreSQL, applica le migrazioni e genera l’utente faraday (admin) con una password casuale mostrata una sola volta.

10. Lancia l’inizializzazione:

Dovremmo visualizzare il seguente output:

 

11. Copia subito la password stampata a fine output e salvala nel password manager. Se la perdi, reimpostala con:

Per creare altri amministratori: sudo faraday-manage create-superuser

 

AVVIO DEI SERVIZI E PRIMO ACCESSO

Faraday gira come quattro unit systemd: senza i worker la UI si apre ma l’import dei report resta bloccato.

12. Abilita e avvia tutti i servizi:

13. Verifica lo stato e che il server risponda sulla 5985:

14. Accedi dalla tua postazione con un tunnel SSH (la 5985 ascolta solo su localhost) e apri http://localhost:5985 nel browser, utente faraday e la password dello step 11:

Per l’accesso permanente da rete si usa Nginx (sezione successiva). Sconsigliato invece impostare bind_address = 0.0.0.0 in server.ini: esporrebbe l’API in HTTP in chiaro.

 

PUBBLICAZIONE DIETRO NGINX CON HTTPS

Faraday non gestisce TLS da sé: la documentazione ufficiale raccomanda un reverse proxy davanti alla 5985.

15. Installa Nginx:

16. Prepara il certificato. Per un server raggiungibile da Internet usa Let’s Encrypt:

In LAN usa un certificato della CA interna oppure, per test, uno self-signed:

 

17. Crea il virtual host. Faraday può generarne uno di base con

Quindi incollare all’interno il seguente output:

 

18. Abilita il sito e ricarica Nginx:

Ora Faraday risponde su https://faraday.example.local (crea il record DNS o la voce in hosts).

Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 - Raffaele Chiatto

Inserire le credenziali generate in precedenza e cliccare Login

Installazione e Configurazione Base di Faraday su Ubuntu Server 26.04 - Raffaele Chiatto

Se è andato tutto a buon fine dovremmo visualizzare la Dashboard di Faraday

 

METODO ALTERNATIVO DI INSTALLAZIONE: DOCKER COMPOSE

Se preferisci non installare nulla sull’host oltre a Docker, il file Compose ufficiale avvia PostgreSQL, Redis, server, worker e beat in un colpo solo. Salta gli step 4-14 e segui questi.

A. Installa Docker Engine e il plugin Compose v2 dai repository di Ubuntu:

B. Scarica il file Compose ufficiale:

C. Prima di avviare, sostituisci in docker-compose.yaml la password “postgres” di default (compare in POSTGRES_PASSWORD e in tutti i PGSQL_PASSWD) con una password robusta.

D. Avvia lo stack e inizializza il database (annota la password admin stampata):

Il server è pubblicato su 0.0.0.0:5985. Per esporlo solo a Nginx cambia la riga “ports” del servizio faraday-server in “127.0.0.1:5985:5985”, poi applica la sezione Nginx dagli step 15-18. Attenzione: Docker scrive regole iptables proprie e una porta pubblicata scavalca UFW.

Per aggiornare:

 

 

INSTALLAZIONE DEL CLIENT FARADAY-CLI

faraday-cli permette di lanciare scanner e caricare report da terminale. Su Ubuntu 26.04 pip non installa pacchetti a livello di sistema (PEP 668), quindi si usa pipx.

19. Installa il client sulla macchina da cui fai gli scan:

 

20. Autenticati, crea un workspace e importa un primo risultato:

Con un certificato self-signed aggiungi –ignore-ssl al comando auth.

 

TROUBLESHOOTING E COMANDI UTILI

Sintomo: initdb fallisce per permessi
Causa: l’utente faraday non può creare database
Fix: sudo -u postgres psql -c “ALTER USER faraday CREATEDB;”

Sintomo: initdb: encoding UTF8 incompatibile con template (SQL_ASCII)
Causa: template1 creato senza UTF-8
Fix: ricrea template1 in UTF-8 (SQL sotto), poi ripeti initdb

Sintomo: report caricati ma mai elaborati
Causa: Redis o worker fermi
Fix: redis-cli ping, poi sudo systemctl restart faraday-worker faraday-worker-reports

Sintomo: 413 Request Entity Too Large in import
Causa: limite upload di Nginx
Fix: alza client_max_body_size e ricarica Nginx

Sintomo: 502 Bad Gateway da Nginx
Causa: faraday-server non in ascolto
Fix: systemctl status faraday-server e controlla i log

Sintomo: Docker, porta 5985 o 5432 occupata
Causa: conflitto con servizi locali
Fix: ss -tlnp | grep -E ‘5985|5432’

Ricreare template1 in UTF-8:

Comandi utili:

 

 

 

 

 

CONSIDERAZIONI FINALI

Con questa guida abbiamo installato Faraday Community su Ubuntu Server 26.04 LTS e l’abbiamo pubblicato dietro un reverse proxy Nginx in HTTPS.

Ne risulta una piattaforma pronta per raccogliere in un unico punto i risultati dei vulnerability assessment.

Il percorso non è stato del tutto lineare: il pacchetto ufficiale non è ancora pensato per la nuova release di Ubuntu e la configurazione del reverse proxy nasconde una trappola. Una volta superati questi due ostacoli, però, Faraday si è dimostrato stabile e semplice da usare.

PRO

  • Open source e self-hosted: i dati sulle vulnerabilità, che sono tra le informazioni più sensibili di un’organizzazione, restano sui propri server.
  • Centralizzazione dei risultati: importa e normalizza gli output di molti strumenti diversi (Nmap, OpenVAS, Nessus, Burp Suite, Nuclei e altri) in un’unica vista.
  • Organizzazione in workspace: permette di separare clienti, progetti o perimetri. È comodo per chi lavora come MSP o consulente.
  • Gestione del ciclo di vita delle vulnerabilità: stati, severità, filtri e deduplica aiutano a passare dal semplice elenco di finding a un vero processo di remediation.
  • API e plugin: si integra facilmente in pipeline CI/CD e con altri strumenti, anche da riga di comando.
  • Supporto alla compliance: offre uno storico tracciabile delle vulnerabilità e della loro gestione, utile come evidenza per NIS2 e ISO 27001.

 

CONTRO

  • Pacchetto .deb non aggiornato per Ubuntu 26.04: richiede un workaround per la dipendenza libgdk-pixbuf2.0-0, non più presente nei repository.
  • Stack tecnico un po’ datato: i warning di deprecazione (pkg_resources, bcrypt) indicano dipendenze Python non allineate alle versioni più recenti.
  • Reverse proxy da configurare con attenzione: un Connection “upgrade” applicato a tutte le richieste blocca il login senza messaggi d’errore chiari.
  • Credenziali mostrate una sola volta: la password dell’amministratore viene generata durante l’initdb e, se non la si annota, va reimpostata.
  • Funzionalità avanzate a pagamento: reportistica personalizzata, workflow automatizzati, integrazioni enterprise e autenticazione centralizzata sono riservate alle edizioni commerciali.
  • Documentazione non sempre aggiornata: alcune indicazioni, come i nomi dei servizi systemd, non corrispondono alla versione installata.

 

In conclusione, Faraday Community è un’ottima base per chi vuole smettere di gestire le vulnerabilità con fogli Excel e cartelle di report sparse e passare a uno strumento strutturato e centralizzato.

Per un laboratorio, un piccolo team di sicurezza o un consulente che segue più clienti, la versione gratuita offre già molto. Chi ha bisogno di reportistica avanzata, automazione e integrazione con l’autenticazione aziendale dovrà invece valutare le edizioni commerciali o affiancare altri strumenti.

Articoli Recenti

Veeam Backup

Monitoring

Friends

  • My English Lab  English School
  • ChrSystem   Servizi ICT
  • Since 01  Kreative Graphics

Database

Networking

Autori

  • Raffaele Chiatto  Amministratore
  • Marco Valle  Autore
  • Angelo Lauria  Autore
  • Edoardo Prot  Autore
  • Davide D'Urso  Autore
Raffaele Chiatto

Raffaele Chiatto

Sono Raffaele Chiatto, un appassionato di informatica a 360 gradi.
Tutto è iniziato nel 1996, quando ho scoperto il mondo dell'informatica grazie a Windows 95, e da quel momento non ho più smesso di esplorare e imparare.
Ogni giorno mi dedico con curiosità e passione a scoprire le nuove frontiere di questo settore in continua evoluzione.

Categorie: Faraday | Ubuntu

Related Post

0 Commenti

Invia Un Commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *

Virtualizzazione

Linux

Microsoft

Apple

Backup

Database

Security

Automazione