Implementeer ONLYOFFICE Docs Enterprise met het officiële opstelbestand.

Voor een implementatie op één host gebruikt u de officiële Docker-DocumentServer-repository van ONLYOFFICE docker-compose.enterprise.ymlen start u deze met Docker Compose v2. Voordat u de stack online brengt, vervangt u de voorbeeldreferenties, stelt u een stabiel JWT-geheim in voor uw integratie en koppelt u de map waarin uw Enterprise-licentie en permanente gegevens worden opgeslagen. Een draaiende container is slechts de eerste controle: controleer de status van Compose en open de welkomstpagina van Docs voordat u verbinding maakt met een productieplatform.

Wat start het Enterprise Compose-bestand?

Het officiële bestand definieert de Document Server Enterprise-service plus de afhankelijkheden van PostgreSQL, RabbitMQ en Redis. Het publiceert de HTTP- en HTTPS-poorten van de editor en bevat een health check voor het interne eindpunt voor documentinformatie. Deze afhankelijkheden maken dit Compose-bestand handig voor een kleine installatie op één host; het configureert op zichzelf niet uw platformconnector, openbare DNS of een productie-TLS-certificaat.

Zoals gecontroleerd op 9 oktober 2026, gebruikt het officiële bestand PostgreSQL 15, RabbitMQ 3 en Redis 7. Repositorybestanden kunnen wijzigen, dus controleer het huidige Enterprise Compose-bestand vóór implementatie en upgrades.

1. Controleer de host en installeer Docker Compose.

De Enterprise Docker-vereisten van ONLYOFFICE vermelden een amd64 Linux-host met kernel 3.10 of hoger, Docker dat door de beheerders wordt ondersteund, minimaal 4 GB RAM, 40 GB vrije schijfruimte en minimaal 4 GB swapgeheugen. De aanbevolen capaciteit varieert echter afhankelijk van het aantal gelijktijdig geopende documenten en het documenttype. Beschouw deze cijfers daarom als een uitgangspunt en niet als een gegarandeerde capaciteit. Een productieomgeving met zwaardere workloads heeft mogelijk meer resources nodig.

Installeer Docker Engine en de Compose-plugin volgens de officiële instructies van Docker voor uw Linux-distributie. Controleer of beide commando's werken voordat u de repository kloont:

docker --version
docker compose version

Als de host een bestaande webserver heeft, controleer dan of poorten 80 en 443 beschikbaar zijn, of plan een reverse proxy en een andere poorttoewijzing aan de hostzijde. Het Compose-bestand start ook de database-, wachtrij- en cacheservices; deze moeten op het privé-Compose-netwerk blijven en niet als openbare poorten worden gepubliceerd.

2. Download het officiële Compose-bestand

Kloon de repository van ONLYOFFICE en ga naar de bijbehorende map:

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer

Controleer of dit docker-compose.enterprise.ymlaanwezig is. In de README van de repository staat dit commando voor de Enterprise Edition:

docker compose -f docker-compose.enterprise.yml up -d

3. Stel de inloggegevens, JWT en een permanente licentielocatie in.

Start de voorbeeldconfiguratie van Compose niet ongewijzigd op een host die met internet verbonden is. Het gepubliceerde bestand bevat voorbeeldgegevens voor de database en heeft expliciete JWT-waarden uitgeschakeld door middel van commentaar. Vervang het PostgreSQL-wachtwoord in zowel de databaseservice als de DB_PWDinstellingen van de documentserver door dezelfde sterke waarde. Houd de poorten voor de database, RabbitMQ en Redis privé.

Voor een integratie stelt u één stabiel JWT-geheim in de Document Server-service in en configureert u hetzelfde geheim in de ONLYOFFICE-connector van uw platform. Een eenvoudige aanpak is om de waarde in een lokaal .envbestand te bewaren dat u niet naar Git commit, en vervolgens variabelevervanging met Compose te gebruiken. Voeg deze vermeldingen toe aan het gedeelte met de Document Server-omgeving en pas de bestaande omgevingsindeling indien nodig aan:

- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}

Voer een lange, unieke waarde in .envals JWT_SECRET=.... Kopieer de letterlijke placeholder niet naar een live configuratie. ONLYOFFICE documenteert JWT als standaard ingeschakeld in Docs 7.2 en later met een automatisch gegenereerd geheim; het specificeren van uw eigen stabiele waarde voorkomt een mismatch wanneer de container opnieuw wordt aangemaakt. Zie de JWT-configuratiehandleiding .

Om Enterprise te registreren met een aangeschaft licentiebestand license.lic, koppelt u een hostdirectory aan /var/www/onlyoffice/Datade Document Server-service. Vervang bijvoorbeeld de anonieme data-mount door ./documentserver-data:/var/www/onlyoffice/Data, maak die hostdirectory aan en plaats het license.licbestand erin vóór het opstarten. Behoud de bestandsrechten en neem de directory op in uw back-upplan. De registratie-instructies voor Enterprise bevestigen dat het licentiebestand zich in een gekoppelde map moet bevinden voor Docker.

4. Start de Enterprise-stack

Valideer vanuit de repositorydirectory de Compose-configuratie op een stille manier, zodat uitgebreide geheimen niet worden afgedrukt, en start vervolgens de services. Stille validatie controleert het Compose-model; het bewijst niet dat de containers zullen starten. Docker beschrijft deze optie in de Compose-configuratiereferentie :

docker compose -f docker-compose.enterprise.yml config --quiet
docker compose -f docker-compose.enterprise.yml up -d

De eerste keer opstarten kan langer duren omdat de afbeeldingen moeten worden gebouwd of gedownload en de afhankelijkheden moeten worden geïnitialiseerd. Als de configuratievalidatie een niet-ingestelde variabele meldt, controleer dan uw .envbestand en de variabelenamen in het Compose-bestand. Plaats geen aanhalingstekens rond geheimen, tenzij ze deel uitmaken van de beoogde waarde.

5. Controleer of alles gereed is voordat u uw platform verbindt.

Controleer de beschikbare diensten en uw gezondheidsstatus:

docker compose -f docker-compose.enterprise.yml ps

Wacht tot de gezondheidscontrole van de documentenserver is geslaagd. Het officiële Compose-bestand voert deze controle http://localhost:8000/info/info.jsonvanuit de container uit, met een opstartperiode van 60 seconden. Als de service niet in orde is, controleer dan de logboeken en de status van de afhankelijkheden.

docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

Open de pagina vervolgens http://localhostop de host, of via de toegewezen URL in een browser die de server kan bereiken. De Compose-instructies van ONLYOFFICE gebruiken de welkomstpagina als eerste installatiecontrole. Voor gebruik in een externe productieomgeving kunt u de service via HTTPS op uw domein beschikbaar stellen in plaats van het editorverkeer via gewoon HTTP te laten lopen. Raadpleeg de handleiding voor Docker-poorten voor bedrijven en de installatiehandleiding voor Docker bij het configureren van netwerktoegang en TLS.

Configureer ten slotte de URL van de documentserver van uw platform en het bijbehorende JWT-geheim. Open, bewerk en sla vervolgens een testdocument op via die integratie. De welkomstpagina alleen bewijst niet dat de connector, reverse proxy, JWT of callback-URL correct is geconfigureerd. Als de services goed functioneren, maar de editor niet vanaf het platform kan worden geopend, controleer dan of het platform de Docs-URL kan bereiken en of beide zijden hetzelfde JWT-geheim en dezelfde header gebruiken. Voor een implementatie met meerdere hosts of een implementatie met hoge beschikbaarheid, beschouw deze Compose-stack als uitgangspunt en raadpleeg de implementatiehandleiding van ONLYOFFICE in plaats van ervan uit te gaan dat één Compose-host clustering biedt.