From dd5747d4f5d9be3310a50d22feb1f699dc12f5a3 Mon Sep 17 00:00:00 2001
From: DL6ER <dl6er@dl6er.de>
Date: Wed, 27 May 2020 19:10:07 +0200
Subject: [PATCH 1/9] Update build instructions for cmake-based compilation.

Signed-off-by: DL6ER <dl6er@dl6er.de>
---
 docs/ftldns/compile.md | 67 ++++++++++++++++++++++++++++++------------
 1 file changed, 49 insertions(+), 18 deletions(-)

diff --git a/docs/ftldns/compile.md b/docs/ftldns/compile.md
index 1aecf47..1389603 100644
--- a/docs/ftldns/compile.md
+++ b/docs/ftldns/compile.md
@@ -1,51 +1,82 @@
 We pre-compile *FTL*DNS for you to save you the trouble of compiling anything yourself. However, sometimes you may want to make your own modifications. To test them, you have to compile *FTL*DNS from source. Luckily, you don't have to be a programmer to build *FTL*DNS from source and install it on your system; you only have to know the basics we provide in here. With just a few commands, you can build *FTL*DNS from source like a pro.
 
-#### Installing the Required Software
+## Installing the Required Software
 
 First, we'll install the basic software you'll need to compile from source, like the GCC compiler and other utilities.
 Install them by running the following command in a terminal:
 
-##### Debian / Ubuntu / Raspbian
+**Debian / Ubuntu / Raspbian**
 
 ```bash
-sudo apt install build-essential libgmp-dev m4
+sudo apt install build-essential libgmp-dev m4 cmake
 ```
 
-##### Fedora
+**Fedora**
 
 ```bash
-sudo dnf install gcc gmp-devel gmp-static m4
+sudo dnf install gcc gmp-devel gmp-static m4 cmake
 ```
 
----
+### Install `libnettle`
 
-You'll also need to compile `nettle` as *FTL*DNS uses `libnettle` for handling DNSSEC. Compile and install a recent version of `nettle` (we tested and recommend 3.6):
+*FTL*DNS uses a cryptographic library (`libnettle`) for handling DNSSEC signatures.
+Compile and install a recent version using:
 
 ```bash
 wget https://ftp.gnu.org/gnu/nettle/nettle-3.6.tar.gz
-tar -xvzf nettle-3.6.tar.gz
+tar -xzf nettle-3.6.tar.gz
 cd nettle-3.6
-./configure
-make
+./configure --libdir=/usr/local/lib
+make -j $(nproc)
 sudo make install
 ```
 
-#### Get the *FTL*DNS source
+Since Ubuntu 20.04, you need to specify the library directory explicitly. Otherwise, the library will be installed in custom locations where it would not be found by `cmake`.
+
+## Get the source
 
 Now, clone the *FTL*DNS repo (or your own fork) to get the source code of *FTL*DNS:
 
 ```bash
-git clone https://github.com/pi-hole/FTL.git
-cd FTL
+git clone https://github.com/pi-hole/FTL.git && cd FTL
 ```
 
-If you want to build another branch and not `master`, use checkout to get to this branch (e.g. `git checkout development`).
-
-*FTL*DNS can now be compiled and installed:
+If you want to build another branch and not `master`, use checkout to get to this branch, like
 
 ```bash
-make -j $(nproc)
-sudo make install
+git checkout development
+```
+
+## Compile the source
+
+*FTL*DNS can now be compiled using either the build script
+
+```bash
+./build.sh
+```
+
+or manually
+
+```bash
+mkdir -p cmake && cd cmake
+cmake ..
+cmake --build . -- -j $(nproc)
+```
+
+Note that both ways are exactly equivalent and that you do not need `root` priviledges here.
+
+## Install the new binary system-wide
+
+Install the new binary using either
+
+```bash
+./build.sh install
+```
+
+or
+
+```bash
+cd cmake && sudo make install
 ```
 
 Finally, restart *FTL*DNS to use the new binary:

From 9b9b331dfac1a701a97648577846dda7f35a3198 Mon Sep 17 00:00:00 2001
From: XhmikosR <xhmikosr@gmail.com>
Date: Sat, 6 Jun 2020 21:46:03 +0300
Subject: [PATCH 2/9] Update compile.md

---
 docs/ftldns/compile.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/ftldns/compile.md b/docs/ftldns/compile.md
index 1389603..6b02966 100644
--- a/docs/ftldns/compile.md
+++ b/docs/ftldns/compile.md
@@ -5,13 +5,13 @@ We pre-compile *FTL*DNS for you to save you the trouble of compiling anything yo
 First, we'll install the basic software you'll need to compile from source, like the GCC compiler and other utilities.
 Install them by running the following command in a terminal:
 
-**Debian / Ubuntu / Raspbian**
+### Debian / Ubuntu / Raspbian
 
 ```bash
 sudo apt install build-essential libgmp-dev m4 cmake
 ```
 
