SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

BookStack, Wiki.js o Outline: quale wiki self-hosted?

Confronto tra BookStack, Wiki.js e Outline su installazione, editor, accesso e ricerca, con una scelta chiara per amministratori singoli e team.

Quale wiki self-hosted usare

Un wiki self-hosted raccoglie i documenti del team in un unico punto ricercabile, su un server sotto il tuo controllo. BookStack, Wiki.js e Outline svolgono tutti questo compito. La differenza principale riguarda la quantità di componenti da configurare prima di visualizzare la prima pagina e gli utenti autorizzati ad accedere.

BookStack è il più semplice da mettere in funzione e impone la struttura più rigida. Wiki.js offre la scelta più ampia di editor all'interno di un unico albero di pagine. Outline offre la migliore esperienza di scrittura tra i tre, ma la configurazione di produzione documentata richiede un identity provider esterno per creare il workspace iniziale.

Tutto ciò che segue è tratto dalla documentazione dei progetti e dai relativi file di configurazione pubblicati. Si tratta di un confronto delle funzionalità, non di un benchmark. I numeri di versione e i requisiti riportano una data perché tutti e tre i progetti sono soggetti a cambiamenti.

La struttura è una scelta vincolante

BookStack definisce la struttura dei contenuti. Una pagina si trova all'interno di un libro, un libro può contenere capitoli e gli scaffali raggruppano i libri. Non è possibile creare un quinto livello. Questo limite è parte del prodotto: un nuovo autore sa dove collocare una pagina perché esiste un solo punto in cui inserirla. Il compromesso è che i contenuti che non rientrano nella struttura devono essere adattati.

Wiki.js usa un albero di percorsi, simile alle cartelle su un disco. Una pagina in ops/backup/restic si trova nel punto in cui la si colloca e si sceglie la profondità. Nulla impedisce a due persone di archiviare lo stesso argomento in due rami diversi. Per questo un'istanza Wiki.js deve avere una persona responsabile dell'albero.

Outline usa raccolte con documenti annidati all'interno di altri documenti. Per spostare un documento è sufficiente trascinarlo con il mouse. È la soluzione più flessibile delle tre, quindi è anche quella che tende più facilmente a perdere coerenza.

BookStack: installazione minima

BookStack è un'applicazione PHP basata su MySQL. A ottobre 2026, i requisiti documentati sono PHP 8.2 o versione successiva e MySQL 8.0 oppure MariaDB 10.6 o versione successiva, oltre a Composer 2.2 o versione successiva se l'installazione viene eseguita dal codice sorgente. Il ramo di versioni corrente è 26.09, rilasciato il 24 settembre 2026, mentre la versione stabile più recente è v26.09.3, un aggiornamento di sicurezza dell'11 novembre 2026. A partire dalla versione 26.09 deve essere impostato un valore APP_KEY; i passaggi per i container riportati di seguito lo gestiscono già. Il progetto BookStack ha inoltre pubblicato un avviso critico di sicurezza per PHP il 21 ottobre 2026: aggiorna i pacchetti PHP sottostanti oppure scarica e ricrea il container con un'immagine corretta, perché la sola versione di BookStack non conferma che PHP sia aggiornato.

Il progetto supporta ufficialmente gli script di installazione e le istruzioni per le versioni Ubuntu LTS elencate, attualmente 22.04, 24.04 e 26.04, e talvolta pubblica guide e script non supportati per altri ambienti. Lo script per 24.04 installa Apache, MySQL 8.0 e PHP 8.3. Su 26.04, usa invece installation-ubuntu-26.04.sh nei comandi riportati di seguito; installa MySQL 8.4 e PHP 8.5.

wget https://codeberg.org/bookstack/devops/raw/branch/main/scripts/installation-ubuntu-24.04.sh
chmod a+x installation-ubuntu-24.04.sh
sudo ./installation-ubuntu-24.04.sh

Leggi l'avviso dello script prima di eseguirlo. La documentazione specifica che è "SOLO PER UN SISTEMA OPERATIVO NUOVO; installerà Apache, MySQL 8.0 e PHP 8.3 e potrebbe SOVRASCRIVERE qualsiasi configurazione web esistente sulla macchina". Lo script per 24.04 verifica la presenza di una configurazione Apache e di dati MySQL esistenti e interrompe l'installazione prima di apportare modifiche se ne trova uno dei due. In questo caso usa invece i container oppure installa BookStack manualmente sopra uno stack LAMP esistente su Ubuntu 24.04.

