Installare ONLYOFFICE con lo script Docker automatico

Nota importante: assicurati che il server soddisfi i requisiti hardware e software indicati prima di avviare lo script. Il processo di inizializzazione può richiedere diversi minuti.

Novità principali

ONLYOFFICE Community Server 9.0

• Integrazione con DocuSign per firme elettroniche.
• Finestra di condivisione ridisegnata con generazione automatica di link brevi.
• Ripristino delle versioni precedenti dal Cronologia Versioni.
• Sezioni Attività e Discussioni dei Progetti ridisegnate, con più opzioni di navigazione.
• Copia di attività e sotto-attività.

ONLYOFFICE Document Server 4.3

• Aggiunta e modifica delle note a piè di pagina.
• Annulla (Undo) nella modalità di co-editing veloce.
• Supporto esteso per più lingue nel correttore ortografico.
• Nuove formule, stili di bordo e incolla speciale (Paste Special) nell’editor Foglio di calcolo.

Requisiti di sistema e dipendenze ONLYOFFICE

Requisiti hardware consigliati

• CPU: dual-core 2 GHz o superiore
• RAM: 6 GB o più
• Disco: almeno 40 GB di spazio libero
• Swap: almeno 6 GB

Requisiti software

• OS: distribuzione Linux amd64 con kernel 3.10 o successivo
• Docker: versione 1.10 o successiva

Nota: per ambienti di produzione con più utenti simultanei aumentare CPU/RAM e spazio disco in base al carico stimato.

Prima di iniziare: checklist rapida

• Backup dei dati importanti e snapshot del sistema (se applicabile)
• Host con accesso root o sudo
• Porta 80/443 aperte se esporrai il servizio su HTTP/HTTPS
• Nome a dominio registrato (necessario solo se vuoi installare il Mail Server)

Installare ONLYOFFICE

1. Apri il terminale (Ctrl+Alt+T su molte distribuzioni Linux).

2. Scarica lo script Docker automatico con wget:

wget http://download.onlyoffice.com/install/opensource-install.sh

3. Esegui lo script per installare ONLYOFFICE con gli editor di documenti online integrati:

bash opensource-install.sh -ims false

4. Se desideri installare anche il Mail Server, esegui lo script specificando il tuo dominio registrato:

bash opensource-install.sh -md "yourdomain.com"

Lo script avvierà i container Docker necessari e installerà le dipendenze richieste per far funzionare i server ONLYOFFICE.

Avviare e accedere al tuo ufficio web

Apri un browser web e digita l’indirizzo IP o il nome host del server. L’inizializzazione potrebbe richiedere alcuni minuti. Al termine, inserisci la tua e-mail e crea una password per accedere al tuo web office.

Controlli post-installazione

• Verifica che i container Docker siano attivi: docker ps
• Controlla i log dei container in caso di errori: docker logs
• Se installi il Mail Server, verifica i record DNS (MX, SPF, DKIM se configurati)

Quando l’installazione potrebbe fallire (controesempi e cause comuni)

• Docker non correttamente installato o versione troppo vecchia.
• Porta 80/443 già occupata da altri servizi (es. Apache/Nginx).
• Risorse insufficienti (RAM o swap troppo basse) durante l’avvio dei container.
• Problemi DNS se installi il Mail Server senza un dominio valido.

Approcci alternativi

• Installazione manuale dei singoli componenti (Community Server, Document Server, Mail Server) senza Docker: utile se vuoi controllo granulare sulle dipendenze e sui percorsi filesystem.
• Utilizzare immagini Docker ufficiali per ogni servizio e orchestrare con docker-compose o Kubernetes per ambienti di produzione scalabili.
• Usare una VM preconfigurata o appliance se preferisci evitare la gestione dei container.

Procedura rapida di troubleshooting (runbook di incidente)

1. Verifica lo stato di Docker: sudo systemctl status docker
2. Lista container: docker ps -a
3. Controlla i log del container problematico: docker logs
4. Riavvia il container: docker restart
5. Se il problema persiste, esegui lo script di installazione in modalità verbosa o consulta i log di sistema (/var/log/syslog o journalctl)
6. Se hai modificato i DNS per il Mail Server, attendi la propagazione e verifica con dig/nslookup

Checklist di accettazione dopo l’installazione

• Accesso all’interfaccia web tramite IP/hostname funzionante.
• Editor online (documenti, fogli, presentazioni) apribili e co-editabili.
• Moduli principali di Community Server accessibili (Persone, Progetti, CRM, Documenti, Calendario, Chat).
• (Se installato) Mail Server in grado di inviare/ricevere e-mail.

Ruoli e responsabilità (breve guida per team)

• Amministratore di sistema: installazione, aggiornamenti di Docker, backup e sicurezza dell’host.
• Amministratore ONLYOFFICE: configurazione server, gestione utenti, monitoraggio dell’applicazione.
• Responsabile sicurezza: gestione certificati TLS, hardening di rete e controllo accessi.

Hardening e sicurezza basilare

• Usa certificati TLS (Let’s Encrypt o certificati aziendali) per HTTPS.
• Non esporre porte inutili su Internet; usa firewall e regole IP per limitare l’accesso.
• Mantieni Docker e il sistema operativo aggiornati.

Glossario (1 riga ciascuno)

• Community Server: interfaccia collaborativa che include CRM, progetti, gestione documenti e comunicazione.
• Document Server: componenti che forniscono editor online per testi, fogli e presentazioni.
• Mail Server: componente opzionale per la gestione della posta elettronica.
• Docker: piattaforma di containerizzazione che esegue i servizi isolati.

Link utili

• Documentazione ufficiale e guide di installazione: https://helpcenter.onlyoffice.com
• Sito ufficiale e risorse: https://www.onlyoffice.org
• Supporto e forum di sviluppo: https://dev.onlyoffice.org

Suggerimenti per il deployment in produzione

• Considera l’uso di orchestratori (docker-compose, Kubernetes) per ridondanza e scalabilità.
• Esegui backup regolari dei database e dei volumi Docker contenenti i dati degli utenti.
• Pianifica aggiornamenti e finestre di manutenzione con rollback testato.

Breve annuncio (100–200 parole)

Abbiamo aggiornato la guida di installazione per ONLYOFFICE includendo le novità di Community Server 9.0 e Document Server 4.3. Lo script Docker automatico opensource-install.sh semplifica la distribuzione: scarichi lo script, lo esegui e i container con editor online e servizi necessari vengono creati automaticamente. Se preferisci gestire anche il Mail Server, esegui lo script con il parametro del dominio. Questa guida include controlli pre-installazione, checklist di accettazione, procedure di troubleshooting e raccomandazioni per la sicurezza. Ideale per amministratori di sistema e team IT che vogliono avviare rapidamente un web office self-hosted.

Riepilogo

ONLYOFFICE offre una suite collaborativa completa; lo script Docker automatico permette una installazione rapida e ripetibile. Verifica i requisiti, segui i comandi di download ed esecuzione, controlla i container e applica le best practice di sicurezza.