-**Fedora**
+### Fedora
 
 ```bash
 sudo dnf install gcc gmp-devel gmp-static m4 cmake

From 7633b1e846f40a4a5158aba631b9aeac55fbfae4 Mon Sep 17 00:00:00 2001
From: Adam Warner <me@adamwarner.co.uk>
Date: Sun, 7 Jun 2020 12:05:57 +0100
Subject: [PATCH 3/9] add info box about OS compatibility check

Signed-off-by: Adam Warner <me@adamwarner.co.uk>
---
 docs/images/OSWarning.png  | Bin 0 -> 9443 bytes
 docs/main/prerequisites.md |  14 ++++++++++++++
 2 files changed, 14 insertions(+)
 create mode 100644 docs/images/OSWarning.png

diff --git a/docs/images/OSWarning.png b/docs/images/OSWarning.png
new file mode 100644
index 0000000000000000000000000000000000000000..84cf98c8275d91232ba99b4844067b27dc8ab29a
GIT binary patch
literal 9443
zcmb7qdpOho|9&N@6z@VJZJm>foMLmBa*9F=iP$<i#+)XGt&(GzB#B{Ij&sV{FqTu8
z!<;5^$Z2fObDYy}dVdb@@9+A3|M=~X?YZandfoTqz90AFd0o2}eAiI-@Imo|yLRn5
ztanT6-mYCd1n#<IKM(i$^o>T=u3dXJ@7^)d1^@t5Dir|0V2D(lIe<u|P$@Vn5n~Pj
zP;llr3U>*}-1&mJo}M1}Jpdp%f9FneT@!$N0X37ty_m|~L;%cj<!1pH?%nE=%XT*F
zo&$l@+T4+AX90k-^EYHOUr7Q?BT>m^bxqVVY6U6cPTM5_hzk$63IN&%5^Jb+MF0S(
z?e?8{T@@VwKu=v-$2S=O(5flTOsJzKg6^0{mT}1eK|!H#_3|6H{Y@mD000#C24}9>
zCVUSm;u1-yOR$%g1SO%g0Frvtq7Svy8Y;EyGRS0JU(+|GhDs??m%j3$s1YFvxD#I7
zc3T4!@Qqp&0=NX42VF{Vx>XdS6<<a@^&%<K93ZW3a{g&70HBY$cB8Jbj9Nx4tECoE
ztGPHtf0JBl^@#rMXCb*Y1cV9ratIuRdwvCn0$^~tpsOHtJ-7)Xp)Aq_Us99%o$7B6
zz#&ZRak<y;A#%?F{Xqa69AM&)!(rg1wRP1OfC<k4qqlDu0s!z+0Dxg+BoJ^30I=5s
ze9WPAUj{zIl~Lk@sCDIBPKNd<N`id?g$j`LPCE^#$-q!^1JtFtCUVt#0s^T6F2PZf
zfJ7ib%h(=<2uMasQoe;LO9DPC-5S4ssX^~HBDt;zhiJ%+xaok)3WWRTQuBxj)UqgI
zW5WjoEIc7s5=H#rkH~zbRTTN`{B7S4cK|qh4W_;x0$&EW9olnS_c8c<yu50Tsvbbn
zAA$Rj2GSkWP*Of4-7kGQvV^LA>Ks7FrVxDd9snqbA=(??B4R+vuS|+Qm=MVgW|x$|
zYu_2w0VUYOLog;E3_<g1S8l3Y*3%0q3|1z-i%5@(r{GYRRdhih6E$`FS5gX*hJcV~
z(ga6f0_qt+67)h!Sx;BB;mWldjav!!A(Xf$SByVkWi=3n(%27$7=KiLgx{UZfQS%#
z3N^Rw<}GV<D(;E(r)#Q-$~uqyvy&=`cL9Jf7eELRcLSx#$Bjdxp4JT$&)%ti2;z*c
zMBV)FPq$)49=;F?7CzSY8uw62>2ouG&js)$r~c=WjZ63Un+q2dnAFYgJ|Na`{btID
zrShemys7WczgkB9w6d<FTFa346PlUp;bV^j;|AMRV;*n!obhh)X4&m759V5FVX+I5
zgzSgk=I3T{SC!IQvPS{UW!LoxMY)47_KET4g}&dj^U3uLTSukJZ;HrWnQ-KAp&9rB
zY^~5SN#NBIu7uLK9BJ(3h)d&n#N!DQ{-F>r$}1Pj(B8dsVf3llXtS#;Z9HOHI<H@x
zC1@0dLwEM8bcB%(zrCQRc)l|<{<Ru)OCS}_l}qk?{=Yp=F^Y;0`hWMXF!x>2Oq?5e
z`6LuQ)2o(cxCYma-n<isr1NbF78RrWey&-OCDj0pLFk{{^@v#ntvwL6N?aHeyvup8
zWgj4|YnUYy=A-CZ{yV&4(2V&7Ef=ENH-M^)y@4Oae^D1}gzVd%SwC#OSaaCg%*o8M
zi`1OoCoRU?E+=(trM9E&^{s}9E$3m+Y0m+6%FQXD?)-;MKJ4Z7k^9Z>etS<ptdB18
z(RF?PvvOl%lbJQ57IP?4`q{=x-O_||z<^O`KJzW`<&<(Y0h4W{6MpsrA^BZBr0<L(
z0p`1Pg;C~zLZNj}9PK#<UT6>d^c1`_ta_Ji*)!<#;U_2uX=4=Ma<?gJiO44s-8J46
zmb`2{aun&L(^38Nxl*#am^S*$`w)L)yRSBjXh7C!qv7oy2RT&b<qUjEMkIt*E?Ix*
zgiLo*@;m4FSQC99>SpW(In<S7XJ<*iX<<a}%`(CB485!!Vwc6T-W9xO-YN2#1%Iiu
zWa+RI?8mm|JyyRzvn{=k#1e8s7NX*yYYXhGSpk#EUT$Tqw}H3PTUVf?O^p^S*|?9i
z^u}kg$?Mg&-iQs(dyn3-#82<<f9AvWikXf~f$f9(xi~5p2(9&Oz2wI>i%-OPO>Gq1
znF2}E_jR+7-WjG2{gLl8z}AOx$~MA|6GPFP!!8Zrc?+eVtrnuC1o>X(-Xulohhie@
zg-#<s54-CC8_V)#3h_05Cxivd=VGA<ua-2MIQa~g@G*iLc<jl%oQt9EG@NrhwmDwc
zaXmI%JSxp?M3?bC6Wt<q8so0hTJ5GPs2K-!J6z+^^!=F$dcKS$ljEW_sEhx;5|vfD
z{6sqC%Em<R51YaH?DhE)mtjBvGg&6A!zm3`h!?k^L+P-4%n0acAT=#sN3-cYxfiWn
zyldbU30@2iV&qPst>g}FG!JxD*_hs+XUM%ZaGv6gJ~QQ)SQU_aouaO>CLVJFH~jss
zR!Xp(tOEaKiv5tdy?v5=q?|(K$EuLd#3yU7lUCO*%PSh6E&Q67cV&8nUb-@aX&G=U
zT@V=Xz1Fgw`m3K2&&IT{%U8As7``*UGn3bUl&be(U{SIcaLy5SosX^^KeW$}(#8&_
ziTVv8VAMX3;VPp=C!<hbInzxh!|n6!-BK-IP~f9AVanh=RN{K+rm6%YX84-B^sTe1
zeV6+L>*=}`*sCpZ{W)+0t$NMjuKBM=U-rIMe!{|CCpdKn70lg(r23~CZyqiSwQ939
zG;ljm)PI8@p)2K*dXiM>?t89{xLm4owLFDZAtY8Dw&bc*!o%nNc2n?s_jAkZ^b;?W
z-0-T;zDBJJ$z91xk74ZjRraX#g&BO<wBil}i&%+1o4&Zt@E!<_p5yrvCiOu!s#6ft
zJ@HmXa2cyc3hmEnn6drjRvz^9E=Ar;CacwIst(i47TCVZd<^Mvk*Mh2-Z<LoE$$P(
zx%p!{*}q~^<(#qs6zlOC=rS?VZgj3KVqGCg!Y7F5VFA!Z5;keGYkAIWS_5(|Y$ohL
zpr;q6zZlQ|x@5Aw^4GR&>ArO-ff*YKCHFmYu6Po<x2=H*)*th-LC>66mvPIlHvlsO
zfGXRl55>*AUp#Jt5N=Lct88Ak$pF@?H?1uaDvO>kUB?`4@C*43+<IC|cPBy9fm@lh
zFwr|;CYvx`xU@2T7pr`vJ|TmVYPG(R<=byYM)gobH7i3=LwqV&g4uS*jPlGI_%-}M
zswXVj<A$-N^z<3@q>Qh`5)A~{H8!Lv(UY_pq{()L@Z<(o+VgQ<d%0se@AtED-vAE6
z^O4zBTJXy}^hfae*XTMI&5Nf--X489mo@+m1sKl=Y);s6o}I7?QiAO-781?=eKqdr
zqA@G@*T6IV^EU5)G?b*&92w$!Wn?G3ln+rrRcUbY-8rHKCmWAk96qk#zL20Eop0o<
zjwa3B?Bs#;oEA9fQ`dNXX~K8#EgA8EAgNncptI!CxuUaNH_pBei3@d|J1y{nhOSBU
zqP1p=a2Y%CadxYcAWZA#gu$lj1n641bwoBkVf$Ooum*&${%{;mto)JCmi=R{bGc0z
zXPb6;L7r}_a}PPe!W$h#Ol1|I@<Jq#-B9{Q7I_!4&bPgHCO(V|HoTM?cYVGsSZISW
zV<GnuyP~N!=XbLHh>0YZT<=or`~V47aNEHIsOzh+@xZN1y{QCJ6{ws$w#<jo;&Pi%
z>ZyhoYjSQlm~i@vd4cu1^tSfGnqXfMK8_fd)vGwWPOJHTpn&@L88Ws#aP=HwMDbwd
zgHZBE15bzN?{$I~YF>PQyu;%pR#O4hpV3!ry`6#4BII_6^Wq1L+9zswEoFL>6*IyJ
z<SiJ{<1Sz!ISu+-8$uW?&_SxS3C@e3JYp;Cb95!k_oB3A3m%X4Qw$jizy`LbiL=NP
zJ{v(~o3#~NM{RQTb#x{_#P)=bvYGp)Tz9ki2`tjcRj%%s%HQa{4nXmNW}pO3a_TR>
zmgjSmn_s_4J92Yj7s?z-lPUA)?~bu<H*^54{>4{h3vn=+uM0)~&gpxN4(dn)u=Ibi
zx3>hup1|uV;<YZC^*oGgz6Z_FO`sQcPQS5_q~DAK4AT=k4zo#t*-3)$ifJIi+V9vS
z>)}OiQN_Or@{0wv;hb80iiOn73PZBacd~@tqQ<wCs|gy`l2CpraJ*z<ivRQbslc6{
zuc27%!VloP!8Rr;PVL0oQl+p0{*53_AcK?Qn1j<Ebd=-+4p$wU)|H4+a%$PXMLIdb
zH#f0$*G=ar(CT#sEiY%}QRr|<;s`|?ITA>l{rKpew+!z}iL=1=t@<z1tf1oGYOkY?
zY0Xpw!TT2-CTC8udGohmpR?f`{ZHLC{XtJ#!2L}s8}H@<|Frp#o6XkRz_-f2SpWa<
z>t%S$5N*6n5w|OBMOTjms$)6JeJ}fJpo`6K|JC8Nv|;UkMzRey(`0GZ*IN3SgIhsL
zOzg~+({g!FK9fT0u3z<WDvlZmHS7{_ac`XV&XyrV+B;;*CS=&;J><x)-A1V6;9au#
z&8L`BU|+%9wA{IPlWDLi!34h2Jz+H)ujWR0Z_10Yock(2b>zpb{FL@)x|oam=u>B_
zESfide&d_#r&b5)m)!H=U&qA%=ZmJ&zJ;iC)kqhQJq?*3x?lS2$73(5Z>Nuk>M9Io
zbP6GW^euq~KmDb`KzMJfmt|Q)pIv(tMzLnzz-jhofaocuwO_3J;^*Dp>WsL7>iPnw
zXC-b~PS4U;CBm!2Zk;>YReOHs>4BR+U%IN_n-V<+E>1rWbuV;FJ!ast7d%6FAOU=#
zXELao+(q8MMdf>|`eOFD;P&gOs3i3{;zCkfF@#~P`3n}fd#lgPfZ+X3hu^9pg}INO
zq0>!Ge|{V2o13Yp0Iom(o062WP<Pef+3an*gB$)bdp#e`zDi%|_qp5PkO`e5NN|rX
z<xp3^-4<f{!tI5!tjB>qpCknp6ypaqTE~9)HF(LK2VSb^G+zkblP2mDq|0D+dVxe_
z7_`oEFvc!p4fNBn7_xWyx6#tdGW&h=E}4Zl!~I>kn(9VlGE4rC)E6(VR)x71KrVzi
zcs59E{gTL{#Xd~)q59Ukh@V$^5r{Y~w8{_PKUWn$Uy;;+O;8AN9q-x<-P)7V9Y{xf
zw6FfGHGE{)E^@k(DfIkscHkQYDK8Bd-j22N;by`fKXe<$M$aD=@gAjU4K$7Ve5DUG
ztL|d*0*9e%U?j}2`JHM^j2T15Ko*kPGr1i22)0Uh1WYqvz58IJyxIc$drsq1m+AB)
zbBPcNANmtv6CCD{rxO-r>u&E`5^8HwU^bAE%oh?P;b5|Q^A+E6)g0qsTzA?h{+t=a
zViXzsu{va!S|63CGs&^q8V`v_1)mSqhw1x_gDcOuUY%4;ki59Qatit_Y9&z~lEAj!
zW0Es>L*+?WR!dX5SGcY*o4JvkKE@DM=|_udc$UT$e){QL<ij{EBk6jHBCw`fSlKPP
z+J+zEfi#wG(p0mPXi5*IMM5w5Xb{{!V#4kVx>V&~?GjYHb7B3n*5hE?zgfDTTsHWs
zKIi83gQzIADbh93Oa>{$xV^*lqZ8Ve?##_Xna6BR#sq6G0-AXm$9Pn89z}O7f8;Y>
zjSg&y(;jm9Tf)*^|B$fX4sDnP?Lv#b@p6gXmzvYjCR|SSkA0h~xg|WEqj>P&PQw{4
z2J!MF1!D!29U8smrqaeu^?@)Iio-+ZCMYG(;OgPFv^l%b?=ZVhEFMTyV7UdM9S#jW
zR(4%H&H_ItTfcN?N`vqbV&Y)P*ew!zf78v$t+ZW|L3!UL=_&CFMG+-HS8MHry%ZE>
zHaxOvM}Qg7lS<1jzksoZmL*r8huUMZpj<yAbxJKAK6#CSWAH|O9-&BW+pyK;*(gN{
z(C5%x6|Al?{9Cq^&A_sQJJnY+CENDL#l=olCt2~ajgN93rd}G!s*7Mx%09*JNYyXY
zoO)8t*$*g6pr<?8aJ4oRx#Qh;#6|H?F&1-~KR0Y-YiQ9g#3valR%Z842E8&~mb_>1
zCXDw5@;}$Bsr3<cB*$HVo>Z_+P5J!Oe$P-ts~b=Ibu9%0+HJq2-eW{*!Ju(`pPDA`
z%;yi=aU0u2d<=AIeD__M)xW|T>FI1&d)VmT=?hr{)fyH9tJI6x1H7pSJ{bimw^J5`
zUf|O1Ax+F1!3{~qGD|hvf-t`Vi&;3(_CfNg-3S3=Z?}I6?|2E@A?f)jXQtv1RD5hF
zb0_2ENy*ppLv;qPJdE+uDumc5oRfDm7R1XxIn3)N6%M~Qc$?;>5iwJ7=L^}e@2sG;
z2_dR^VfM&1L9Qu(go%qXW|Qvz{*yRG$i=?NWuBgTm(lC{WEA|p59kwm@hqOIz^%Q&
zRVa3u_=j2RwR1kgG#8-%RB?Jd^@RRSyK?xx9RsTdWC2_C0`ZR}wLqRoj2q@ad{!#T
zoKRhSE(0?Qw}2CkOd#%s^6n=+KH6kzF4%I|U-$VX`YAMeDRji*-Dbb13hfT*bxdtK
ztOf*T(-s-DLkn&e(q2)(q<)Wk0}+gehyNT8Q^+~`=5%n6@yPY#9$p3_If~2D5Vz!}
z{dC!((j(OLk>KDtPuzMqu^zj);6y#=&GDWAugU}eTF9+9J9JtL72^zGa`Q<k>vNzS
z3Q!ZUAecLi*EK470`|pFDkgIkNYeT4j<wwcr`18>yp`n6{g~hUy8%5->{1(r!R<!x
zZ3EP@VdQ#w3RJT=&;l;Wx^UYeV_bV`qI`h-5#aUn6*9I2`&f;T=`9@E&SUkiKu7TS
z7ZKGFkyL12wa3zxk4OKW?1H16nd@O__4|$fW;teBDsxwM_c~s47whEQMDN4KJ2dna
z@szC*j?EUYHAZ@lAEL{ew;r#+l32@K;>pO%n;Q#PvY<48ujpP2u-l8;TCAd!&*>_m
z9{yW(eSe1D>?s)yU`?op2H}^JU*fw2x@eKt=Z#QN4_mW`^M-gGw8zO-)h1M3noj+D
z;98PxCp#QDG^C;88-WQM4`Ho_dj(dmE9K=Z`Yci4f9C04ukHao-yvO)XU-3SxzDx=
zFZdK1r>`F;?ML~Z?l!3FGdPYbd(a&+j||xgij!|F%d%8J-Sb#JO!P>gIpiHsI-hm^
z#Qoe%v+a<VQeIib{~auil%~Hzk3N1DXKPbY^W)Loplq2Ml3pp+zATu<zFwe9c&8E1
zd|>9>#i2ceBnAYu&+!4dxokp0<ho7APUpNw62y~VM*ILnxs{$`@#{s%bw>^odYx`I
z%g)AmDCIC}9w@;Gi9Yw@<&W;|J?qW6Z!2x5((TAUSEb$sIy=|+Kq&)?x@eqh*!gJU
z-Xm@~>W^FYvq`<#MUTwwnn^ma`b%y)o6q{;COZL@D%vMbW0SVYY=7gH3`;;yYxb|d
zQn@)$UmIxRV@QU&f;_uW+BDng61^Ph^iRm7eVS&k>7v~REA)p<WJIqMdE4o&rkP_s
z*syeE4=~f)L_E|t;IxE8y9@A270JzLrTi)0LT`DCuDyGsP=~_fU0=cylPdXZ={0a{
zsEZ|1dXi`-Hs0sh9V~vR|3HD0Yw_S?$7{#I`?6RU%Jd0es_ly7q?L}Nq`o5~%JBS8
zqE4+`?%T;1H%4>Y%PlfBSR!^LKRfiql}Xqc|Er|_7YD5$eyg}m;|;bJT5qcrvCjxL
zk>xE6P!Dd4T6}K&*pG6|QHq?F{<Gj~7vGVMjspMV=~wrssP7Hg%Xwm}al;P^-P`)>
zXKQT#?D$k{w0BE?St&!eX_6Wb862FY7QghE@may0(GC&5l$U9Sjw`|l!wvFbGRQ;`
zveS?Wrg;BWig@ScTwuogV$X_h8rlMwWxV$n#*3<2%vXGtIhH)4P^qDwJ0ZJ1z~46g
z(}vDJd8FsOE+w4~n`Mby)-Q+ABc^S<v#V+QA6^G<Om#i~1<merh2emXbcy~Lwddq@
zBMAeE!_~B#gMAo@W_n+_gyLXdrAU8{v5$e~x_t=zxuccjnml<*_m$?x{RX@Xu-{yA
zs487Oy)&3?x|K52y|w!J4gZGeRyIknz(TY|XtdU|mWX=HIkHGF%=Z0iICOeDgJpoE
z<{_*VOVP<>vU>g-Kk!eNS`-BYM$P`BO`zk5z6O5l_M{CdUu5EFtLK=cawj5kL(Jyu
zz6&tUDdnz<kzf~c<Dl@bUf|$8=hu~ugQhF5@3X#py(vGQ<7tI@{080GP#D&EKy?(3
ztVqY2uNXjd3wNMG{J^r<rSGl^QKssySBl^aDR{?za*VVf5WZ6v40KRn>EU@u-E<{}
zLmf;lM(j@Ie7$$E#cU1t=HdFt!-LXuW@}|k^)`DeWup(GBO*DsW$xI<S+3uTtJ2&u
zrQ?`ikb|EH7H~M;y!J-i@p{x_5ND#uaXVT?tZzp|Ze1CoFsuK9B?CvubL77G^{tWO
za=yQq5&ChKt0KUXLWsKT&>l==C2@u)E4%4Gr48hFgG-mg!IA879@T86u3Jp<rT<x5
zC-oX<c;(4DG9$;%7H%M_`?rdmd1L3GL8dsC%u2y*t~`VcnxO}XMpDROpUBEfC7}D*
zfB4paalzH4Gg-7n8VOqmj}J?-F6mN6#wQGAu=jvtY29?X&3%_1a5PUD%o7`Pg3yDG
zV>*cUnsp#^SVaEwn7WQI{2R^9`wd|(fq>PHd>ix=Fu!31ee8e7(mq#UXaTIC^M?5m
zTD+||tbf$yQiU3gDn6~u=~No1R3yPuS7QQ}yG$w@dr5Z}Y*aTxa{qM5@#2?G^bRGQ
znoul<8uX_h#~*-pJmdVsGu|B6Pw2PZ|Fc03KO5@ia5z*c0cMSI_ht6w-Wj}@+S-P@
zd!^yL;^ApxIy$oOPd9Ro4Bf3XU3mIy`Qf1N3VA)1^55?Nf1ru{LHobj@edkm{a<Kj
zE0Yc{`OYS+BR%ljb=~PNSJ%%EcYX_d+O`R1Z+QPjV|Je1*gQ&O_SDOA(-Ftr`o`?M
z%-#CN{PJg9-1}MrB@lAlCMQPACniw|fm7<|AT(M1%17wr@ioLK=?lmEcX0B>toEon
zvb6Pu75CoOD=7DYZ)IIEJulD&<wSq7lUittj(rD7V8PAd#|ud7hAOBRNBZK$S|o$E
z8>j7$$-IbPT7Y1ZyX=8>xs`%gtJx_vW034^3lD)ao${_<h(QiZI^&XSpw_;T58ge+
z627y^K(%9RSz}FXOS~0nx}{i1mk!fTCbuLLG)3#Zq5w4GKr`mG=&1Sj)`x@X?8Mo#
zKf>1Ret%sS>Q5<#nX+%#SQJZB-x+@TT;5=`6q|AOd3;{wnC(_}KeQiW1xLo_84Ymm
z&2AVOpwF;sE?3$c#QzW|$Z4*0b40(sjsrbtbFrT6`V6943l?*W78jZZQsb?DTr4g5
zOxRZcWiRtdLUH6J?kQs_4Q#xakzri8be$|PFL7<mtuyft$3OthEHF?Y!b>b?vwSHI
z4CJWaTns75ZiRL^a+s!yK=%|R>wEcxmR$pGV{y~GD_l-+vlfVmn!#u1fDQXE!hO>b
zTPg#wKfv?O>pvVAz3=$O>kSLTV!^i@Kw!vH9lY<Imr*rz9fXqJUYq0{vsE8l9J^Sj
zk3BYGRFVzsie8vWWSTUgM7M5zyQ$1<!z{q~7$;F$@RNYq6nUAELVOO{nDNwV48ZOn
zDQA!jFclfi^~^ggy1y4Kxc#HjNTd)~H~{A%_88iYgdvfc%1FG=Qu4sspqo!Lv9dX@
zti|x;7faP^rHt>|7EQEwh-di$ZjChlfMU4P_GfnC!k6P}YR|E-xK{-04Nr0qivx|j
zG&@H$j6{jXThpFcVe@n+hLvaA&Z1az4?=ge^5JTQ-?Cf^DUilyICU83WUM8~XIY7k
zk5yP&)X}6arU{*1a&;9h{|_DVS~XOC`;e^4cH4KT#c$hrF_hD#hq8mKtE)JnahS58
zd|EkudL#7@ILfrE3Of7acP-T2CHCdy5nrTdW?lJvIy#<X7}weW9Z$^~PFv0yP8;`Y
zDS%o1k~ojx(@l?vAY^-6%`rI{Bb~krT~VlUgyeN-1C+hS9Jlpg4tcRvE>TqTjjp_B
zKx?5DEtEi*DM-I!{kNO2l?21;kLD}Ks7<RPn=_nmm0a1~TtBVZX%AkMNXA$Gr(cO&
zG*R7jA&M$}Y@&4>%iNm$HzH@eRsO7ZPT6O|np!rFkdN`{kG+e<#!Dj{TC+;%YBMCX
ziA}}|snZXIpw1GANcSCG+s|^Cb8V01WJb)^5@TGwm?}v1i@MSH`%Au!P|n(a+prP3
zU|r4xr3)ptq8H0V|IP@>h|Iayy0JF%Jk!Vet3<^wb-6rm^m*Ow7uXP^q3}2TS#Pi$
zs_lzsqmgeq-o@GI)KAM33h80YJ4?|=mJ$Y_c-De|pR>u|T>g0M+1*_JzIby6?GkkH
z0ANS*TCU`#zIg6rC8JE6`Qq&QN!PfOuUsq#WysW;cqz#d@cTz3Fk6fq<iO*hGSRUK
zEd3#SHgm(bbMXr7B+0qQXXQz66We-G9BYjLIyG;PYoVF?ml><=k@x!!y|jd6$ZO|F
zflafUUWYO~1WMH9CU4<ts>g#7Na~%p?L-0Bips^XdcFt1X!oy&M+)<e&G%xZS*FGn
zW_2flYpbVNXCtr$=G21EI!~Mn+K4Hr)LY>@Qxtc#4H#6JhL{U{H!}GbeLm+<B9Fv?
zcnv<&&*tf3jG}w;X=Zd1g97tHi4JdToM?U5@;W~;;81ytt|T^K)q9lHRpt=-#YoLB
z8+Yb`!qCJ-D!w$rL*AvJrfk?#-dUl(^oWEaOJJt>;HI!Y7LipsF;@%}=gcu^BH5_0
z;p7~N<g1%!G$;QuFHXmt2kR{v@XC}Z*QE;iOzfqkmQ)D}M9D~@jK(MHwmXIn<y;oo
zys+93fizyckuVa`3N7ECDcwm9D_L>tC>R^u5=_>7)}OK!IdQH_Nu+#e_&DBhNpcr{
zcn?I`lAJc77M+^7eX*pPrLSFi0KIUf+h9;?Q9EJQ7(4v>tw1}O&ix5L?rR|coai2u
z+1FY55zWLMggLuVQOqSC^;%xEbBPa><}GI=zis3kK##PKtAdXkXX288Zz`;+Y3m`5
zntXO6pYiC3ZWPVG{dAs_@wPrE9U<jOsg(u1Vmcg9@8%O-rTkvd9^15tOMShaN)fwj
zCbeX8(lOfRn^OonND7<eH|o~;VtKZy+g0I{KsXY|F>5#SHKy=OV}BoCZ9DKLY{?hY
zNOIO?q|a{KIR|t`zR_fT{Ufr9lkc(b&{DcDe?`Kkulx4JdU*@)oD&*>wp+kQ^eh&<
z!Smm2Ry>AAU}j6XLwhO*SW<wJYSrdV$l;d#q<dLHtB#v1f?uNbfqdQ>TS?VG&qVgr
zu8LEwNXVj9etOYZG;{@A^L^w4(qY|9E`CQNC$2{FN9X3L`+fHAcorxl_3Lqb-4=eI
zjj&aE=YfsUpXN&1n794LESbiaGR52NOy1zu@r{H+ba+4OFTv?1JT}kCYFodq<6ouD
zPwoYRZ#18<9O4UX5*3-bX7qI1$WJ~b+l09ny)ebqyz*(!k|^P2q~oXKSoVci!(C6i
z4lEy}gO89}q~i$VVyJ%MZ{J-Ewq_7AQI4O2YItjj^%+7_BH73@&T(;I-DdeY(xs%@
zeO3`Cie~KN9&P__%o~`{SMrX(bnok}@L`f{frNR8u+oc~W#eaPpcO&0@{4lJlZ2;h
zWm7bH%yH7v8qo*;W6*ijbG?nQHn?jb?~O`I_1XFbNFGGNeO=TPp2lXimbJx9SIoBY
zs0isAA2Ph+HZf2tTC_QrI6K-%kU<n;_@hUrjbc`^S6Up+8)A(%Q8Ujx>do+8YweKj
vRL;#fIA$Q05RhOrxcIJyCaiR40~oOPgjU;Q=lY$0DClV$YGvPi^ydEnVugJq

literal 0
HcmV?d00001

diff --git a/docs/main/prerequisites.md b/docs/main/prerequisites.md
index 0fcc40b..03144cf 100644
--- a/docs/main/prerequisites.md
+++ b/docs/main/prerequisites.md
@@ -30,6 +30,20 @@ The following operating systems are **officially** supported:
 | Fedora       | 31 / 32          | ARM / x86_64        |
 | CentOS       | 7 / 8            | x86_64              |
 
+<!-- markdownlint-disable code-block-style -->
+!!! info
+    One of the first tasks the install script has is to determine your Operating System's compatibility with Pi-hole
+
+    It is possible that Pi-hole will install and run on variants of the above, but we cannot test them all. If you are using an operating system not on this list you may see the following message:
+
+    ![](../images/OSWarning.png)
+
+    You can disable this check by setting an environment variable named `PIHOLE_SKIP_OS_CHECK` to `true`, however Pi-hole may have issues installing.
+    If you choose to use this environment variable, please use the [Community Help](https://discourse.pi-hole.net/c/bugs-problems-issues/community-help/36) topic on Discourse to troubleshoot any installation issues you may (or may not!) have.
+
+
+<!-- markdownlint-enable code-block-style -->
+
 ### IP Addressing
 
 Pi-hole needs a static IP address to properly function (a DHCP reservation is just fine). Users may run into issues because **we currently install `dhcpcd5`, which may conflict with other running network managers** such as `dhclient`, `dhcpcd`, `networkmanager`, and `systemd-networkd`.

From e7dce01da54f1abaa9e596a4d04ac5d78b8b2a42 Mon Sep 17 00:00:00 2001
From: Adam Warner <me@adamwarner.co.uk>
Date: Sun, 7 Jun 2020 12:13:28 +0100
Subject: [PATCH 4/9] Add alt attribute to image

Signed-off-by: Adam Warner <me@adamwarner.co.uk>
---
 docs/main/prerequisites.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/main/prerequisites.md b/docs/main/prerequisites.md
index 03144cf..76c1588 100644
--- a/docs/main/prerequisites.md
+++ b/docs/main/prerequisites.md
@@ -36,7 +36,7 @@ The following operating systems are **officially** supported:
 
     It is possible that Pi-hole will install and run on variants of the above, but we cannot test them all. If you are using an operating system not on this list you may see the following message:
 
-    ![](../images/OSWarning.png)
+    ![non-supported OS warning](../images/OSWarning.png)
 
     You can disable this check by setting an environment variable named `PIHOLE_SKIP_OS_CHECK` to `true`, however Pi-hole may have issues installing.
     If you choose to use this environment variable, please use the [Community Help](https://discourse.pi-hole.net/c/bugs-problems-issues/community-help/36) topic on Discourse to troubleshoot any installation issues you may (or may not!) have.

From 48d58c7d2a9129106a2d958099c9ec388c19f703 Mon Sep 17 00:00:00 2001
From: XhmikosR <xhmikosr@gmail.com>
Date: Sun, 7 Jun 2020 14:15:57 +0300
Subject: [PATCH 5/9] Improve image compression

---
 docs/images/OSWarning.png | Bin 9443 -> 8915 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/docs/images/OSWarning.png b/docs/images/OSWarning.png
index 84cf98c8275d91232ba99b4844067b27dc8ab29a..eaac33fb9ceb95863b946247ce9f697f9676042f 100644
GIT binary patch
literal 8915
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

literal 9443
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


From 4822c7eeb469a6fc254b1ab8c6f6500a23a09459 Mon Sep 17 00:00:00 2001
From: XhmikosR <xhmikosr@gmail.com>
Date: Tue, 9 Jun 2020 09:34:58 +0300
Subject: [PATCH 6/9] Update compile.md

---
 docs/ftldns/compile.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ftldns/compile.md b/docs/ftldns/compile.md
index 6b02966..cefb9f9 100644
--- a/docs/ftldns/compile.md
+++ b/docs/ftldns/compile.md
@@ -17,7 +17,7 @@ sudo apt install build-essential libgmp-dev m4 cmake
 sudo dnf install gcc gmp-devel gmp-static m4 cmake
 ```
 
-### Install `libnettle`
+## Compile `libnettle` from source
 
 *FTL*DNS uses a cryptographic library (`libnettle`) for handling DNSSEC signatures.
 Compile and install a recent version using:

From 8f073c29d5e272c4128c82229a9a29108bdd2cb3 Mon Sep 17 00:00:00 2001
From: DL6ER <dl6er@dl6er.de>
Date: Sun, 5 Jul 2020 09:46:33 +0200
Subject: [PATCH 7/9] Update description for AAAA_QUERY_ANALYSIS

Signed-off-by: DL6ER <dl6er@dl6er.de>
---
 docs/ftldns/configfile.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md
index 44a3d61..915a4ba 100755
--- a/docs/ftldns/configfile.md
+++ b/docs/ftldns/configfile.md
@@ -34,7 +34,7 @@ Should `FTL` ignore queries coming from the local machine?
 
 #### `AAAA_QUERY_ANALYSIS=yes|no` {#aaaa_query_analysis data-toc-label='AAAA Query Analysis'}
 
-Allow `FTL` to analyze AAAA queries from pihole.log?
+Should FTL analyze `AAAA` queries? The DNS server will handle `AAAA` queries the same way, reglardless of this setting. All this does is ignoring `AAAA` queries when computing the statistics of Pi-hole. This setting is considered obsolete may may be removed in a future version.
 
 #### `ANALYZE_ONLY_A_AND_AAAA=false|true` {#analyze_only_a_and_aaaa data-toc-label='Analyze A and AAAA Only'}
 

From 79743cd0e85d3fd997ff25eaddb635cef5edeace Mon Sep 17 00:00:00 2001
From: DL6ER <dl6er@dl6er.de>
Date: Thu, 16 Jul 2020 00:14:24 +0200
Subject: [PATCH 8/9] Add libidn dependency.

Signed-off-by: DL6ER <dl6er@dl6er.de>
---
 docs/ftldns/compile.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/ftldns/compile.md b/docs/ftldns/compile.md
index cefb9f9..f27677f 100644
--- a/docs/ftldns/compile.md
+++ b/docs/ftldns/compile.md
@@ -8,13 +8,13 @@ Install them by running the following command in a terminal:
 ### Debian / Ubuntu / Raspbian
 
 ```bash
-sudo apt install build-essential libgmp-dev m4 cmake
+sudo apt install build-essential libgmp-dev m4 cmake libidn11-dev
 ```
 
 ### Fedora
 
 ```bash
-sudo dnf install gcc gmp-devel gmp-static m4 cmake
+sudo dnf install gcc gmp-devel gmp-static m4 cmake libidn-devel
 ```
 
 ## Compile `libnettle` from source

From b8e4248b986ee58ebd7584732b5d7636b0c93457 Mon Sep 17 00:00:00 2001
From: DL6ER <dl6er@dl6er.de>
Date: Thu, 16 Jul 2020 00:15:41 +0200
Subject: [PATCH 9/9] Change supported Ubuntus from 16/18 to 16/18/20

Signed-off-by: DL6ER <dl6er@dl6er.de>
---
 docs/main/prerequisites.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/main/prerequisites.md b/docs/main/prerequisites.md
index 76c1588..cd55a05 100644
--- a/docs/main/prerequisites.md
+++ b/docs/main/prerequisites.md
@@ -25,7 +25,7 @@ The following operating systems are **officially** supported:
 | Distribution | Release          | Architecture        |
 | ------------ | ---------------- | ------------------- |
 | Raspbian     | Stretch / Buster | ARM                 |
-| Ubuntu       | 16.x / 18.x      | ARM / x86_64        |
+| Ubuntu       | 16.x / 18.x / 20.x      | ARM / x86_64        |
 | Debian       | 9 / 10           | ARM / x86_64 / i386 |
 | Fedora       | 31 / 32          | ARM / x86_64        |
 | CentOS       | 7 / 8            | x86_64              |