La modalità con container usa l'immagine LinuxServer.io, una delle due configurazioni di container gestite dalla community elencate nella documentazione di BookStack. BookStack richiede una chiave di crittografia per le sessioni e non pubblicherà le pagine senza di essa, quindi generala prima.

docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

Copia il valore stampato in APP_KEY, quindi scrivi il servizio. Questo servizio richiede inoltre un database MySQL o MariaDB già esistente; imposta i valori di DB_* in modo che corrispondano al database, perché lo snippet non crea un servizio database.

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - APP_URL=https://wiki.example.com
      - APP_KEY=paste_the_generated_key_here
      - DB_HOST=bookstack_db
      - DB_PORT=3306
      - DB_USERNAME=bookstack
      - DB_PASSWORD=change_me
      - DB_DATABASE=bookstackapp
    volumes:
      - ./config:/config
    ports:
      - 6875:80
    restart: unless-stopped

APP_URL deve corrispondere all'indirizzo che gli utenti digitano effettivamente, incluso lo schema e l'eventuale porta. Impostalo su http://localhost e poi pubblica il sito tramite HTTPS; in caso contrario, i collegamenti generati e i redirect punteranno all'host errato e gli utenti vedranno una pagina di accesso che torna continuamente su se stessa. Se i file Compose sono una novità, inizia da Nozioni di base su Docker Compose su un VPS prima di seguire questa procedura.

Avvia il servizio e verifica che l'applicazione risponda, non soltanto che il container sia in esecuzione:

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:6875/login

Un 200 OK indica che l'applicazione PHP è stata avviata e ha raggiunto il database. Un 500 richiede l'analisi del log degli errori dell'applicazione. Per impostazione predefinita, BookStack scrive gli errori in un file di log anziché nell'output del container; apri quindi ./config/log/bookstack/laravel.log sull'host per individuare la causa. docker compose logs bookstack mostra i messaggi di avvio del container, che potrebbero non includere l'errore dell'applicazione.

Wiki.js: un solo albero, più editor

Wiki.js è un'applicazione Node.js. La configurazione Docker documentata per la versione 2 la abbina a PostgreSQL, anche se la versione 2 accetta anche MySQL, MariaDB, MSSQL e SQLite. La versione 3 richiede PostgreSQL 17 o 18. Questo è il file Compose della pagina Docker del progetto per la versione 2:

services:
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: none
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data
  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    init: true
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "80:3000"
volumes:
  db-data:

Modificare insieme POSTGRES_PASSWORD e DB_PASS prima di eseguire il file, perché costituiscono una credenziale e il valore di esempio è pubblico. Il tag è fissato a ghcr.io/requarks/wiki:2 intenzionalmente. La documentazione sconsiglia latest, perché una nuova versione principale può introdurre modifiche incompatibili; latest non viene più assegnato per la versione 3 e successive.

La versione 3 è diventata stabile il 1 novembre 2026. Al 27 ottobre 2026, la release più recente della versione 2 è 2.5.317, una build di correzione dei bug del 23 ottobre 2026 che ricrea l'immagine con gli ultimi aggiornamenti di sicurezza di Node. Le release della versione 2 vengono ora pubblicate da un repository requarks/wiki-v2 separato e il tag dell'immagine :2 continua a seguirle. Alla verifica del 16 novembre 2026, la documentazione di installazione della versione 3 elenca i tag ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0 e ghcr.io/requarks/wiki:3.4, con immagini contrassegnate dalle versioni major, major.minor e major.minor.patch. Usare la versione 3 per una nuova installazione; l'esempio Compose precedente resta una configurazione della versione 2. La release precedente, 2.5.316 del 2 ottobre 2026, ha aggiunto un'utilità di esportazione per consentire in seguito il trasferimento dei contenuti alla versione 3. Un'installazione esistente della versione 2 richiede l'esportazione e l'importazione in un'istanza separata della versione 3, non la semplice modifica del tag dell'immagine in uso; dopo la migrazione, verificare i permessi e riconfigurare l'autenticazione e lo storage.

