From c193e6c206954b81be41af4c2abae1ba39a6ffd5 Mon Sep 17 00:00:00 2001
From: Ollieparanoid <Ollieparanoid@wiki.postmarketos.org>
Date: Tue, 25 Sep 2018 07:06:39 +0000
Subject: [PATCH] document that a 3.17 kernel is required currently, and link
 to debian backports (https://gitlab.com/postmarketOS/pmbootstrap/issues/1662)

---
 Troubleshooting:host.mw | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 Troubleshooting:host.mw

diff --git a/Troubleshooting:host.mw b/Troubleshooting:host.mw
new file mode 100644
index 000000000..e8698f107
--- /dev/null
+++ b/Troubleshooting:host.mw
@@ -0,0 +1,6 @@
+postmarketOS is based on Alpine Linux, and pmbootstrap uses Alpine chroots for the installation, building packages and basically everything else it does. This makes pmbootstrap fairly independent of the host system, however some issues might still arise.
+
+== Host system kernel is older than 3.17 ==
+As of writing (2018-09-25), the libressl version in Alpine requires at least Linux 3.17 or newer ({{issue|1662}}, {{albug|9419}}). libressl is used for example, when cloning from git repositories or when downloading source code in the preparation of building a package.
+
+If your host system is running a 3.16 or older kernel, consider upgrading the kernel. For example in Debian 8 (Jessie), you can [https://packages.debian.org/jessie-backports/linux-image-amd64 enable the backports] and install [https://packages.debian.org/jessie-backports/linux-image-amd64 a more recent kernel].
-- 
GitLab