Voorkom dat de ONLYOFFICE-documentserver te weinig VPS-geheugen heeft.

Als ONLYOFFICE Document Server vastloopt of opnieuw opstart omdat uw VPS onvoldoende geheugen heeft, controleer dan eerst of er daadwerkelijk sprake is van een geheugenprobleem en of de geheugenlimiet van Docker te laag is. Zorg vervolgens voor voldoende fysiek RAM-geheugen voor de werklast en voeg swapgeheugen alleen toe als veiligheidsbuffer; herhaaldelijk de editor herstarten lost een aanhoudend capaciteitstekort niet op.

1. Bewijs dat geheugenbelasting de oorzaak is van de storing.

Start het proces op de Linux VPS, niet in de ONLYOFFICE-integratie-instellingen. Een browsermelding zoals "Document kan niet worden geladen" kan ook worden veroorzaakt door netwerkproblemen of authenticatieproblemen. Het is daarom belangrijk om vast te stellen of de Linux out-of-memory (OOM) killer daadwerkelijk een proces heeft beëindigd.

Voer deze commando's uit via SSH. Vervang onlyoffice-document-serverdoor de containernaam die wordt weergegeven door docker ps -a:

free -h
docker ps -a
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}} {{.State.ExitCode}} {{.HostConfig.Memory}} {{.HostConfig.MemorySwap}}' onlyoffice-document-server

free -hToont het beschikbare RAM-geheugen en swapgeheugen van de host. docker statsMeet een actieve container, terwijl de `inspect`-opdracht de status van de container (OOM-killed), de laatste exitcode en de geconfigureerde resourcebeperkingen in bytes rapporteert. Een HostConfig.Memorywaarde die niet nul is, geeft een expliciete geheugenlimiet aan. De geheugenstatistieken van Docker kunnen bepaalde bestandscaches uitsluiten, dus deze moeten worden vergeleken met metingen van de host in plaats van als een volledig beeld te worden beschouwd. Zie de Docker-statistiekenreferentie .

Als de container is gestopt, docker statskan de vorige piekwaarde niet worden weergegeven. Controleer in plaats daarvan het kernel-logboek en recente applicatieberichten:

sudo journalctl -k --since "-2 hours" | grep -Ei 'out of memory|killed process|oom'
docker logs --tail 100 onlyoffice-document-server

Kernelberichten met de vermelding "Out of memory" of "Killed process" helpen bij het identificeren van het betrokken proces. OOMKilled=trueDit is sterk bewijs voor een OOM-gebeurtenis (Out of Memory) in de container, maar falsesluit niet uit dat de hostkernel een childproces beëindigt terwijl de container actief blijft. Evenzo bevestigt exitcode 137 alleen een SIGKILL-beëindiging, niet de oorzaak ervan. Als er geen bewijs is voor een OOM-gebeurtenis, onderzoek dan de logbestanden en verbindingsfouten voordat u meer RAM aanschaft.

2. Geef de VPS voldoende RAM voordat je andere instellingen aanpast.

Vanaf oktober 2026 vermeldt de officiële README van ONLYOFFICE's Docker Document Server 4 GB of meer RAM en minstens 2 GB swap als aanbevolen vereisten. De aparte officiële documentatie voor de one-click installer geeft 4 GB RAM aan voor Docker-testomgevingen, beveelt 8 GB of meer aan voor productieomgevingen en specificeert minstens 4 GB swap als installatievereiste. Deze documenten beschrijven verschillende implementatiecontexten, dus interpreteer 4 GB niet als een garantie voor betrouwbare prestaties in een productieomgeving.

Als uw VPS slechts 1-2 GB RAM heeft, is het upgraden van het abonnement de meest verstandige oplossing voor een op Docker gebaseerde installatie. Als er al 4 GB is, controleer dan hoeveel ervan wordt gebruikt door het besturingssysteem, de database, de reverse proxy, Nextcloud en andere containers. Een server die inactief prima lijkt te presteren, kan nog steeds geheugenproblemen ondervinden wanneer meerdere gebruikers tegelijkertijd documenten openen of grote spreadsheets converteren.

Gebruik deze methode op een drukke server ps aux --sort=-rss | headom geheugenintensieve processen te identificeren en herhaal dit docker statstijdens een representatieve bewerkingssessie. Reserveer ruimte voor de rest van de machine in plaats van al het beschikbare RAM-geheugen uitsluitend aan ONLYOFFICE toe te wijzen. Als de aanhoudende vraag de capaciteit van de server overschrijdt, verplaats dan concurrerende services of upgrade de VPS; een aanpassing op applicatieniveau kan het ontbrekende fysieke geheugen niet compenseren.

Controleer op een onbedoelde limiet voor het Docker-geheugen.