Al primo caricamento, Wiki.js 2 guida l'utente attraverso una procedura di configurazione nel browser che crea l'account amministratore. Fino al completamento della procedura, chiunque raggiunga la porta visualizza la procedura guidata. Per questo motivo, configurare il servizio dietro il reverse proxy e TLS (transport layer security) prima di aprire la porta nel firewall. Un wiki con un hostname dedicato si integra naturalmente con Traefik davanti a più applicazioni Docker quando il server ospita più servizi.

La scelta dell'editor è il motivo per cui molti scelgono Wiki.js. Una singola istanza della versione 2 può contenere affiancate pagine Markdown, pagine dell'editor visuale, pagine HTML raw e pagine AsciiDoc. Questo è utile quando si importa contenuto precedente in un formato che si preferisce non convertire. È anche possibile ritrovarsi con quattro stili redazionali diversi nello stesso wiki. Per questo motivo, scegliere l'editor predefinito il primo giorno e documentare la decisione.

Outline: l'editor migliore, con i prerequisiti più impegnativi

Outline è ciò che di solito si intende quando si cerca uno strumento per le note con un'esperienza simile a quella di un prodotto commerciale. È un'applicazione Node.js e, al 16 novembre 2026, la release corrente è la 1.13.0, pubblicata il 15 novembre 2026. Questa release non supporta più Node 20 e aggiorna l'immagine Docker a Node 26.13.1; aggiornate quindi le installazioni precedenti. Le installazioni da sorgente richiedono ora Node 22.23.5, 24.22.3 o 26.13.1 o versioni successive. Il file di ambiente di esempio elenca i requisiti: PostgreSQL tramite DATABASE_URL, Redis tramite REDIS_URL, due secret casuali e un URL raggiungibile pubblicamente.

openssl rand -hex 32
openssl rand -hex 32

Eseguite il comando due volte e conservate entrambi i valori. Il primo diventa SECRET_KEY, il secondo UTILS_SECRET. La parte principale del file di ambiente è quindi simile alla seguente:

NODE_ENV=production
URL=https://docs.example.com
PORT=3000
SECRET_KEY=<first openssl value>
UTILS_SECRET=<second openssl value>
DATABASE_URL=postgres://outline:change_me@postgres:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://redis:6379
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data

PGSSLMODE=disable è corretto soltanto quando il database si trova sulla stessa macchina o sulla stessa rete Docker. Omettetelo se il database è raggiunto tramite la rete; in caso contrario, la connessione avviene in chiaro. Gli allegati non richiedono più necessariamente l'object storage: FILE_STORAGE=local salva i caricamenti nella directory indicata sopra, che deve essere un volume scrivibile dal container e incluso nei backup. Impostate FILE_STORAGE=s3 usando invece i valori AWS_* se volete salvare quei file in un bucket compatibile con S3.

Ora viene la parte che spesso sorprende. Outline non dispone di un accesso integrato con nome utente e password. La configurazione di esempio fornita dal progetto specifica che sono necessarie le credenziali per l'accesso tramite un provider esterno: "at least ONE OF these is required for a working installation or you'll have no sign-in options". I provider documentati includono Google, Slack, Microsoft Entra, Discord e qualsiasi server OpenID Connect (OIDC) generico tramite OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_AUTH_URI, OIDC_TOKEN_URI e OIDC_USERINFO_URI. Gli workspace esistenti possono inoltre abilitare passkey e link o codici inviati tramite email; l'accesso tramite email richiede SMTP e non aggira il SSO per gli account collegati a un provider SSO.

Il costo reale della configurazione di produzione documentata per Outline è quindi Outline più PostgreSQL più Redis più un provider di identità. Se il team utilizza già Google Workspace o Microsoft Entra per l'accesso, Outline diventa molto interessante. In caso contrario, dovrete anche gestire in autonomia un servizio come Keycloak o Authentik, che costituisce un secondo servizio da aggiornare e sottoporre a backup. Pianificate di conseguenza la memoria: la documentazione di Outline indica circa 512 MB per processo web, configurati tramite WEB_CONCURRENCY, oltre alla memoria necessaria per il database e Redis.

Come gestiscono l'accesso ai contenuti

