Installa ownCloud Infinite Scale con Docker Compose

Per un'installazione server, inizia con ocis_fulll'esempio Docker Compose ufficiale di ownCloud per la versione stabile 8.2. Include il servizio Infinite Scale, un reverse proxy e servizi di collaborazione Office opzionali; configura i tuoi domini, il mittente SMTP e i percorsi dati nel relativo .envfile prima di eseguirlo docker compose up -d. Questa configurazione è progettata per una singola istanza e richiede DNS pubblico e porte raggiungibili per certificati Let's Encrypt attendibili. Per una valutazione interna senza dominio, segui la limitazione relativa ai certificati autofirmati descritta di seguito.

Prima di installare

Questa procedura segue la guida di ownCloud per la configurazione di produzione di Docker Compose su Infinite Scale 8.2 , verificata il 9 ottobre 2026. La guida è pensata per Ubuntu LTS 24.04 o 22.04 con Docker Engine e Docker Compose già installati. Raccomanda almeno 4-6 GB di memoria. I servizi abilitati di default richiedono circa 2,4 GB di spazio su disco, senza considerare i file utente, i log, i backup e la crescita futura.

Scegli questa versione completa se puoi gestire DNS, regole firewall e un host Linux. Include più della semplice piattaforma di file di base; per una valutazione senza dominio, ownCloud afferma che la configurazione utilizza certificati autofirmati.

• Sistema host: Ubuntu 24.04 LTS o 22.04 LTS con accesso SSH e sudo.
• Rete: un dominio i cui record DNS richiesti si risolvono nell'indirizzo WAN del server; consentire le porte TCP in entrata 22, 80 e 443 nel firewall e in qualsiasi router a monte.
• Software: Docker Engine e il plugin Compose. Su Linux, Docker documenta l'installazione tramite il suo repository di pacchetti; dopo l'installazione, verificare che Compose risponda con docker compose version.
• Posta: per avviare questo esempio è necessario inserire un valore SMTP_SENDER. Completa le altre impostazioni SMTP se desideri ricevere le email di notifica.

1. Installa Docker Compose e prepara l'host

Se Docker Engine è già presente, installa il plugin Compose utilizzando il metodo per la tua distribuzione Linux descritto nelle istruzioni di installazione ufficiali di Compose per Docker . Per i sistemi Ubuntu o Debian in cui è configurato il repository di Docker, il comando di installazione del pacchetto documentato è:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Docker consiglia il plugin e la docker composeriga di comando per le installazioni correnti. Se necessario, installa Docker Engine seguendo le istruzioni ufficiali per Ubuntu .

Prima di scaricare la configurazione, punta il dominio o i sottodomini che intendi utilizzare all'indirizzo IP pubblico dell'host. L'esempio di ownCloud richiede OCIS_DOMAIN; potrebbe anche utilizzare COLLABORA_DOMAINe ONLYOFFICE_DOMAINquando questi servizi per ufficio sono configurati. I nomi DNS devono corrispondere ai valori in .env. Verifica che il tuo router inoltri le porte 80 e 443 a questo host e che un firewall locale le consenta.

2. Scarica l'esempio ufficiale di Compose

Utilizza la ocis_fulldirectory dal stable-8.2ramo degli esempi di distribuzione ufficiali di ownCloud . Scarica il file ZIP su un computer con un browser, trasferiscilo al server headless scpe estrailo nella directory /opt/compose/ocis/ocis_fullcome descritto nella guida di ownCloud.

Salva la versione corrente .envprima di estrarre una copia aggiornata: ownCloud avverte che il file potrebbe essere sovrascritto. Esegui i comandi Compose dalla directory del progetto.

3. Configurare domini, certificati, email e percorsi dati

Apri il file /opt/compose/ocis/ocis_full/.envcon un editor di testo. Mantieni i nomi delle variabili e la sintassi dell'esempio e modifica solo i valori che si applicano alla tua installazione:

