Pentru o instalare pe server, începeți cu exemplul oficial Docker Compose de la ownCloud ocis_fullpentru linia de documentație stabilă 8.2. Acesta include serviciul Infinite Scale, un proxy invers și servicii opționale de colaborare office; configurați domeniile, expeditorul SMTP și căile de date în .envfișierul său înainte de a rula docker compose up -d. Această configurare este concepută pentru o singură instanță și necesită DNS public și porturi accesibile pentru certificatele Let's Encrypt de încredere. Pentru o evaluare internă fără domeniu, urmați limitarea certificatului autosemnat descrisă mai jos.
Înainte de instalare
Această procedură respectă ghidul ownCloud Infinite Scale 8.2 production Compose , verificat pe 9 octombrie 2026. Ghidul vizează Ubuntu LTS 24.04 sau 22.04 cu Docker Engine și Docker Compose deja instalate. Recomandă cel puțin 4–6 GB de memorie. Serviciile activate implicit necesită aproximativ 2,4 GB de spațiu pe disc, înainte de a lua în considerare fișierele utilizatorilor, jurnalele, copiile de rezervă și creșterea viitoare.
Alegeți acest exemplu complet atunci când puteți gestiona DNS, reguli de firewall și o gazdă Linux. Include mai mult decât platforma principală de fișiere; pentru o evaluare fără domeniu, ownCloud spune că configurația utilizează certificate autosemnate.
- Gazdă: Ubuntu 24.04 LTS sau 22.04 LTS cu acces SSH și sudo.
- Rețea: un domeniu ale cărui înregistrări DNS necesare se rezolvă la adresa WAN a serverului; permite porturile TCP de intrare 22, 80 și 443 în firewall și în orice router din amonte.
- Software: Docker Engine și pluginul Compose. Pe Linux, Docker documentează instalarea prin intermediul depozitului său de pachete; după instalare, confirmați că Compose răspunde cu
docker compose version.
- E-mail: este necesară o valoare pentru
SMTP_SENDERca acest exemplu să înceapă. Finalizați celelalte setări SMTP dacă doriți ca notificările să fie livrate prin e-mail.
1. Instalați Docker Compose și pregătiți gazda
Dacă Docker Engine este deja prezent, instalați pluginul Compose folosind metoda pentru distribuția dvs. Linux din instrucțiunile oficiale de instalare Compose ale Docker . Pentru sistemele Ubuntu sau Debian unde este configurat repozitoriul Docker, comanda documentată a pachetului este:
sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version
Docker recomandă pluginul și docker composeformularul de comandă pentru instalările curente. Instalați Docker Engine conform instrucțiunilor oficiale Ubuntu, dacă este necesar.
Înainte de a descărca configurația, direcționați domeniul sau subdomeniile pe care intenționați să le utilizați către adresa IP publică a gazdei. Exemplul ownCloud necesită OCIS_DOMAIN; poate utiliza COLLABORA_DOMAINși ONLYOFFICE_DOMAINatunci când aceste servicii office sunt configurate. Numele DNS trebuie să corespundă valorilor din .env. Verificați dacă routerul dvs. redirecționează porturile 80 și 443 către această gazdă și dacă un firewall local le permite.
2. Obțineți exemplul oficial Compose
Folosește ocis_fulldirectorul din ramura exemplelorstable-8.2 oficiale de implementare ownCloud . Descărcați fișierul ZIP pe un computer cu un browser, transferați-l pe serverul headless cu [numele fișierului] și extrageți-l sub [numele fișierului], așa cum este descris în ghidul ownCloud.scp/opt/compose/ocis/ocis_full
Salvați fișierul curent .envînainte de a extrage o copie actualizată: ownCloud avertizează că fișierul poate fi suprascris. Rulați comenzile Compose din directorul proiectului.
3. Configurați domenii, certificate, e-mail și căi de date
Deschideți /opt/compose/ocis/ocis_full/.envîntr-un editor de text. Păstrați numele variabilelor și sintaxa exemplului și editați doar valorile care se aplică instalării dvs.:
- Setați
OCIS_DOMAINla numele de gazdă pe care îl vor introduce utilizatorii. Setați numele de gazdă Collabora sau OnlyOffice numai dacă aceste servicii sunt activate în exemplu.
- Pentru un server conectat la internet, comentați
INSECUREconform instrucțiunilor din exemplu. Nu lăsați setarea nesigură activată pentru utilizare publică.
- Setați
TRAEFIK_ACME_MAILla o adresă de e-mail pe care o controlați. Pentru testarea inițială a certificatelor, setați TRAEFIK_ACME_CASERVERla serverul de testare Let's Encrypt. Certificatele de testare nu sunt de încredere pentru utilizare normală; acestea ajută la testarea DNS și a accesibilității înainte de a solicita certificate de producție.
- Setați
SMTP_SENDER, chiar dacă nu configurați încă un retransmisor de e-mail funcțional. Ghidul oficial spune că implementarea nu va porni fără acesta. Adăugați gazda SMTP, portul, acreditările, autentificarea și setările de securitate atunci când sunt disponibile; fără celelalte setări de e-mail, instanța poate porni, dar nu poate trimite notificări.
- Verificați
OCIS_DOCKER_IMAGEși etichetele imaginii din exemplu. Nu schimbați aleatoriu canalele de lansare în timp ce urmați o instalare stabilă.
- Pentru un server de producție, luați în considerare atribuirea
OCIS_DATA_DIRși OCIS_CONFIG_DIRcătre căi de gazdă planificate pe spațiu de stocare cu capacitate și acoperire de backup suficiente. Setările implicite utilizează volume gestionate de Docker, care sunt convenabile, dar ownCloud notează că locația, instantaneele, backup-urile, restaurarea, resetarea și migrarea acestora depind de spațiul de stocare al gazdei Docker.
Restricționați accesul la server și la fișierul său de configurare. Un certificat autosemnat este potrivit doar pentru evaluare internă, nu pentru o implementare publică de încredere.
Din directorul proiectului, validați configurația îmbinată înainte de a porni containerele:
cd /opt/compose/ocis/ocis_full
docker compose config
Corectați erorile raportate de variabile sau YAML înainte de a continua. Această comandă redă configurația Compose pentru inspecție; nu dovedește că DNS, certificatele, permisiunile de stocare sau conectivitatea SMTP funcționează.
4. Porniți serviciile și finalizați configurarea certificatului
Porniți stiva în fundal:
docker compose up -d
Prima rulare extrage imagini și pornește serviciile, deci poate dura mai mult decât repornirile ulterioare. Verificați starea serviciului cu:
docker compose ps -a
Apoi, verificați jurnalele dacă un serviciu se închide sau adresa web nu se încarcă:
docker compose logs --follow
Începeți cu jurnalele Traefik. Erorile de certificat indică de obicei DNS și .envvalori nepotrivite, porturi 80/443 blocate sau o adresă de e-mail ACME nevalidă. Remediați cauza înainte de a încerca din nou. Nu utilizați docker compose down -vca resetare: aceasta elimină toate volumele proiectului, inclusiv datele.
Când verificările certificatelor de staging reușesc, urmați procedura de certificare ownCloud: opriți implementarea, eliminați doar volumul certificatului exemplului ( ocis_full_certs), ștergeți setarea CA de staging și începeți din nou pentru a solicita certificate de producție de încredere. Confirmați numele exact al volumului cu docker volume lsînainte de a-l elimina. Nu eliminați volumele de date sau de configurare.
Verificați accesul și protejați implementarea
Deschideți adresa URL setată în OCIS_DOMAIN. Un rezultat reușit înseamnă că browserul ajunge la pagina de conectare prin HTTPS fără un avertisment privind certificatul și docker compose ps -aafișează serviciile necesare care rulează. Conectați-vă folosind acreditările inițiale documentate de ownCloud ( admin/ admin, cu excepția cazului în care setați o parolă inițială diferită), apoi schimbați prompt parola de administrator.
Dacă site-ul nu este disponibil, verificați DNS-ul, redirecționarea porturilor, jurnalele ACME ale Traefik, apoi jurnalele serviciului Infinite Scale. Dacă autentificarea funcționează, dar notificările prin e-mail nu, verificați setările SMTP.
Înainte de a stoca fișiere importante, confirmați că backup-ul acoperă atât configurația, cât și datele. Volumele gestionate de Docker sunt convenabile pentru evaluare; căile explicite ale gazdei sunt mai ușor de plasat pe un disc separat și de inclus în backup-urile gazdei. Sunteți gata atunci când HTTPS este valid, serviciile rămân în funcțiune după repornire, autentificarea administratorului funcționează și backup-urile acoperă spațiul de stocare ales.