From df6c22e417432823cd06c789f7328b4ede453fa9 Mon Sep 17 00:00:00 2001
From: Jakob Moser <moser@cl.uni-heidelberg.de>
Date: Sun, 28 Feb 2021 13:51:29 +0100
Subject: [PATCH] Document out-of-RAM crash

---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/README.md b/README.md
index cfb9636..0f1aed0 100644
--- a/README.md
+++ b/README.md
@@ -86,6 +86,30 @@ Um zur Konsole des Minecraft-Servers zu gelangen (`papermc_papermc_1` muss ggfs.
 $ screen -r mc
 ```
 
+## :bug: Bekannte Probleme
+
+Es kann sein, dass nach `docker-compose up` der folgende Output erscheint (immer wieder wiederholend, die Nummern zählen dabei hoch, allerdings in unregelmäßigen Abständen):
+
+```
+Creating network "papermc_default" with the default driver
+Creating papermc_papermc_1 ... done
+Attaching to papermc_papermc_1
+papermc_1  | No screen session found.
+papermc_1  | There is a screen on:
+papermc_1  |    17.mc   (02/28/21 11:58:36)     (Detached)
+papermc_1  | 1 Socket in /run/screen/S-papermc.
+papermc_1  | No screen session found.
+papermc_1  | There is a screen on:
+papermc_1  |    26.mc   (02/28/21 11:58:42)     (Detached)
+papermc_1  | 1 Socket in /run/screen/S-papermc.
+papermc_1  | No screen session found.
+...
+```
+
+In diesem Fall stürzt der Minecraft-Server immer wieder ab und wird direkt danach neu gestartet. Mögliche Gründe dafür sind:
+
+* Die Java-VM versucht, mehr RAM zu benutzen, als sie kriegen kann und stürzt daher ab. In dem Fall muss man sowohl den `MC_RAM` als auch den Java-Parameter anpassen.
+
 ## :scales: Sonstige Anmerkungen
 
 > This project *does **NOT** redistribute the Minecraft server files*. Instead, the (very small) script that is inside of the image, `papermc.sh`, downloads these files from their official sources during installation.
-- 
GitLab