Auto-hosting con Docmost: Team, Spazi e Permessi (2026)

Distribuire Docmost sul tuo VPS è solo l’inizio. Il vero valore viene da come strutturi la base di conoscenza del tuo team. Questa guida copre il lato pratico di Docmost per i team: organizzare gli spazi, impostare i permessi, comprendere i casi d’uso e ottenere il massimo dall’auto-hosting.

Perché i Team Scelgono Docmost

Docmost è stato creato per eliminare la pesantezza di Confluence e la dipendenza dal vendor di Notion. Per chi fa auto-hosting, risolve un problema reale: i team aziendali hanno bisogno di documenti collaborativi con controllo degli accessi, e il mercato open-source mancava di un’opzione raffinata prima dell’arrivo di Docmost.

Ragioni principali per cui i team scelgono Docmost:

• Nessuna tarificazione per posto — il costo si limita al VPS (~5–6 €/mese)
• Sovranità dei dati — tutti i documenti rimangono sul tuo server
• Collaborazione in tempo reale — cursori in diretta, nessun conflitto di salvataggio
• Struttura gerarchica — pagine annidate come in Notion
• Permessi granulari — controllo degli accessi a ogni livello

VPS Consigliato per l’Uso in Team

Per un team fino a 20 utenti, consigliamo:

Comprendere la Struttura di Docmost

Docmost organizza i contenuti su tre livelli:

Workspace
  └── Spazio (es. "Ingegneria", "Prodotto", "HR")
        └── Pagina (es. "Riferimento API")
              └── Sottopagina (es. "Autenticazione")

Workspace: Il contenitore di livello superiore per tutta l’organizzazione. Tutti gli utenti del workspace possono vedersi a vicenda.

Spazi: Pensali come dipartimenti o progetti. Ogni spazio ha i propri membri e permessi. Un utente può essere membro di alcuni spazi ma non di altri.

Pagine: I documenti veri e propri. Le pagine supportano sottopagine annidate per gerarchie di documentazione profonde.

Strutturare gli Spazi per il Tuo Team

Una buona struttura di spazi separa le responsabilità e riduce il rumore. Esempi:

Per una società software:

Ingegneria/
  Decisioni di architettura
  Riferimento API
  Runbook
Prodotto/
  Roadmap
  Specifiche funzionalità
  Ricerca utenti
HR/
  Onboarding
  Policy

Per un’agenzia:

Interno/
  Processi
  Template
Cliente-NomeProgetto/
  Brief
  Deliverable
  Note riunioni

Per creare uno spazio in Docmost:

1. Clicca su “Nuovo spazio” nella barra laterale
2. Dai un nome allo spazio e imposta opzionalmente un’icona
3. Imposta la visibilità (pubblica nel workspace o privata)
4. Aggiungi membri e assegna ruoli

Modello dei Permessi

Docmost usa il controllo degli accessi basato sui ruoli su due livelli:

Ruoli Workspace

• Owner: Admin completo — gestisce membri e tutte le impostazioni
• Admin: Può gestire membri e spazi
• Member: Utente standard con accesso agli spazi autorizzati

Ruoli Spazio

• Admin: Può gestire le impostazioni dello spazio, i membri e tutte le pagine
• Editor: Può creare e modificare pagine
• Viewer: Accesso in sola lettura

Imposta uno spazio come privato e aggiungi solo i membri pertinenti — ideale per spazi sensibili come HR o Finanza.

La Collaborazione in Tempo Reale nella Pratica

Docmost usa la trasformazione operazionale (OT) per gestire le modifiche concorrenti:

• Più utenti vedono i cursori degli altri durante la modifica
• Le modifiche si sincronizzano immediatamente senza salvataggi manuali
• La cronologia delle pagine permette di tornare a qualsiasi versione precedente

Per un funzionamento ottimale, il tuo VPS ha bisogno di una connessione stabile e del corretto supporto WebSocket nella configurazione Nginx (gli header Upgrade e Connection sono essenziali).

Integrazioni ed Estensioni

Docmost supporta diverse integrazioni:

• Email SMTP: Per inviti e notifiche — configurare in Impostazioni > Mail
• OIDC/SSO: Connettere con Keycloak, Authentik o qualsiasi provider OIDC
• Dominio personalizzato: Servire Docmost sul tuo sottodominio via Nginx
• Webhook: Attivare azioni esterne quando le pagine vengono create o aggiornate

Casi d’Uso

Wiki del Team di Ingegneria

Archivia decisioni di architettura (ADR), runbook di deployment, post-mortem degli incidenti e documentazione API. I blocchi di codice e le pagine annidate di Docmost rendono leggibile la documentazione tecnica.

Base di Conoscenza Interna

Policy HR, checklist di onboarding, manuale aziendale — tutto in un posto, con accesso in lettura per i dipendenti e accesso in modifica per le HR.

Documentazione di Progetto

Usa uno spazio per cliente o progetto. Condividi link in sola lettura con le parti interessate esterne o restringi l’accesso ai team interni.

Gestione Personale della Conoscenza

Una singola istanza Docmost può servire anche a una persona che vuole un Notion auto-ospitato — più economico e più privato di qualsiasi alternativa SaaS.

Consigli di Manutenzione

• Backup: Pianifica backup pg_dump giornalieri e archiviali fuori dal server (S3, Backblaze B2, ecc.)
• Aggiornamenti: Esegui regolarmente docker compose pull && docker compose up -d
• Monitoraggio: Usa Uptime Kuma (anche auto-ospitato) per gli avvisi di downtime
• Verifica risorse: Esegui docker stats periodicamente man mano che il team cresce

Scalare Oltre un VPS

Per la maggior parte dei team sotto i 100 utenti, un singolo VPS Hetzner o Contabo gestisce il carico comodamente. PostgreSQL è il collo di bottiglia; aggiornare a più RAM e storage NVMe risolve la maggior parte dei problemi di prestazioni.

Per altre guide sull’auto-hosting: selfhostvps.com/en/best/.