• Imposta OCIS_DOMAINil nome host che gli utenti inseriranno. Imposta i nomi host di Collabora o OnlyOffice solo se questi servizi sono abilitati nell'esempio.
• Per un server esposto a Internet, commentare le parti INSECUREcome indicato nell'esempio. Non lasciare attiva l'impostazione di sicurezza per l'utilizzo pubblico.
• Imposta TRAEFIK_ACME_MAILun indirizzo email di cui hai il controllo. Per i test iniziali del certificato, imposta TRAEFIK_ACME_CASERVERil server di staging di Let's Encrypt. I certificati di staging non sono considerati affidabili per l'uso normale; servono per testare il DNS e la raggiungibilità prima di richiedere i certificati di produzione.
• Imposta questa opzione SMTP_SENDER, anche se non hai ancora configurato un server di posta funzionante. La guida ufficiale afferma che l'implementazione non si avvierà senza di essa. Aggiungi l'host SMTP, la porta, le credenziali, l'autenticazione e le impostazioni di sicurezza quando disponibili; senza le altre impostazioni di posta, l'istanza può avviarsi ma non può inviare notifiche.
• Esaminate OCIS_DOCKER_IMAGEi tag delle immagini nell'esempio. Non cambiate canale di rilascio casualmente mentre state eseguendo un'installazione di una versione stabile.
• Per un server di produzione, è consigliabile assegnare OCIS_DATA_DIRi OCIS_CONFIG_DIRpercorsi host pianificati su storage con capacità sufficiente e copertura di backup. Le impostazioni predefinite utilizzano volumi gestiti da Docker, che sono pratici, ma ownCloud fa notare che la loro posizione, gli snapshot, il backup, il ripristino, il reset e la migrazione dipendono dallo storage dell'host Docker.

Limitare l'accesso al server e al suo file di configurazione. Un certificato autofirmato è adatto solo per valutazioni interne, non per una distribuzione pubblica affidabile.

Dalla directory del progetto, convalida la configurazione unita prima di avviare i container:

cd /opt/compose/ocis/ocis_full
docker compose config

Correggi gli errori segnalati nelle variabili o nel file YAML prima di continuare. Questo comando visualizza la configurazione di Compose per consentirne l'analisi; non garantisce il corretto funzionamento di DNS, certificati, permessi di archiviazione o connettività SMTP.

4. Avviare i servizi e completare la configurazione del certificato

Avvia lo stack in background:

docker compose up -d

La prima esecuzione scarica le immagini e avvia i servizi, quindi potrebbe richiedere più tempo rispetto ai riavvii successivi. Verifica lo stato del servizio con:

docker compose ps -a

Controlla quindi i log per verificare se un servizio si arresta o se l'indirizzo web non si carica:

docker compose logs --follow

Iniziate dai log di Traefik. Gli errori relativi ai certificati indicano spesso discrepanze tra DNS e .envvalori, porte 80/443 bloccate o un indirizzo email ACME non valido. Risolvete la causa prima di riprovare. Non utilizzatelo docker compose down -vcome ripristino: rimuove tutti i volumi del progetto, inclusi i dati.

Quando i controlli del certificato di staging hanno esito positivo, seguire la procedura di certificato di ownCloud: interrompere la distribuzione, rimuovere solo il volume del certificato di esempio ( ocis_full_certs), cancellare l'impostazione CA di staging e riavviare per richiedere certificati di produzione attendibili. Confermare il nome esatto del volume docker volume lsprima di rimuoverlo. Non rimuovere i volumi di dati o di configurazione.

Verificare l'accesso e proteggere l'implementazione

Apri l'URL specificato in OCIS_DOMAIN. Un risultato positivo significa che il browser raggiunge la pagina di accesso tramite HTTPS senza avvisi relativi al certificato e docker compose ps -amostra i servizi richiesti in esecuzione. Accedi utilizzando le credenziali iniziali documentate da ownCloud ( admin/ admin, a meno che tu non abbia impostato una password iniziale diversa), quindi cambia subito la password dell'amministratore.

Se il sito non è disponibile, controlla il DNS, il port forwarding, i log ACME di Traefik e infine i log del servizio Infinite Scale. Se l'accesso funziona ma le notifiche e-mail no, controlla le impostazioni SMTP.

Prima di salvare file importanti, verifica che il backup includa sia la configurazione che i dati. I volumi gestiti da Docker sono comodi per la valutazione; i percorsi host espliciti sono più facili da posizionare su un disco separato e da includere nei backup dell'host. Sei pronto quando HTTPS è valido, i servizi rimangono in esecuzione dopo il riavvio, l'accesso amministratore funziona e i backup coprono lo spazio di archiviazione scelto.