BookStack offre account locali con indirizzo email e password e supporta LDAP, SAML2 e OIDC come alternative. Le autorizzazioni vengono definite per ruolo e possono essere sostituite a livello di singolo scaffale, libro, capitolo o pagina. Le autorizzazioni di libri e capitoli vengono ereditate dai contenuti subordinati, salvo override; quelle degli scaffali devono essere copiate esplicitamente nei libri.

Wiki.js offre anch'esso account locali e aggiunge un lungo elenco di strategie da abilitare nell'area di amministrazione. Le regole delle pagine concedono o negano l'accesso in base a un pattern del percorso. Questa funzione è potente, ma può generare facilmente errori: una regola che consente i percorsi che iniziano con ops/ si applica a ogni pagina archiviata in seguito sotto quel percorso.

Outline usa il provider di identità per la gestione dei membri tramite SSO; all'interno di Outline, l'accesso viene controllato per raccolta, documento e gruppo. Gli utenti rimossi dal provider di identità vengono disconnessi al caricamento successivo di Outline; sospendili in Outline per chiudere immediatamente le sessioni esistenti.

Come funziona la ricerca in ciascuna piattaforma

La ricerca determina se un wiki diventa uno strumento utile oppure un archivio di file dimenticati.

BookStack cerca nel database e offre agli utenti un linguaggio di query che possono imparare in un minuto. Racchiudere una frase tra virgolette, come in "london meeting", richiede la corrispondenza esatta della stringa. Le parentesi quadre cercano i tag: [location=london] esegue la ricerca per nome del tag, valore o entrambi, con confronti come !=, >= e like. Le parentesi graffe filtrano i metadati, come in {created_after:2016-12-30}. È possibile negare qualsiasi termine esatto, tag o filtro anteponendogli -. BookStack limita il numero di termini di ogni tipo presenti in una singola query. Di conseguenza, una query molto lunga viene troncata invece di essere eseguita.

Wiki.js 2 tratta la ricerca come un modulo collegabile. I motori documentati sono un motore di base per database, un motore PostgreSQL, Elasticsearch, Algolia, AWS CloudSearch e Azure Search. Il motore di base confronta titoli, descrizioni e percorsi, non il contenuto delle pagine. Se usi PostgreSQL, passa al motore PostgreSQL nell'area di amministrazione, perché usa l'indice full text del database invece di una semplice corrispondenza. Mantieni Elasticsearch solo per un wiki abbastanza grande da giustificare l'esecuzione e l'aggiornamento di un secondo servizio di ricerca.

Outline usa gli indici full text di PostgreSQL. La ricerca integrata per parole chiave non richiede un servizio di ricerca separato. Per un wiki di team con poche migliaia di documenti, è la soluzione che richiede meno lavoro tra le tre.

Quale soluzione è più adatta a te

Scegli BookStack se vuoi avere il wiki operativo già questo pomeriggio e preferisci discutere dei contenuti invece che della struttura. Ha il minor numero di componenti: un'applicazione PHP e un database MySQL. È adatto ai runbook interni e alla documentazione per i clienti, nonché ai team in cui la maggior parte degli autori non è composta da tecnici. È anche il più semplice dei tre da sottoporre a backup, perché lo stato è costituito da un dump del database, dai file caricati e dalla configurazione .env, incluso APP_KEY.

Scegli Wiki.js se ti serve un editor specifico o una strategia di autenticazione specifica che gli altri non offrono, oppure se stai importando una grande quantità di contenuti Markdown o AsciiDoc esistenti e vuoi preservare la struttura dei percorsi. Devi accettare di gestire uno stack più complesso e fissare il tag della versione principale.

Scegli Outline se la qualità della scrittura è l'aspetto più importante, se il wiki è destinato a un team anziché al pubblico e se disponi già di un identity provider. Questa configurazione offre in cambio un editor che le persone usano volentieri. Non sceglierlo come prima applicazione self-hosted.

Se nessuna delle tre soluzioni è adatta, di solito il problema riguarda il tipo di contenuti. Fatture e contratti acquisiti tramite scansione appartengono a un sistema di gestione documentale come Paperless-ngx, non a un wiki; forzarli in un wiki è il motivo per cui tanti wiki vengono infine abbandonati. L'altro caso comune è aver bisogno di un workspace anziché di un wiki, con documenti, tabelle e una lavagna su un'unica canvas: in questo caso un workspace AFFiNE self-hosted è più adatto di tutte e tre le soluzioni precedenti. Per una panoramica più ampia delle altre applicazioni che meritano un posto sul tuo server, consulta la selezione di applicazioni self-hosted per il 2026.