Docker-containers hebben standaard geen harde geheugenlimiet, maar een implementatie kan er wel een instellen met Docker --memoryof Compose mem_limit. Een limiet van 2 GB voor containers kan bijvoorbeeld leiden tot geheugenproblemen (OOM kills), zelfs als een host 8 GB aan vrij RAM-geheugen heeft. Controleer de werkelijke limiet voordat u deze wijzigt. Als de limiet onnodig laag is, pas dan de oorspronkelijke Docker-run of Compose-configuratie aan naar een waarde die gerechtvaardigd is door metingen en de resterende capaciteit van de host. Zie de documentatie van Docker over resourcebeperkingen en de specificatie van de Compose-service .

Stel niet blindelings een onbeperkte geheugentoewijzing in op een gedeelde VPS: dit kan andere services blootstellen aan OOM-problemen (Out of Memory) op de hele host. Controleer ook --memory-swapde instellingen van Compose memswap_limit; Docker telt het gecombineerde RAM-geheugen en swapgeheugen mee in deze instelling. Gelijke limieten voor RAM en gecombineerd geheugen schakelen swapgeheugen effectief uit voor de container. Als u ONLYOFFICE beheert met Compose, breng de wijziging dan aan in het Compose-bestand, zodat de instelling behouden blijft na het opnieuw aanmaken van de container.

3. Voeg een swapbuffer toe als de VPS er geen heeft.

Swap kan een tijdelijke piek in het geheugengebruik opvangen, maar wordt op schijf opgeslagen en is veel trager dan RAM. Controleer swapon --showdit df -h /eerst. Het volgende voorbeeld voegt een swapbestand van 2 GiB toe aan een VPS met behulp van een compatibel lokaal bestandssysteem zoals ext4, wanneer dit bestand /swapfilenog niet bestaat en de provider swap toestaat:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
swapon --show
free -h

Maak het nieuwe swapbestand pas permanent nadat swaponde bewerking is geslaagd. Controleer of er al een vermelding bestaat met grep -F '/swapfile' /etc/fstab; als die er niet is, voeg deze dan eenmalig toe:

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Het aanmaken van swapbestanden op Btrfs, netwerkbestandssystemen en sommige andere configuraties vereist een andere aanpak. Voer deze commando's niet uit over een bestaand swapbestand en ga er niet vanuit dat fallocatehet overal werkt. De Linux swapon-handleiding legt de beperkingen van het bestandssysteem uit. Als de VPS regelmatig swapt onder normale bewerkingsbelasting, geef dan prioriteit aan meer RAM in plaats van een groter swapbestand.

4. Controleer de server opnieuw onder een realistische bewerkingsbelasting.

Het wijzigen van een VPS-abonnement of het inschakelen van swap vereist vaak geen aanpassing van de ONLYOFFICE-configuratie. Als u een Docker-implementatie-instelling hebt gewijzigd, plan dan onderhoud in en zorg ervoor dat de bestaande mounts, secrets, certificaatpaden en integratie-instellingen behouden blijven bij het toepassen van de wijziging. De README van ONLYOFFICE Docker documentserver-prepare4shutdown.shbeschrijft geplande afsluitingen en waarschuwt dat het loskoppelen van editors enkele minuten kan duren. Maak een actief gebruikte documentenserver niet zomaar opnieuw aan of herstart deze niet, omdat niet-opgeslagen wijzigingen hierdoor mogelijk worden beïnvloed.

Zodra de service gereed is, controleer dan of de container actief is en inspecteer het geheugen opnieuw:

docker ps --filter name=onlyoffice-document-server
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}}' onlyoffice-document-server
docker exec onlyoffice-document-server curl -fsS http://localhost:8000/info/info.json

De laatste controle maakt gebruik van het interne informatie-eindpunt dat wordt weergegeven in de officiële ONLYOFFICE Docker Compose healthcheck ; voer deze uit in de container, omdat poort 8000 mogelijk niet beschikbaar is op de VPS. Het reagerende eindpunt geeft de beschikbaarheid van de service aan, maar niet noodzakelijkerwijs dat elke opslagintegratie of opslagcallback werkt.

Controleer of het geheugenprobleem is opgelost.

Heropen een klein document en vervolgens een representatief groot document via uw Nextcloud-, ownCloud- of andere integratie. Sla een onschadelijke wijziging op en controleer of deze verschijnt na het heropenen van het bestand. Blijf de kernel OOM-logboeken in de gaten houden free -hgedurende docker statsde gebruiksperiode die eerder tot de fouten leidde.

Een succesvolle oplossing betekent dat documenten normaal blijven openen en opslaan, het geheugengebruik binnen de limieten van de VPS en de container blijft en er geen nieuwe OOM-fouten meer optreden. Als crashes alleen stoppen bij weinig activiteit, heeft de VPS nog steeds onvoldoende capaciteit voor piekbelasting; zorg ervoor dat het RAM-geheugen is afgestemd op die piekbelasting in plaats van te vertrouwen op continu swappen. Als er nog steeds voldoende RAM-geheugen beschikbaar is en er geen nieuwe OOM-berichten meer verschijnen, maar documenten nog steeds niet werken, richt het onderzoek dan op de ONLYOFFICE-logboeken, de reverse proxy of uw opslagconnector in plaats van verdere geheugenwijzigingen door te voeren.