From ef949be79fa3d8ff9b4a74f4dc385da6d8a70d89 Mon Sep 17 00:00:00 2001
From: Nils154 <39034873+Nils154@users.noreply.github.com>
Date: Tue, 26 Jan 2021 05:00:16 -0600
Subject: [PATCH] Update troubleshooting.markdown (#16227)

* Update troubleshooting.markdown

added suggestion to increase swap memory if your system freezes during first run

* Update troubleshooting.markdown
---
 .../installation/troubleshooting.markdown     | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/source/_docs/installation/troubleshooting.markdown b/source/_docs/installation/troubleshooting.markdown
index b52b171ced0..991ab732d6c 100644
--- a/source/_docs/installation/troubleshooting.markdown
+++ b/source/_docs/installation/troubleshooting.markdown
@@ -43,3 +43,22 @@ For `iptables` systems (was the default for older distributions):
 iptables -I INPUT -p tcp --dport 8123 -j ACCEPT
 iptables-save > /etc/network/iptables.rules  # your rules may be saved elsewhere
 ```
+
+### System freezes
+
+On small systems (such as a Pi2), not directly sypported by binaries (Python Wheels) you may run out of memory.
+Upon the first run or after an upgrade, Home Assistant uses a lot of resources to (re)compile all the integrations. 
+If you run out of memory and/or swap memory, your system will freeze.
+Increasing swap memory can help:
+
+```bash
+sudo dphys-swapfile swapoff
+sudo nano /etc/dphys-swapfile
+```
+
+Modify the line the sets the swapfile size. Set it equal to your memory or double your current setting: `CONF_SWAPSIZE = 925` then:
+
+```bash
+sudo dphys-swapfile swapon
+sudo systemctl restart dphys-swapfile.service
+```