Dimensionamento e backup

Tutte e tre le soluzioni possono essere eseguite su un VPS di piccole dimensioni. Il limite minimo realistico varia in base ai componenti usati da ciascuna. BookStack richiede un processo applicativo e MySQL. Wiki.js richiede un processo Node e PostgreSQL. Outline richiede un processo Node, PostgreSQL e Redis, in genere anche con un provider di identità. Per questo è la soluzione a cui assegnare più memoria.

Eseguire il backup del database e dei file caricati insieme. Prima di affidarsi a questo backup, ripristinare entrambi almeno una volta in un'istanza temporanea. Un backup di una wiki che non è mai stato ripristinato è solo un'ipotesi. Per BookStack questo significa mysqldump e il volume /config. Per Wiki.js e Outline significa pg_dump e il volume dei dati. Per Outline significa inoltre tutto ciò che si trova in FILE_STORAGE_LOCAL_ROOT_DIR.

FAQ

Quale wiki self-hosted è più semplice da installare?

BookStack. È una singola applicazione PHP con un database MySQL. Il progetto distribuisce uno script di installazione per Ubuntu 24.04 che configura Apache, MySQL 8.0 e PHP 8.3 in una sola esecuzione. L'immagine del container richiede un APP_KEY, un APP_URL e le credenziali per un database esistente. Wiki.js aggiunge un runtime Node e un server PostgreSQL. Outline aggiunge Redis e un provider di identità esterno per la configurazione iniziale descritta nella documentazione.

Posso usare Outline senza Google o un altro provider SSO?

La configurazione di produzione documentata richiede un provider per creare il workspace iniziale. Outline non dispone di un accesso locale con nome utente e password. La configurazione di esempio specifica che è richiesto almeno un provider di accesso di terze parti. In caso contrario, non sarà disponibile alcuna opzione di accesso. Puoi usare Google, Slack, Microsoft Entra, Discord o qualsiasi server OpenID Connect generico, ad esempio Keycloak o Authentik self-hosted. I workspace esistenti possono abilitare passkey oppure link e codici inviati tramite email. Per l'accesso tramite email è richiesto SMTP. Gli account collegati a SSO continuano a usare quel provider.

Devo installare Wiki.js 3 o Wiki.js 2?

La versione 3 per una nuova installazione. È diventata stabile il 1 novembre 2026. La documentazione di installazione ora elenca i tag ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0 e ghcr.io/requarks/wiki:3.4. Specifica il tag della versione principale invece di latest, che non viene più assegnato alla versione 3 o successive. L'esempio Compose precedente resta vincolato alla versione 2. Le installazioni esistenti della versione 2 devono esportare un pacchetto di migrazione e importarlo in un'istanza separata della versione 3. La semplice modifica del tag dell'immagine non è un aggiornamento supportato.

Quale offre la ricerca migliore?

Sono efficaci in modi diversi. BookStack offre ai lettori un linguaggio di query con frasi esatte, filtri per tag come [location=london] e filtri per metadati come {created_after:2016-12-30}. Ognuno di questi termini può essere escluso anteponendo -. La ricerca integrata per parole chiave di Outline non richiede un servizio di ricerca separato. Wiki.js 2 è il più configurabile, perché consente di scegliere il motore. Il motore PostgreSQL cerca anche nei contenuti delle pagine, a differenza del motore di base.

Posso spostare in seguito i contenuti da un prodotto all'altro?

In parte, ma devi prevedere attività manuali. Tutti e tre esportano Markdown. Tuttavia, l'importazione integrata di BookStack accetta il formato Portable ZIP. Il solo Markdown non consente quindi un'importazione diretta in BookStack. La struttura non viene trasferita correttamente. I libri e i capitoli di BookStack non hanno un equivalente nei documenti nidificati di Outline. I percorsi di Wiki.js non corrispondono alla gerarchia fissa di BookStack. Gli allegati, i permessi e la cronologia delle pagine sono gli elementi che con maggiore probabilità andranno persi. Esporta quindi un campione e verifica questi aspetti prima di avviare la migrazione.

Questo articolo ti è stato utile?

#bookstack#wikijs#outline#wiki#self-hosting#knowledge-base