From cd12bb29f87d9030ce50f88074809b23409dbda5 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 21 Jan 2026 21:23:15 +0000 Subject: [PATCH] Deployed e0f6c1d to master with MkDocs 1.6.1 and mike 2.1.3 --- master/404.html | 2 +- .../documentation/usage/authentication.png | Bin 0 -> 38216 bytes .../social/documentation/usage/ldap.png | Bin 32536 -> 0 bytes .../social/documentation/usage/user-sync.png | Bin 0 -> 39414 bytes .../configuration/examples/index.html | 2 +- .../configuration/overview/index.html | 2 +- .../getting-started/binaries/index.html | 2 +- .../getting-started/docker/index.html | 2 +- .../getting-started/helm/index.html | 2 +- .../getting-started/reverse-proxy/index.html | 2 +- .../getting-started/sources/index.html | 2 +- .../monitoring/prometheus/index.html | 2 +- master/documentation/overview/index.html | 2 +- .../documentation/rest-api/api-doc/index.html | 2 +- master/documentation/rest-api/swagger.yaml | 25 +++++----- master/documentation/upgrade/v1/index.html | 2 +- .../usage/authentication/index.html | 28 +++++++++++ .../documentation/usage/backends/index.html | 2 +- master/documentation/usage/general/index.html | 2 +- master/documentation/usage/ldap/index.html | 6 --- .../usage/mail-templates/index.html | 2 +- .../documentation/usage/security/index.html | 29 +---------- .../documentation/usage/user-sync/index.html | 6 +++ .../documentation/usage/webhooks/index.html | 4 +- master/index.html | 2 +- master/search/search_index.json | 2 +- master/sitemap.xml | 46 ++++++++++-------- master/sitemap.xml.gz | Bin 366 -> 378 bytes 28 files changed, 91 insertions(+), 87 deletions(-) create mode 100644 master/assets/images/social/documentation/usage/authentication.png delete mode 100644 master/assets/images/social/documentation/usage/ldap.png create mode 100644 master/assets/images/social/documentation/usage/user-sync.png create mode 100644 master/documentation/usage/authentication/index.html delete mode 100644 master/documentation/usage/ldap/index.html create mode 100644 master/documentation/usage/user-sync/index.html diff --git a/master/404.html b/master/404.html index 25f6d74..b812f3d 100644 --- a/master/404.html +++ b/master/404.html @@ -1 +1 @@ - WireGuard Portal

404 - Not found

\ No newline at end of file + WireGuard Portal

404 - Not found

\ No newline at end of file diff --git a/master/assets/images/social/documentation/usage/authentication.png b/master/assets/images/social/documentation/usage/authentication.png new file mode 100644 index 0000000000000000000000000000000000000000..299a40c57d3ff5093b4c3dee6d3b1c68964c01d8 GIT binary patch literal 38216 zcmeEugMjSL%UXlOQzU%4PpL$f-OhGwPx z`nC8Q*}q&gX=t8r6~Ay+(eY(}i-YT~+Qp@jsfcqcSFg{TI+~|)_F~LUk6qyp?*H3y ze|LGF@~)g+Nh@yJZd=iFG*4nEZ>n{J$=KX2tIJHF%hlf4 z{wc+#^I_33+Vl7<{O2LPW;*A;A8GartXBQ+$3%gZT>t&_jbR1de?OUf(QNwfr}Rr6 zYySI5<51zs<)1v_x9hH0{;9BTJsyVqr)&2A-|qjf-G8z0zXD~=%drRnIw9Y-dIdi{HQR?yZe2oBi%UcI}sDc1VOyNw$*j1;BZ zp`NBKIySGhdil#_y5M&&_SMB#&rbBExh*(bG^I-mISeW)Dn66#TTe@?`1;%(#cW#> zrKqcCcXKK$c6@xU6d^^wX3cTq!y*TMM|^a)+d?)Sw|ZE?;;f{kFW1)+FUH+__87-_ zfAT*Od+`CC^Y?$&?V_iT{`cSY7cX2mvj6)M)p8dTQ~X$0WnXia%^BP7$CLdHq1+nj z*YI8LdwJP8#SITzE5#~H+x68c-CDc3CQ(@QP5wzW=*vH zK%;40oWFXydGyEUoG!z(-?#ogq<>Y#zq;026U`vvoJt;RdfL%@mQyV`EZcq{#-{5t zoAwRIh1m(#xz+2|#hTW}#AswB^wv|U&J(>H4uj1clk_`xhW1oP_Qg{3tMJ|}F|k*k z9CV%^DXmS?zl^7Ih=C$&YhlcKkceMYC(dO zKc5NKL_N>C{tK7wqLzBPAQ+@c;a2}Lwc{VaYUaP740Vw7TiH7JEH$a-Smvh8AzDn>mv&`2|_O|>6T7gM?|)Z)-aX-v1!@Ugi3 zXrJ6aE7!~`ZYS9>s9fhhnxtob;U`W0?tuf8)uu#Fvh1F};aL5J=XD=&cNm>SLO+&8?Byt?KR#VJHMD5Cg|819P*FdWWQPm4pLb*=z1;hpAV0 z8zr6{c`f2Hd1}DD-zOyuvkj@u1*fY zJ}O!TZdz6a3(Mc<#fumGQ@om)iEFnq$6aQ2dcUr=MI(}8QML6wULpOZNe7OTf7seGt#y*|!9mi2P zU7Mh#;W9Ot7FK{jRn>8u2_MWE5|y02Y_pfD!X=+t zH03x@WrBr!Y?n4O3bHmS=hzRtUvkI!VEysj*38#W==JT4pfh$7cD*%UPqw+X%R91( z-`&Dg73wV-gV_93Ui%hFj{ooX>uclG6iOd4jX9j=IO901o7`Yf8>=$qpoRx1)H1{w zKdO-)hmA2UA3l2Ol&XmH_|^IZE$+S(e0=gJj6PkxaN#!FLPdy}j#7-`*K*zh^O=KF z))gWwy5i!i!dEk%w6x708to_#veZd8_pctnNtH~Gw`|G2wAqdr;=Z&{HmOtKmgl*ZW$>;9!Ay?j$YM%Ke_xai;4h19|5XvF5-4a<#o|8y8t)u) z;ogpoTeir!3Zvd3r`PFwi$r*fEvh12)!@{mAtDBp2^I3KOsgZj$oW*FYHN{D`Wz%QQ7tRRf#k&FWz+xdc$#I4 zIzmEM(3h9~n4tML-76BK)tT4Z4d$3mS?_Of+aOjOqa>NWgk1l0Kqc8gTt}Eq68}`V ze&a@oNlnxP!}rC-r!7((hO`eIJa|woaKlda=}c#r#$>|>l3iETQ9PcZQN_@;Fe|{Vgd}gYxp!^>6v9{y}^rwH2L>~Bcv>k4tNiwtp#!7hJ|7ac|2`T3la zqoKgPfPw$oD^$j80d~#H9^o4GeXUu?#yiUWfRg@UZF?s-ih70OX0yL7-2UE#=-fWCoP-5AX|kJm~imm zxwB`_ehfTGJ>xJKH_=xgshYxD6D4;ZU$88lMcDCJu^@_G^{cbDYDmC!eIc=aT)!mD z(J4xZYKUFzus(&V{MBF~UL%7iDdgGbv$Bswu<+I=&p3^SF$kE3aVSJg$9q!dCZjbn zEJ<<319XgyxJ>p(pKNtJua<0ZJ;ysS@z}!R+z_eN-|kGc2`|ld7{7dq|aH9>SiF zlpPLXZCXUaWbJWj&b)rfz`!7&nz{TLhrW4p=5aL(Jey7S63(=+Q`XLS%`85(HlRNw zQ-p}mfJUq`cjVmQx1^#dxlm6@1yL8Aqze}>vY8B(ndR%3ZV5%z;CQrW@7`;|3**(k znheI1JKn9v1BusJBF)K6G4UDv`vlL=uTy&P;{CnuIPuAogSoyquQom3?s$5#GgemX zhj>V?N7}K@_?G9AAqR-#x43q)R<(T;P8;-8RbL!cj_Wpw_OaCZJU!WDb-0On z*RE&NO9ivNoFXIdcVg2u0~Q9FvlIYkuB2a`L$-c85O`ew(sM4gDz6xdK8_@Tm5U2g zI)0NZ$N#<^j3duKWz!)bX4m_S*>(6V>cQb+x1T?Mjw5GfDF&Y0C*oYwbM97_O_xmi zz;hLCxdOKZTLcRKoQUJ_s{lcZ7-XNYEGj28TqxJBpXA$|M!+-%LGu^=8xOh*UH^HT zKtp%GAL*scE}wcF!cw`^Q?C%b1*n~SwKlIJ#p*%NzbTSmfkpkMm;88j02Yz5VEo8~ao%4%U+6ZK>XX1hZ- zZrW6hs^+8h@swS!B1!uQAgQFGRBf9c;u#y`znWiC*iH}YMW%Q=k9WT&$O6z@a-L?OHrDTRh}ck_jqPQy z#&oN;gtxcW9d>E;sYx@dXWcY<`QpXXoBwJ`w}{m%@?=|-d=G+F6E3+2(SPE42$sHg zqF$#SA6pg28D2jc9U1In+qW<8MBzt2-jG(Ot{?--%+GJDu+;WRE>o5w<6q9FZ>F-E zl>2hKF_AUKTUTQ%!-2+*96frpL39tVwxXuyOCGIkgPw0VS_PshGqQr zLzj*qbBd?)YNT^DgnO*nL|0Q2t?(Q<`Mt%(`@6m(Q#?Cq)yiu1t7#RNv4i)Op3k>< z3+8VGI3#aEtp2=m-_zml@_ z4Dnm{_mo4vHYjWj-oR%%V9n~)Q3$J9We zDhQO^&ciZNe0|X=^uT$V@Z5lhMX{#`RQ_)EjrJ4aCkCl9Tv3zCpMR`6q%qi z9YgZ+X;|NaM=ZN`g{@e%mUS+_{S%-Gfn$EY->=vHvua&UnD|a^wdD8l<=da^T2W^K z{1Tp|U&`K)u2-}cJd?8_;0z%9GuCBrw=!;VVeYWTlEe)+|2H{&V0B19r}8#6;SBj$ z#Hyu407~?yQeU37>HYBJ(7h$foQ)lwa=5Kzjo8w>0(MR^Z4eBMx>l7*$ljJ????X= z#>o}{=#pvDrqnFfc-5qX4e6qk*;ACwx4#x!oIVd&E0IiDoS!M1q<~Dn z)LyB9{GMjfqzvLJ+ibMgv$HaU+M4Gg#B?&gzKW?;coGZZp{1GUtVD9y1kX?V>!ZKK z={@zD*sfVll`vYVGHA1rLJ@G%DgoTe$=2b*HeEJ3s&<}16FE8N4apqr?CjSye!RP* z6n161cm@w!ZVT9f;a<-=s!oW33;tmzuXpk}d@Y6f(INAIPDGFZ(wE$Pjwd=@OX#>Xhf#|#e-zrWgrlnb~knan$+tRwm&AjP=SxkePn zHYq6ypz8)hHuhF(WMqUxTcXpx8$G4$x@ z4XoS!na3{2X)Ge$vLyzIp1r}XOKT5udK5lKRrvwu-+%vI^XB3Mg9n3>8SlbwuGvJ$ zD3Xb7wv2!6{Ps~V7BOvn&*a>;n#GRyTNG{%*e};_&We|(6$slaD7TK04isbn>>2H< z9GXZHo$EhA8GgHtdEz=W#59xYl7O311d1TK1?&bIYrFI#*G;}W*M8X{LBa0l`wiTh zna9e~=Y|Tz%G?jf-F>e6>BVuA$v$ZuIhk~euWv5$(H3=t+&1w7eRE*=8y{BDS6Re# z=+eV0bh^8^)fJJCt3iaona+>{gvyud+W+sr{~9zQpX$$?%HKv$?{BVQ>TvRUx}!n5 zc>`BG2lwKC$L=JPsH-X}R7Q)^+P81tl0+w9(a0Y{gcEUghZG#~YuK_yp7w+b9(L=D z`{tY7?&ik zKBrS&Ry2#7to7$)sRKI)QUX7`o}KSs`!b%*u1o!z!zSadFUVvH&20@UCqK^)v%539 zAT<n+O2`V+i|ZgasxFSM}p=f8${B^ex}8 z%pl{DihD}zJLE4JrxXKcc8<&3HLHsgPZ2ZT6fG2Z)*dN>e~zzQ?JA$^v~?u42M3&+ zrA-2xBb{#X;qd_(@1C!rmj$4lvNrA8a+ld{TF<-Bn$8*sx4I|)_u^-`E=<&`CmSG$ zuCVKuJPhD7yx;2F$4wclI0+i@EJ7wIhA6v8LNx>j^6AGx1WnJ1&B-D0j8ZY3^Dt)% zo|kYp$Gc~Z2Xi&AW~cpSZ|ZPuY$B*TfZxQYe>0`y<8A@-Z&#nPOUv8Z+Wwq8botRW zkPByU%n1l`eSiV7bvjT5$9rR`>`kIpt-=UaC48f=s4=^cp1QlQ4YcH_6y4qGz(LOo ztt>g`7&N2{L%Cxze_!1WMHw@iOJv(a@NeXdyBa)Qg<2QoUk{%>xWvSg#75EDUoSdP6uJ-sM_O(Tqhe4 z<`3;>Ubd{UK@voLeIBNfGP>iP%$4X$ClP3@!*IFkW(AtHXFS-7P1rtUDdQL zKM!m128aF#QHOlk9uS5*)#l!o?EZc$ATwmS2rji`)vAyJ*SUcVXw&`$<(WBquS8(Q zJy|2gh)CAhS+rG5Dyag3qyiI_r~{2y1lExe9645(T-%{7O{3ECLX)Tn6h`A@{2V#r<4ube}62hl^KUFziU3}Jg zqE;nnP$fb0bSTirC7kMq9v(E2bGvx8n?viHkI{zWp=9Q^Y~09)q+@ma&YkdSO~Nyc zmK^YZ%E@je-YizxEXE~|nEFybtFNBR`hAMS8-c9}bn^G;=vo5PGK1c(fXaD$AdS z09)*plauq!Wu97TqnCV> z&LBdMVqwYvck{KXBW3GR3WBtQkA&x6$%++Snzz}_rFyJk^4m9pT(}x$uh~z&-znQI zwlpJ~Jb+>cG4fUQ*x~*A{{qOaqD-|It1&^z%B&thvQm(elKPoy;Lfs~cO=LGKrLL* z@-&1PZ*CrE=wQmLlb=htA!^}QpT&7S6flI+V+4!YHax$)hf;wXCDLs4N(Rr)T$`XH zJ#}w})@+_GtL%uPBVz7(Fp?VEgR{(DgqkE7FPA=GnBAtL&-BmnZSEK z4Hs}lrzASKXhYwPnYm@~q6{>5ztypQv%8<3KSAgKQoy$M$$@X24%&2n3OJ^B6Cz@8 zr^CgZSni&TZ@hs{`SJ0A^T`85vrLjk6?nN;CtrK1R|Y_}2E2O$HIMLD zoXTf>MxTz{EqaY37=_pMwiOhR<_yj-N5!jyM~+;v%AbkY!Xg@n%pwPlr!?}jc;_4~ ziVhO0QltzM$tfvD6;;SrO*{ z1p({+(`iqA(me{XXCYUmzM}zj}aDeDyz_dfip) zw(Pq~WV@X^+lS;`*^eE&I#jTfPncD2_6H*(XUhtY+(ynaQVVHKM?omyJ#Szf_s??k z-($1uY)|Brq9ZCjN43yUZm6I|V>db(z7rY{%Ym$}k{lBL_QgpGblXLqw{W5z~}mrGoP^uXUgM_^SUL z2x5%Fj>95M+TvAE&J+=XC_1fGZW`!nLSI(_3d%^;iKX{^jnY!rX84Wn#DA8A;n2Q% zYOLq!CLzWv9Ly!l=F z|BMmSU!hB`rw$IIsn_$*I%XmfarK=*`*#+y1BpS^x=65#oCv&jHiuT@@8z};4UL;( z=%vl^S~>VOst2LGl7a#C@s$soWDE|-$6ygc68 z(XV|=)FUZ}6`b)Bs77+I_w( z!ozZs0z~J;Mh z9Uyn5Z%QIjXE`Wivc~8?v(9&Yi2BJC$J$gA1?bULfR|R5Ebtj zqn2Xid;1^C?0C|vGkxz%OZ(8i9ziIb{m)J0;f-`q*~S(Y1)YIG%q}P8ZA9Iqn1;MI_cPt$roH*mmv-!Xw#nv`T{j&LF*hJ zNyZT628Q^W>v9~dNS7B)yRY3}Lt6$T5kYjyhF&P|_$-Y-J9GKXn>VRWV@B?NPcB4A z`HvUx(ZR-fpW3&D0=VH5hTe4XfE%$wK#EjXd@j(RtsOx9ABWE1ZqOe^^yom6egejM zk9Jm=ITb+aMm4*;h3QOKRMe3>ckVtKSt|aM~{ZfQ$qnYJsgB|&GEMSKO3<$EZ*ffK1f+@>!LlF~%a@`-Fkb<+PL{;6)OOOcB{*4jbG`8GaX;4`8&|@Ha@)v0ysP6Wd{}Sx&=| zvJN@knVF~Z#y$(3LFaMIAp(%$A z;`}C6??We{X4QeeS;+}x}_cDpR%N;h|}YPe;f5F>7sR%0+sVdY&>r>gqAk8X{O)KQBmE< zJDK2a{q{|O)2gcCA2rpkxuIE27z_YRBxKg6fh1ByytQ{)jn&4T6#DHeEnL^1x@`&q zTZ^T}n+qGLI#s?Xe!zFUwUoL9t=O($7a4qdHEOJI0R1GkBeSJ$&x?O9{*F3X#~Tg7 zwOg2lyX~8ZEf4&rZg=|ylF2EgEkwZ3%9ShmL8thO5^DNe^E6=3bI8f#MSYsfSzYk^ zdwge3L9O?06hj-6PU)v6Qj3DCIl3pNpohe42g6Aeauc%`;V})O`_bSa>%Y%aYiRoh zvXFnB`8#qOVN(G3wob3dg|yK5BVIPhU0exL$Tz_N+MVM`;1|G8+GJ1ATdRF_c9nO@ z8RzjRlz5Zaa-pCNn>VLXyjn|W|1;>i7B=-=^54$L7z^Z-)gp=~VGwpqytBJy2Ra(S zzk&^uSgyXF$Pi^@>}O)`ZfGF9Yaf>I5uN^iE9c^Q2ZZiv=* z)pjAw?(^4SwJCgKYB_^$AFMWM@0T8Vd)LFN6$8N94X8*I_*A0`26D#QlLW0=O`15qz!2d)ybbCZMD~>=oh`v*EB`A43dR0;A zdRk6>eSLnN*WTmjkfjxt78i(>hsXh>jSYD_93?vz#zE%#09}ZO>iMo&h6_#_@IVzv z4h#K(0{gM9Nb&w)#brKj#JWaIqX+;6R66N2?yIjn-W3%oqU^PFYb$DERyve#0B_Mikfo~z^dx1%fpS#ZtY_7*GJM zqBsPE8H}Rvi(U<|K(H#NnJS4u5+cGHDul6`NJb8n0@M10csz|%rr%{?>+ctRLF zziG`8vW2LM&Y**}XpV$X`)Uf@-6iP~rtYp>vk{o!&v8SnoO#d*vCg^UxeCA2s6qK` zuKhs3a@;_l^$CN$r59#V`J}qKcq5z2{`R2$$X&_ZA>0cqTt~8?Gz363>!5!~I z%{3L*L3daIqRKeVLX3XtqsA0t@BD>Hje>fny7*XZT^}5XU*H1n zuP-#j;{$_7;G0Jx+p7_e89;t_hO@8|)K0Li|3RF8!J>eEEdr>D-}v)BqPK-_Gi%GI zn0`xq{fI>@0sWC)NcJOV?|i;^`EnmXwKB{I&)FpD;?+_vfmEiUvmS-)L+l1=&~w^) zZB)QSushs;miEw8i$h3(q;(l|rPpvA6YYRw&<0%@k@?}GY{!u|ouB+eQQBq`-z`-h zqm>RiqXaGb%N`xq*D&p#19g!HzJJ<3HCoQw2gXy-cP^v>qL-gMdN$mQ6oZ~ z5*%s74+Dkn7F4isu)?D_Iwt8u5PD`O2l{SFi1=}92ohHe#EY94)+lPbxE#^eyqQ=R z*p(AlijIu~U-Y2L)<9K4 zgBNsQxkFefGW8NFVz+%8Ed0t)b`-R_%G*R|e(lVgsM8>1=;plE@&nLJ`QTVLi59|` zFGtLq=(F$U(Nu*@00;asA0{Xq;6QsbmFOrSkkYr-ZIyA2hxELxnaPUIgt6)GIjVR? z$93dRu-mMO_uQy2NE9~ye<W?a%CFe=4Dv7UzIMX zvO#@3EE}u{R}Yjvi(|i)J{Gf@2u%uTK$KF%tFW=lh-|30+xir&J}Q!?$>%_Lkk>xXWY2P;dM$vA=zn;p@n#X((iZCp}NcR=hL!|c*H`2p0yzUK!g}-iB`#%taNQyo9Tl|qFCy?qr0v&|lGt0D= zT&EPGZ=>a(EwYHyE zI>EAI#~T=@%6?eCuw;Y=i3|{fJj>G(e~b;FYpgN+mIIL>aIAmX&*5LxR30)0!?w0& z^|snmMX}50!y^RUtc&m|jHxeSA5-BP8B}fp3FH(MtgCr5A2i-RMdHk5Gg zxc4tX6XpyqwYK~(6ilQ^#}u<>@5^L>jb03s~HUy8;kC6?p_E z7&DuCSl4WSyjzpel%o%jXqkZuxjd_b1gD|;#4MOHsb*LaP}|ks%KZn)hVEdKhyuQ1 z=Kaep5-Ck6FSZqVB@K;DBB&#S)nY*vv~)#KFf8j6(YeiN$~J?N3tVh7mt2aJHYZ$2 z4j@#wq3Yv9f`1mbfnZ{oLxJF0lSNs8zuzyp!x%zLghcPdEA7y%_M5x+@4wbLo)A~E zTI#ew{LX;9Hoet=I>VK4!~*i2T(Gc{tLR|M?cWqxELJt?O=E_YRS#Dj((X0Dc*5+A zKD{7kG^=dcr>V@auDLUJIh$I)DAv9;* zpd8ga*u7$qjEI3Fl0}AkD~`r4am3Vs7Lm!QwvHb>Z=F`tc-WCw69)jkuYO5d-x${q2%(fO$dD{~1eW4)CmiwP)Ju#M}NF+&Vg2oa@> z<1a8?*1Wa$hvo9yr-6M%6SCPxnF?ZCP}{EU)F=xS&nECnFbpucRq-S)3|ZYOoai z3|Q4{sR0tPiSs(;)2sbcU47G|R(@!}T>`-zZ*X)tv671yK#8=-%EhpCV-96BgWI7d z)g!`xRpkTJ$-|qKtGRvf(#y-3Es%xhr9CVz@Qltfw7?6sZ%$yHk6Lz?#iWXKMP|!w#=jr3(Z! zhxBF{BMq*DaPJDgPxBpTC_QtxZ>9f<(oMDBEsM$aPMzMj1)gVF6y9M64p=**CNDrL z;*MdpKwhiI2u!d29Ppi*s`SVFxj`X(eC1*N@ICkpMwmHdn^t(lqO$y~w!ac`%A1B} z*b99DGtj+7p7TDb?n`dob#I-~&Uy}??IunMHJFHn)fG&!z;w#(nmAsy@NQDQpSEIw zx-t4gj3XKrWGW2QNL_O~&Ahvwo}Q@1-SK;4;B;-sB@fV_1X?%P>q-26_Hz)cfi*w8 zyZ^ErlUCZ42_^4YA~;{HJw=8nHnWH}$Lfb67t%3c0*|)HI%feS+f+|r>JenbKz05C zm~Iw%=&$@LAIm_W5(+~^6M%ce!0{i9WUIq;2pwGp*`7v~!2@!0z)vygtI;Vv)kM+) zGT3AI`DMd^DE_{)mWC7aB*WWQa>>xh7Y@Ym^s2hOv!O~oDWO-yxf?)wmgOA@>H>z^3Cu`MM0o==kQo&^rPVZL1inVltwP^6(SmO49f~#c3Yza4 zfMfO0Np>?Z^ky&smv@awtD)V*4?j5|dfS^A%NbOkiAFOjs6WmzcT`Ch%3%x=sdnFz z_Fo=`+hci_^p88xv?@YHBJF;RiR#A88Gd>pS1>=i>4D@sj^$??LXBG1HauvSC|*mL z0}&p?49huK>HXLwa|}MeR0DCWMYps4x(=M(^=M)ATo?N+46sk2WNy_|-ff!lm2k1u zz-7VR1LKk!NuX?$6&@#0QR_*o8=p^X!DMn3=NL~y5NO`wY#%9U==8&ts;5u3bXpr2 zK>)-*qb@Y{9aMo-Gy=WnAOY2a@=~Ge#=?JTIq?<8m-OaHhoE%gO4XOw=kt=oWZ|lq zK%-Kvbtvx$bbzpR#F$MQt39ZI$~)Pmt|HF4dbZNMEQ4gO?KWdb280%Q);JtrUJWWD zjx;0z`1`*~zi);koltPnVD?!go*takYZ&QT&Y>WgM|gO6iWh)mh#1*J1{tBOaz&r@ z!4v@*X;H7!xryyFLo>xKNWd=`hpDi)eDRVO!*9LLx)%)!(*7nS8fw9uZ9f{UG44x? zXtxKjEr5(Iw=e;a$Xnu+o1yBG$q&os%-86BqrY+$pD7R9!>(Nhl!s&_W4R|i*${ep z>%#n4C4g#bYMTrF3g5fLV~X%rYwW^NB^^I9sp&hp++x1Mg8AA|EN(P{G#e(y$`UVc zZxyUps_V>+a$`E+FKO^EdB7R2fs+ETF(=ONC?KxO5Xz)~8_$Fk^+jptYw#=%pp8+t zc=cV(ge*K3B~DI=j4C)kvZY!;$3(=hKAv{~Q$4aG6VEV?!rj9Qr4YxNjKZv^=6cYS zp9iR$lqf*-Nl!HDEYl9a*(lOH{JZ$RDAN=agc>OPlrs^vgm{s5o=-lpQNR<_o7EMZ z5+=r4%66NX%&4M=_kDDc43i-hXf{qERLLA0I>eopPMMoD(F#ZFum(^g&A5`8xUNxF z38*-D=#UbGa55bVB}oOt3iIk_z{W)N!(W&|7bSg6vN`AsA!$P_CXGl~#pU3XP(l-Y zH@A8XRUqdeo)(RfdJuM`P#$83g|+AjoEPZ)z*4S_ZIr;%5y>(4M#Vzj$78f)7!bvV zP;%8`d&iES_1PG1hykBB!AT+`*JRV7uO2;f zMjf+AFncJVAxk7d;!VK;RROw~SGRHAvwL?qzL+WCZzCDZe0l0MmgERt1`30hNzO}g zYh|aRqZ$ErF_UBNH*$In%@s)ysZ_YICkC48ja9}l1#}*?jv$!l0%pn~4^6^xX!~IN z%Lt<)t(*OPe~%0yu`L`}v$nYoYS?+7axoZ^1);uawUX`Dj-K;6*?LUL0X0R0fr>|o zC?N$nSyXg>_`Cweag?YN5!0HV>Ye~MMJ~X{^B%s@`0aT78#>SiPLNSgcv4zI+x0G? znRgs`JQVou5;DJ3fiLL#2~v*qag=;($B~=@WAyL=GII@RUwwrJ0?*<;o+ez;3|+ z`OmH|^H*g^noB=RS0F5GPu~Ia@=rP(FmjwJ)e*P>fv1kP&l2V~UJN)cE99sA-l2D7`|GY%HsAmr@{ zBFay;A3U7FQ*SRIwL=zhMLh(fR?`+*q1-FhN}CAdfE9+z-i6NM1_9l9)BPe% zUuMKnJOO3eprNlZPVIy~{>WT!H2L5M@${#PQD#%W#;Wih+P}YWpliprZMwO`?>6z= zy=Q;geREO4+aic1Uf67nNliqPnJd`DCA1L@1zLHK8unr?P%c`YP10KqoeVD|4F4_3 zr@Sq*AoPqt!%-i-Z2V3ZI?O`|!8uGktv#0WFIUop@j_}5BquhdfC*hYgZCvRvvVdn z22klP!D=t!_8I4U@}t=81BP+`bVNW6@5V9b8EV6kXI<*MkMl|9O>Hd_BT0@$5W`%S zet7`{Rf<4TwZy>jT%!~1Fhy*zBHor5%*tnR>JmuQLxz*X=}U=gOMNNgA}CJ0$Mu-^ z5OyAb{w099W9(;TO;=$a6byyssZ$tnahg9SyUF4-VM?M8P^}uOA9tUM4`T5R-Zlp3 z8x`egIK>M3I;m$Q%fYm$-ss>w1!_*lVP{e8?M8lHET3(`uaX`G`6ym9r(qnyM0F^o z0#Gd%;6=kMvUh!HAlL||`ro{Gv6t%IaSu<>OX@s&oXvxWV0L%L6n^UU_Dkel-t|7F zTgi3OKQAE@W|?JjeFX8;VGsF)Phd;G3HoKku$Q2j^|x9GQJ|pMnW?#B1PKOJxO}`) zF^X0`o2T_|PYgNX=s0N8x65qMp+);82H>_A4AXZa4}vY3>hX1ZB4dRS|0skPxzj2BlHO_&b5!C+L7<$P|7C~IWh z2q&8Z3Estm)_59$;#mGvRx}z=s3)ynTLIIaDy4*-LHj^_@HpA+b3h(bMDnhOX}V=F z6sM02>Jnkc@WbP`?|Q#)#Co74G}QPdVXTm}xqQM6;@g%ico@lwmIJXM!VBnarqV&8-*yM%>LbgL(nI&9hR?y^fLbWHxQTxH>Xb||ofUA0SIHN?F zLF8AM>1XPL8W1_i7SsG0jrc$vLcLQ>sxwb}vuxMR(yIy+&%WO7Sw062puFYop^*Zp z*w+=>z35Mr)GQ`?19tZylTP*S#n5oTWxrXVnLdCKGS|u#chmxcPaPI14r$oQ?j?MS zTI5^SmkxK*hUR>QD3O3wJA(8O*}jFI@50ht+mckqgM0VnK-LKE?Ry|`9%&5+KMany z`Y!#Z7BmuVmlmexI+F8=QxhZH!{RT>x^~eN?jZxdP;X4I!o3YCk@bW9xv06MQ$mWGMQ9mU!1GGvtwbDH-2&R;yYbV?5H5HK>G--?i=gtfZLHr@bK+ zYdzB7cF1$<2Z>8q0*kfGa7TYe03Dl6oHtsKuqIFldeCt|Sfjj%&J@oerHzU%h~bT@ z5STp~Vyfsvu37+EjA$GmYSRJh9G1UmLIy_wCAzC8e)JE58an@aa(O;m<{JnHF`2qh z_KBhxr1D=6CUA@rA^r*7~-%>=$osgo!C$l-0~abKLDh45z!yo0Bb*(x&rIQkx4 zf-1y&VnIdt&i!Hur!D$Ix+t*LkzhZm~t^QAaR+d%Dw z`Am55Fwv4PdkflS{RFfm+J-Z~CH|2Z+%T))ZS;tYR`h-iy$grUketZi`t|D{>+SXZ zB(e9THa0SZXVU^|M%>~y>L1eicrc8K2IUNl8C z^f706iBtpP|8aB(Ayz`nfRYq{0TlP(3&9clN#%{+J`hr|oAEU69nU;B8DkokL$a+E?ZXnK2nG#AxU zuRW>Gf5a?e3j3Ac+=i`NPofkXm5n)qI7*4!MIm(I*G7|C+N&N?yuw0#j8eJc62U)B zl^sYH`~r1BVgLes@S_{V=@hhPBJ=6(&G;OP<=BhwFA(h1Nq-2=dCLiW6AOjPa0G*; z*HZwucHCKVoLuJc{{4H_Ne2{9eH?B)n#e}Dgb`ag;kQA*T1=PmpgTGky?%nHYRS6*Y5T!hjfr{Ifc&758ejYk?>f3mq z?}77c+p&rKq-TPaI+RoZ+|59k^w)TelLRc;7C*_EY{xpKLt!_w%(F-LgOB76eVC-hMMFS3bU&f7K`wxZ zZp+J9f_OYYyK%jtSu9x!5S09 zVLFYtdI+YTGtY!pz+R*YK{6Yp52zfyD6($uKp~$V;CMvqGkkeLq(Fs!D!l6vvy1?9 zY?ZfY%BNN+Bgc$@QHDE5(FwoEC47A^q>_k+ zB{VymXIEwe_4Ch7{(7K??b%U48$kvpFM&q1Fz5qK@G#w4-NWJ74d-u9eXL@%JP*?p z5ZYd##}h3}-{0O+7^n~0KZVm}JtHtPsZ_w7P-8XmU&YIH2Jl*A&O6u zOGC1kaBqV?*c*??-SJ7FsK3AylE7oyVH6NxcKWsb5ZIaJQbNwyVOG}nZw8+^stDoIJPh=h#Yp4Wq*?zshh)WD zLFucB4n+$s3aV;E9p4KKnS(R?{cHzSw9SGE8NFh1CjF+|A#6=xL3*)2JQ-?mpCXs$ zIzKSWfpAY)zEnmZ`eJVLBbWUm7V6_QRPg>P=sZccycGad#_`J{|5!bdb-$7WBfD$< zyUa_x?hawKuuDe~F$UQKnA4ApWPw}<_6h<1V3dejYNpePIeAFt%QPIT0p(DQC?yc< zMSAy4p7rQ>14dBoU`pEj0p5XXE*<#HuehBJWdDGIU10(7IQtdFu14j;oXrApQ3RL* z{-pD-iUVT}$bSmI^=SdUcdPy0#jYllPVJq@ZQRlaYmTg2vL|^8V4X`=QBX$J>Y1_HOHASuR#6?eV!n~ATf7s9Aa|U zgB`h?uDG}d+g`T#h!%1J5H`pwtQrw;2jljzi)d{_W>GWdb%A4L5M->3QL|v+}MwqemvSPBr0^ zeZU#J7|33FF>QD-9ehee;}v-vfe9cTg4}oph$Rz#jFM3yH{6%^KHeS*$gzduVeE^g zmt6)Ke~VsV#4sMh*Pl5OX@@W?E$x>l;LZm?yWuSJyXSIDzzy<^^Z;*Jjh6AweVD!o zrcM0h+2=D3DT5RF-Zlr7nG7Kk+kvK~4H`?*{(Ki-*Wa_xC3>?99DcA~bVR`+OpIqeW>eh_-A$k-f&&+6gLht*GNVg$#ETRruI zVhCA%5y=kwgt#(0p`4&LBi@EQRB*qeNmS&J7um%(fTF<5Iwl=So=RH+FUP}e{PE*Q zMAM7BeJ4azkvF34mclg5bes+X8AenVlNLI}Ic6_20TRQ7dC&^i5Fc0c8Y+})FwCu4 zsaB}txbwrT8V$7SiIyafP9^c7cctvj(xq%f=>)0S0|!v?>E(kF7D-a zwTgbOOqb)1#~9CGuCO>%;5Mlirta?UY9~_!6;_`3N7tE%GYWI-a4R4(1G6_^zJ|h_ z4n~;}L8FeEoJ1F+8Cjl=bhx{8P&TqoSTjISXDx9Co!gA0g@UD zdq0t}c{1n)On0rIlM;e`D|$f|Zww;i5*_dimtp$S^zm%R6Sjm-=h9-ES&1%)?e<2}&c1oq0z}OC(&Nb&a==1&? z6A4NN@HmQjq=?dYdF5>n)N)X6F}<*Yhxo6e1y-_UQ8EN{0z@g<rcFY3F ztgaV96x>7;WVSoyL}b*MCKLB z8$lti&FZM4?pjs%U2}w%BR7l7?_AHY)392TuH83oRwB0(<3v-f9q;wSHK}|T_?rBl z|DeZvXzCZZug%zy;<&f(&%?0oA zx~(@DVumg(Kso)qA+b<{><2jPSH(a$T*#$jxYUg2$MZY5jYF#PUGfd1CX{Tcfe;}F z%ikZcK5ZAL;b+4f9@OPD`OWNAJOz}0j#M51c1Ma11d8ayelX# z)Ov+sbG!h36f$oSZu(do1B_KQi*Wi5%d=rHSD?IRk&HKDCbTcy^eS$)Q<$@AOfB=d z4nAh#ET{tJ!bQ)BPf0jbm|fIjKcjmSg{HQHQqd~#P{<~n1xfH^8o3;gG;+x&D8{LN zty#p}*$6%XG#4ThD$*&3kTEh?|Dw?yY#8}x(yNTX-j~RcA!}qr9>iFb{b$W zER#v!*vPqV^Xoefr0rU>NbY9>WD;R^fN&WxxpnJS70^>*<~?|_&TYCaMo@AcCYTyE zgYLi_&aSW!3~m+L)OzApxhTOuaN=Qx0*B6}BjF|9EHPJh`Z5rVbVYwI#5Kr9U6YPR z^`aQ~(MYyH-4_tC1U;3`_@@u{RO=qG$&lSE46ff8$Mt7vWFe6 z7At|P*!v-_y+Zjg8T7+wyTStekJrGtENju5$J@0lYgmo2K9t-Fx#?QAG~lmDz;T;M zyq3WF^eo1fmiLdktZ*pE45xwxF?42>o?vv_%^}a)An5Sf*ugk7__R$)ynU-d>DUoS zYGi^aS`f|k<9Rf51LT%b99Ms6;L?m4rMT3|V{U!oVkNv48n)?PC7bhr?59zDH#9QZc=f#k6PsjW~ zU3_5ARowDu8DVr7mUWU7BX}lwj8&D0g95R=_Nz14}&mq8r!&HKhmKQU9u!dV^c%!N*UC z=%4o?ZVdG1B%z7eXG!Cvli>$&gdUJYnaOE1mTK}`9I98`aDJlwxec;rFVtiHS|bPm zq&Wa_!msoHwD+B1QJ>rP#3WYKdr%|TIK}}%5Cla*+DVM)SU^RZG!+q%CUs~7rf4pR z5Jv=+W~3-xMHq?{jfjANQl+a1;|xuKp%2`(%{l+)|NTDqn|?@Qlqv7;efPWf+H0*{ zM1)CDeGk@zAGAMhiWQBXYo1K(Z?d1PEg}{Iz>PH0*VIcccu_64PnmZZNhZ}^b^SQ{ z3D`OL%l8s04-kF_+uoo46wSc8Y}^$ktG+SK_uP|)8t;ZPuU{+`%_;qr()v{>jJKhd z+&1Qi73nUvXBhJM%pd zV_iH@W58GSxNOOY3vYFhIQ2jn1_Y(kmWN^AE2Q*2hYEb$aY)NI5EBT2%#LGbhGR`x z7=V)`XaZ7DTp==;r@ZC;wqO}Sz_~^>z%*itzn&|;r7%}W{7X396%JJ>khwJ2DH75J zfPD~Pl1!|8NRYE_trchnNxreziO-J)az-GR0BUF@uQW#*DjT5e)GH(3zk_3OC4GH& zM?BUMJ(xtjeCiS%0hLsUblM)rov9OvxN#epr#X69#(3b!L}rmZQ2v_K`gx6im{BTO z(q{Ik5Fo5G`@|N&XQn8NRM?S;=*VDySS1hCA*rT<$>Sh?+km1c19Xcv4|A71MCP`$ zJ761xbi0agL-;T$#F%C|JI=lN7m@qWc5+JL zFk$@+O>2ETPm*>rYz9*g^%+DSm5O;9KR0K;1#-6>oK9S(sl+I11%>bkK6*w6d(09> zZ*q9%r0f~DsJOD>cOsdDP2%vKw;Py{GDUggy!p^T>TZj6vsBXL+FJ>lZtq@{ncms$ z0Lu0VYXK_}UGFo~ZV4v9+XY*0f307WJ_1y>HF+2_QKc&!5^;XsYnaL67u zDVVWR5ib~1=)fK9G^JSBn9ut<4JIN9-tv3TK4RlyM~gZ)`?%vV2j6e!&Fe+luoC`s^$|7PA(IJQeKA@$9)w-~Q~Tw)|w8FOlY1GtYFuLJuj2?Fu;9 zENWn^1mI1k*B*p{B<0ONhZ~PQs`aQJ&s$oX_cb1dL4Kv*O03t{th zuW+lHP9&y;$mrxLZUcD^#H*Kd?c_Uw>as0x#y|6dDe+1v?ixB#yuhZue)g(W4Y?rO z)2mLE#iPtvyhi;H0?d#P5pU0jx7U4Te605;4MV7RNPM@bAwdyKNg4;f7YwJ|`1-~~ zC_;wp#P5qj)_4|qn(t_{9Z@+dCl3;VX&YeJ%I{=~SCZ=#RXv~y_cy48fPW&4o1NYR zwLLP3>_^+H+Zlzi#W?7V2$sYb&Af~#y}{}Ay&uS@upkU~)LERN2rGT`==9*oVWs@& z<1ge?kuM67+IoP?%;b^!0mfX*foxTzUP?AeIm!fqiY{SL1m9-6V#glu&|ZC>db08ar4zSJiAsof7wy6 ztkB=D$Kute7%3QTeSm~HVV$<`8Q_ytjKF^?Zrl`0%Fe&I7Z2$ne7n#LeUh$eO4l)v zfzcmrS&`U8lvU7Z4N~DzUgB(7u?jjBM7c9K>7*nlaJg8i!jZ+Fm?rsJHfV07<-%cp zL~NM+Fp!+d&+Az3xj)GR0uX|kjv+4I?ZjFne-B*Y1=AC7XeQ9f9t%2&i;80z+6wBO zp(jAYmm{{nEvOy#3CH%M_aLemEg9#dpQVr1@G(kSHaud~) zE7s^8~jhb#W1r6Q^cwH!ES8+Mr24HBOeX}A@~6w z%@7Si_)^d}puRBjMv}ErVbB`zkD}EHW5Zxb6_W0Y$OY&(^`g&1OaW{Px&VozD0k>z zDAJ5c{e)a3PB{gRojyduAU+&=X*Bx)pqxzXAh?>w05pXqUoR!QZk_ZhBfdy07}hFGKFWO!WIQ4Uu3D z{QCbU`u(pms0$wOH=w~3uyumAkN*s{yetw~5>0m|mK+=#QdxsZAjE2>+!hKf2#khU z%pA{5|9}pM!FeX3sYZiWp-pPrM4D~qh@M38O4~nn%4Ej<)iJZl-&vk5TGd%txrh6v)8{0yq|uLIKpox@^yw^Yz62-ggyp3r@M)W zL_A|49=?gAnwF2e4}(YaC$wwH$ng~b`_t?}qL&?v)oR|T_PVrxFkUl|EU&;z09G;? z>t{KzU1neSAAh}l2@xTzFZYmamC!?y?xW-z*Dn3BiH2a9C<$zHFBNs>$(F=eM zV27?Ol}y+^refnOE8zf>Oq;ZWq!D%qs$0#mB_c0JVQY$ZIIb` zAL33F_D4~3f8E)V25X(9?$P;89LL7bu!D1~%?1CDHhfzS@?xOZ2UVDQ1R!N9}1-z6$*3mZQ zgrjK+o4yIIWJ!{D9E#}zGHM4&UY0otjpLDa<+qr3#CF+k=yS`k~O1Y{tLhS)>A)u}0l zg^nqxXHV7U9y#{gwzrorf>{}5O*)OItk=>;M{I3t6k8uC^;Ef9la>6jN! zFb3k@0FsD+$P55eOin-i&w?X=%XQaJ6tb zr8$Y)nCskmZK`$88k)M$>^K6D4M;%a)3MKXXh4E)_+}LO&hGEfy?DA;0bOY9eTc6% z@f+=u@TO?caD@E=l>@!w-FRDv(e(Fydts$S91AFU zeTJnb9Yy(^Pb0&%S8EoQ3*9x+YYbS``&ofy2~T5eB5s1(O6Eb-dZTCqi7WX7qI-9< zPSmauar*3bzcfpqFb&NN>`pE1!56vax*N6GE*;W2!kpqyv= z<3V(?SuHM496+$Sb}9^8-wf}FmC8<7mo?}kc7Czc7R-SVXI^C3pp&Hs(kx~S9A5*E zJpK$Uo3}Bfh$D=xD$dlyn2iS_YQJuflY9QhspWEqO73C@T*2<%#d&*9Jp@pXY;z#m z02dkYXwvK9vo2=p!8iLdFff@$6Yw54?A+NB?}|Z*=&U+Br~~=2w)8fIWxj zcB07?mD?WUUg@~n#3~HkEE!in+!dDr+{+X#ffvaZJgjRy4ksjw{AO2Q^en^hHeym= zWOQMFjomG>i}iVS1{l{n8%_xRsuV6d{o2eMHrE?Jk+9(vcH#yMAuPX+!?Ts*GB@n< z3CU+z1PR?N1j!Jvaba@xiDhm@54PkMT*5UBK^+6;OA{5d1ei8$UkcC?F@D_N+2Vt4nk)!>Sff~v=$Rw>(t$LGBU5olR&F=)M)hy z^1(}cpoka4{6HMhLK3VWEtS@B#Js@Af1G-R6R1Bn3#%}j zy{hDYL;9DXVo4V+Zlb5Us^ru2v>z0yXPB3JcCRW-DeP(3n@+^X-_4##|Ac^J;O_`J za!}xV8dbOMG8uvq3mbbI5$YN7zFJ|FwKPbrZK4};+UmPt8?P^?ks%47F5n^=*e`We_tE$%g^)S@>7hDyRoDdv@jjQWoY!Fda#Dl+&^?<=d zkhKSryUURM%QpG|ujR&>?`vCp??r57hJOIm4eg?}S0z}XX8RTLqx8IP)2V zDpBt>5|73k#n~)iABft%xqNhEoWH7T8=7u1K90zs@O7{x>l(VM{d8mi*uDw;##FCX zxdUT%x5F}6dKZTd%c;QMh!G7Uwckl^POW$vqP8T_*XnfTFtj0r9xW#XcN4?8ShO?? zjXYV0vF97Yuzs-cYL9o7m@!4XjdI0VKGl!qcso*A3KvZTAjl`NA)FZwkz3papfK$p zy}lLpwfm-RR39VJUCew24(CbG;lO~c1)oh10Jy}M84}p_<hUGbGM>5>7+KOHl`Mv{=mHS2cg;IYgy z@Z}N0(Kx@Vof9DP-2fije0bGPW=?U3|Fc`(9y@QFR8(JN5v6_6er@qL$!rxC@3r{q z?JsaiC>Sf2+v!tZ1q*@|>g?x5NU(M-&f+~#h>Ocu$NJAT%4scr0fN$|<}Rf2%rp_M zvx_HkS&Hq+6IP4$0xlvqzF$oim@dc-sQ5$;Sg@BwCl`$AI- zXzX~5y6gANExV}~h5bjyR%jk+H@6&EK)MW2i}zA`HEN36@!h*Y`SgZEu&h1R3WAjq z6C>}U_jFBz9K}h%KC9(FNvDPmL&nb;uXlw3s!J(USUKwZO8*>QKtP^4Yc;m z*+3ClH8JzEa~*MaXQQ`7iHd6=lQdNP0@=UmPgykz&=_!*W74BzCw0v8(bngP{6Wf3 z5_mkTbFXN2ho4UoILpNvnplOm-!f-sH3~Mp)eiq?2&)@R3%yHcXfTduYz_=o=XLWZ zKJ*ER#Ft>cLjuyDU7Rv<<^z%15`)SxFhyQ#*xX+@6ZwcGZfJui@9icYvsTw6*WD4V zBpH6ALto$4JJ@8LgwH1+YjU_&F}1q8HSgbXz@XDW-qmXvxGMQ_WXXy-hj`jDc`U_3 zBX?gnZh*dTS7Eo~=Bn1F|1KDQ?P1x#K?Nl^hWOa&&c(KnSwJO-xf?e~qSf9egj*os8Po(RK zNdPmc6>xvC2-6-leb=?%5_hAb#mz?PH;BMwEtw5#)fliPaOe*V<=(ikYgv(cd(r&6 znq7Ucu;(0k7lRMa4`vRDrfbvDn^!dBq_tza$S@HbJ^2%`Q7}SMSBw9Z4Sh1z znJOju?8E)|-VUJL(NuJdIJ_cxTt@MmL3upYw@VM&1%6nEK`!@;HM!=c74By-T9#9* zvr?j3YAdA@0)>meptm5^+;# zh9`{6>pYGNE{zrM2>VkinXQxfbamNFqtl@WpH$5S*RS^>iK%2d#27#8#zmbHM1j|y30a?`Sw`m}EHqL1Y*A~wQ{2@eUl*C_&;$I_KMeTy;JcZS z2OBh+FbY1*m+{FSE7KD_%R6G*bfkkH9}uPHbN-0575j8RNhb>Uh&?TjalQ% zr$8%<)C*mcOn$3a2=q*eFjpRY9z}tOx$wY)T+_?lbD@FqG#Av z(-3I16q9=aUv0i9tUx75Hwea4N$-f%@W6}Hgc?G^o*F_u>GkunFqg3E(X-FITYQx5z=JS!R z7NPLfzo|py&9w=Kl4uH~*iKZIL#^Z2E1C4vk&Ty>O!AnvupNEPXj`iQqN-BZ2_Y}h z%s94^lh-vcFnGN_cPhYb4_r^^hV-^mWrZawI~19>Uyi$KT+F5MkbSNL*;JxM*ayrC`c5T`*_Ko6g?N8E*=MuI?|tu=n-J zz5jGyD6#D3t~$=)!13+O#`-IjRY{^N?zM_dmz*}AKJ}N3!u(Ut#%YeWmJip2zmX0~ z7H62Oo^$n&s2`qI@|TWkxfRy1{k)ad4Gm8$svg$jO;->5Y1D{f-2-@6_6$|I1Y}{x zR8ZtCla5(^P!_9@Hml<7d3bq^j{oX_tFADXo#83(<05F*cW`jvyodjXp6U)J5R5=(4dv>#E?<>uZXSIRX|kLue)>q`JCV zYvTP?A1vE&qB2_^Y|E;p0Uv+WX>v`O40IFpp1arGTY0GAgtZ_!DkmqW58lJA(gq?8 zqbXyDw7X}1GS84aP`D%i;F8kUO_3GlK@~a^(O+cx?uq$@k|a1JKK_0`}(4Wt;USY4wb^YW0G}IhRt!X(XPVkE0niR9X7CR zH0<&1^_7bbeh{6}^}e8)t4~aZlpX=`!zKVx zm2f2;s8;U^vA~DhWgHuPj9s*2?b@}>(7-SxbRUFlLP}LXsw_GG^RnZ@6R1$~;C4c) zHANJoVAWKD2;}zo+m$0z%}6^(CtE@(2z zG`w-u1u2l4i^?&GcyHdk=>~$GairSWPJxsH=UH~QZ@pg#zv__i&atVPF6miy+_?w+ z{QMAxA`*)7)9$50b<{+h&*e234Ok93Vyh$-ht*?xAH~mnm95_+QD92T$bE^i|pF;VklEk6-GGLyE?8lRTP#YSY{7t#8h?!atHC{VR_E~D9ryx}Wt_&7hy#^}2ews)M(3{XGP~|% zjmzTq1kITM9&`bsVf>MwD$H@U0Bp7^$#-&Htc!+Y29MS}i&ej4!m$8n+}_^4yra-B z3p!$fbSb!lRcl#ohqI!0y-IS<=O4MZ$Eg zslKd+Zj`Q-_^AEMcVBU@*0|G|_3%#0?8ffozdAxzscm8o;hG$~9(hVma8FlQUj;+0 zXaGv5v85>(a<>k`fZ(U1$%af>zD~1S{AhaY{qOB9%ro{BmR;`|8Y*R9Et zCBqzmmyQ;QSMBhtg330daJ0p-Zsowd;>-lhVY2Z7?P^$<8Cck9zWl3> zx`n}bxs}XdMk$U^nRBM6r{{|F^z_}F+l7UN>SR3E6e#Mo#@~pDh;Xi)#ZRsPc$c2R z#osz(Z!gbTjvchQrKJTgK_s|1ii%efu4BGkl^e*t?YlWA0YYuej=3!tjQJ?}>Nwk% z7^MJ!XWng)p4claye5j-W`871l}wXLK^+Wc>~?o|S3ym368ez_C$ufH$j)i*NTEp^ zQn-epOt_dgjUkIlKL(qcsZMRHPT0wNY9pXzC=Cw!rL&50b(sNWiqEgYFoNY^T*A3) zXK+$dl3+;L|Lvku92j56VFl}neL`(sw7b3vl(e_=^78V-n88Hq>eOBClp+_(y?_=) zlj9=k={NJHME<2gqBB6ZMMbkQg5+Nx2P72_b|KuCB8H_-so)NOcl(mkrfTi6Ho&Yt#-l&TTHfM7ELA6X7{T<~s^&C97Gh43jT(j3tDVST< z9U2{c1iu^1e0HZN@Q z3rSAw*qLgJFtwZW4&akQOKa;Td|$Z9#nU@@is%VnLPYkOYCGQhphLCEu!$|a-yz7B zn;h6E3{T8-YH-UBy?R+-4nHqB&T`ahC#w3}FpC_o7-8<5JTZy#AJ1;rQthLb#`c}e z;H>JMsggSW-k%>9VAqE3NJ}rXPiXJlY0aNZDbSl4nEFe4=1_aJW|+$E!^=BG1FY0c z8mZW`bFO);@07m_7|h0PUad|IHA_}+PlNA|fA(UTvRNx{z@ZKSMO+(4J3Bk!Fc`h# z=PTxXw0gfVE#P5xc6U;g^FFs}dyTJSSjpMhYH-PL9LVp@2$9y+0n4ufG)p&L467$I zP~?!2*K?DRJR$k!@m-cCWlruj+L35pCE({EJFb9K-~kk|0w>?>*jrm6fx>TO#@gHs zkamWnMzBQ$fNsnUwaa5IY~QbMN{+HtLv40FQuH&^rT6eML#(y;Q- z$Q{Z+(ICu&A-Fqgs7Ls>2BbsobVsv_r!2#Qvgesc3M2Aj^9M4+8d75)h(F`+)Gumf zJNy&uS`Lo1E#N2k&Y3`>B0O+?%X$n6unw4N?OY;=7}5)UbuD#(!*!Xb^~z3ns##EM z_u~4imqX$?HDgK1$?~vFs6j27g~Sf{mn;yoYQXqznB&HCu%0>wHB?JKxBp)j=N^B1 z1E&$VXXGWN{4?sdeYX=EJp^}Co&26Nr!&Oh&~{!C2l<(WBYW4A<8V>}GB zdVz%K0n$;y5aA=FQ5%Az&uIV~dHp%99i>O+oZIOZf_|smh$wgQjB*TnwAl>MByA3q zu69UGAfP}PT6bV5o6)9U25qK7$}M;N-NzcARUT=fP|#9h%_4% z*mT^n&~xthJ@@bX-#O2D&Wi$j@84Q;%{k^6W3Kn^CFu(r*3z$~p`qCzcJZt%4bAdo z8k(iHt5@Q0WJI0RXlPv9#m=6Rw+|d_wX@&aH9!B$>B*xQ z*P)@WqI)mD>pZc&>gKi;A68yW+P6pD@b5k9j!D%{?lgv@GdDHICB90%(Y3X6pBTu> zsIagN?wR^r@%f;Wem7l!)=m$+A^GS2+O^h8et#+IxEddZ{BzZCx$^I?l6jYM{QgRr ze#!RVUvWI3S@-*^XXo8l{QgQ}f5FnluiPUxUH$!f1=at(+<$BL{{+gqHGksmTZNym zZ}|QT4|~78yD4DZ`{?2B6R)rkoslZ!7Doedq2S;^pO~ zQC;VjLg%5iJZtshXEE=|aGrX@fBkFdgI&jrI*T4O<+)_rQko(L8j@zx9)A0FbsMLe za)gAR;_bEDMqr;w<2MYq)V^2OB+gDp~jVp=ro`}gmu*BiO##+%JlUSGS-Z`Kwc z9?qOTedpdi*|KMcso!pHWIK59{Fg6Z?mc{{c&Tck+;l4wQ_^TpfOm4NeP^7v3| zT!L!4QS)09aY;#Q2l7Y?af(tl1N90wS8k|H);gnG;`1@VQS0!Z<5=+S?iQA@GOm1s z`uHm9h1b_U`tlho`c1dt)6P%iFBn#bi^)grf>>H!H*sjY=KN*&C?4fyU(j2*V8(X-FBAz!vGhbMATZipLyIcNS zv-V)4#xG$P6q2vLqfuCnKz!bVZ!}~N=f#OE%+?HR>zDYP6LK1_z0Z{w{YJOUziA>- zJ$vl^Ixd60>Ie;LP3Wm*xrjBRFRyNkJ$utwBeWw4Mcr72A!Ene)&!SOA7SXsqB-rH7#b*3b(TCu_qugj*H zm%|e9L(am&g8sO9D2cgSw{ER(;F1l$lQ%zYoMu>4w6U)B#OJJ~aYzEw14;QUjO}_U zeKAqN)%qbWk=GmFWVX(06l@~}F(W`N$Nutg&gjGQ4|m6ehlh*$b?$K*ADo`-^rp60 zRlcZh&$Q~1$FoqH(<^=F8C@r}T*e#qvlixOr1~}vW%nc%kZdLXl^2}G@lK5+fQN5^vM3uDCzLBTwN&@P6T7@e;bx96dSeTs}WjAZfp&d}B91TWP z))j6PiAPx2*Ul%Tw^e_B!6TKpwyi1KE~)9QNm)WLK2m{tFMg}PB{N09cJO)kxgC0| zX=xE{6kgjwWlC$d5&{q>(nG5kfz*^{?B_Z^rN3e45mDq$#WbTjc^o#REZLi@HrCJ2 z%}}R$Lf8cbTWYh&Q*L8djMgoCCOw=i-eL6V>GS8&FVA=)_gVT2IlaB2`~KW=WuN}q zn9gL51l7#ywXxMILmaEKsfH`}?%hj%BvwA=6)6d9@)xy>ye>zGKUIrvaa*~5=QrLQ zqn3=<+qpF2ar)R!oVaqqo3Rf2!C+eE8?L0`a69zF#-fJ|amEda5z}_#gI5k~d>$e@brxxSxgCW%V*OsAM)@Cm!|OC+(i3ym!Brdy-zu=$iCp#eUr~f zM;C+KH1PNW$J;!yk|Yv0)ax<+CyW@u-u^6OXK6+v-f z7rgtULR_oalX6}m$_8F~GRh(%6r!XV$nj}+TgbKS{@ho69ML9+g&+IzM8=ZunF!qx zev>Ahi{jKIi_Rk20R}<)Dy>{!x4KvbE9Hf;z8czrr)&zPOaVHvSbKV`7;W>&SdGjs zF)=ae=0Ti*I}ab)8t^!b=!htpNvWor+Vt%#y_leqwtM;ouc0h57BllsDSuuI1G%@? zubA-{>jwr|1?R{FAHu0E{E7vomVLz%xkvdtdGg@h%~iYJy?bZq>c%&ti5&0%=X@8C z!II`7tDXuvBrXr;Fnq;GwfO#FO&AK4sfp9C?;jta43_;!xWS`#<3P;m+iUN6c}b>S zFZ9^JZ5q%noDdfu9-yS6p67g`?u}P>ewLi`3?&`)STZf%;L9uIFMEGKt!IZWpEk?+ zVP-n~QFs=dD5%3DIv! z++R>#K4W7RvQq#MXw^nW$+XXn%ZFHfe0)+-Y30iTTZMZEZ9mQo=eKLU>UW!;DxRNi zOwni1aO=3egINr9C506H#PmneLBEs!cVNBN-eUwsze*xi7EIQG3I@ zjYfWy^huWvT_1|gbD3eY>i%r__Hj7!$8nDAx%$t@DaWs?4%8oPs&UYG2);7aZNat6tvdZ;yfPIz8UMkwM~ zyR#gM6E(y8&YjhBv!j)4Y8lC8Cf_?d>(b3MaUSj)S~;^8D7jxLa$mA+H|L5#Ze8(M z8`J!VLs*QM`I%O`cBwSiDCwZx(=EUygNwn%D>pYmQ8H+CU8i;S>@7CM_+FD3AJevqPA(eHww>EPTCHdD<2aSR6|Z32{l^y`qm_%zdj)jbtE%&KKgRl*oQ4L zIvK(2!&5PGQMKV>TTly*mAfMR$B-Yh zgK=o@-c!iY)p+Yvv-UiB6QkPb4(g7vt;OCm$>Z!VA+nq!zy3dt{h~!`A4@eLAw#7p$+G%1a%e>=sY!|YF0zUM%O`Bel za@$gRT)Sv}dC*BEgpYX2uveQ^pWe65>$$*X+YVh4?Wqj0d(K|o?y;Wkdoss`hr8LX zywQo(-EvT}YKNwCN3v<@QR~j44W1jj(5?tg{df|4>E++0*nhnZbh&W+e$6v17 z!P$$|l}VG%bDkPZ-_thTHe=aNP@W>e=6r_LXQO07XsubLO}-|d@)n*pC@7MVmaY#x zVU_AgH4;0PpETJSa|54S4ry`>IV$er<9)(R!y2dDsS8~dL8>3`?`XKOY}H_yY0&*H?0IVBfdzG!Cj9u)0lG={AzY z01KWfX;|#cKX-robcZLCuZWu~;L`IxpsQGUXEYxGxBgkS6gIJY_wQQ?M4}f-E7dX$ z`~LC1G13S?LO^)Hsp1+Lk%Xh#Md2!D0QsD^cUH7ni3wQ#xKk77P4JP+{8UeAuu%5g zva!CXkou|79-*f5GHUs*>WJg222D3ga;p#O^@RME5zTzpRzsR;l2bq2*)*Pi_BxiR zHOr<3d2eu_CBx#(!gNDEFAn?q0r7!c=k6E!%&mgw%{C^F^i(FHyB8iP{ ze6TUhlhN_hn~tZvhh8yGq-%ac?^@=?3elA6)RT6py!+J4lt|Dw9?;^UMhq?rVWcI{Xpm}Te<#X+Mu7N ztHoD80K8gXRykR9D#3x}0mozj_v%n?2g`60%tY*}ecGJ*)@Tm@UeAY2B8e!Tec%{w za2`+xc3;ywi9|(zaxOzw_ zQH{0?pu*oYU<~m%jT6c6jM`UI+~=f>CV##0m}hUV!5q4QQk0k2E;P56%ISzdX|o%L z72}^Xx{O^0zADN4d}RG$mDG#5j#Ntl)APd-EY6w3gr$qi0Ii~uZW=Ts_aWgsiYWK` z!Z&hNE&b)k+IjhM#9!-IGNu`PIgL(gw7>7po&xa*lycfKLZ1varm*kb`z|jY2b)bL zH99;XeRCVyVFiHoUB^r%({k{Q@#e74mqJBv@aE5+%$Bq&@}l!c{~_VhE+FzarFq4$ zFV_r$xd!h{EoO2vm>6mmaG6fULFu+|>&xx&36%Elz2AJkygI`|+ht*Hg6;CFTZP6* zD^|*iBn8iagm8_ek+7Vnao>vk)yD1gJ4-zZ42;Li2;^RU&-O;IobVMffa0<0*>5!q zmsGWapg_83YUO@K;7+?OfF-Oi@ceJQ?dYm!z+SL8YACCmfv^b z`W}>h4xRBeVVz5+_{SfhT3;n!p>;kaWT z|6Z|f3@AF$A(?IrT<>Jfj-&ZDRA z-n|>sG|5w7Ne#EToub-m+LH0or1@>kwU75=p0&@{e#Fs?L*E-&_x;|jTg%a~Rclqd z^yxj9kG`}Q^qSZ)(-w09nHP;qH;o`<#niK`kLI?I&0Ai(E%A54+r?<*DSyFp0j&nD zHJx;tS-S=jnB0w}E1ZSv7v?8Ka?xaKP%ZjvS@FHLz`t9Lpgt2mtu@Og-BNap?MehN=uRZ-0Tpw*2VnuuU`21g6wxFrZ zjS4s(Ajpk06It*3SafJ{$Nb1X1PeK-3~}C+e8JrpV3zjY!Mq+%dI3FA0-vgojiy`W-XBaqA{@ifX$4Wf!$jD;wo@>HEQjR z%f~CGe@6WIj7sRZ>d=0wXPED;iU{Alb!&LZ6P7rc5Mft_bi|M=L*;dFDugYI4P27A zw;)UEypnh;qoUZcke@qnKJ)^R3Rro0YX_Rt>T(>cJasi)s82z82IvJKL-*a@p($H{Nr7pN+oKBm4ksVO~oY$00ft zrJ4zAV1!6-vq+@#6CAtvuRpJGnFf3@m>%nkdDeKHUugDcp+-Xo$G04dPLCR!Wxq3? z=G6E5T&ajkQNNBoK%dye1{{F|aCx%m@V|J`@r>cmhQRCs7T<5lB<>t&N{iDC?jMRl zIFruq250BPGwwD4IS!*uAxC;YQ_|OoA7l9>J-o(b-gPs9Eez7V0Mv2V1AhUVSTq=v zGH*tq*d@zW_5z{QqY(*n1Jg-6w~a&jQd0hWR^bRhVJsF5?M~oBhLe$iW*>`-jnP1Y zCkk9HwSWgMFx4P1Kf!GovPJhd|@zO(a6YwgG}(YiKH9cYL{#)>gL(2`{nhhjka zOXn?eK0eZT7OlR_JEV&!@Xh=Cx)mH)we`1LsT5Jimiys;_rN$5jg|I@#_3;Gxw>b?9)y&@sVU;`hfJsCHXpb)uRv8-GB#K~3a?*G?0ra%~}qJUToo?WC>4 zXcAIJ5%x^VL1bu!+KsNWD(RcLOP*YqXtfKeX)tx+?x0j>3zR7lW*(I93AIhkt${Tp zlt?@m8Y3erpp9pE=IP=gQ5~C z6qD;bH9{~7IRES7Za0#_nQoxtX0Fn0Il4MI@FIHw5h7|%H~@gGX%m+5wYI9BKne3# z35jzY>wSr&8BUkgTB?^4140t2iG#n4_x*(L=cqI3C_P{wD~RT{BTWcE_PF*8Da z@76E_w}%eOr`w6WHIUsHxTUXx?_leCI<&;mP?o~8+X`+hV=&!@5BCPi%Fi_0>%)f+ zy?8n$5cV}{EXR*4Yr0NF)QGhwbOX0FV5t*;GITObU!J~A6bqZa>W{VbsH46^M+3RJ zltLHJ)zxQs`~kqP^;iOY;NWMR>al16PY7-;-*x%&Wq(13Hz1#1bl9DXBeb*4k57+9 z{VXo*DX@HnT`a{3C>#OXzNei31&_Whz4MgQd|WdhFe+(OkRRiLg!=MkhUDz+Gtg}k zY{aGz8x7=2gs?mm(e*d)A9^{S*l63LNh~39|6{-8bcn|JK+>sA-LSgyBI*#3|1YfiwPb-T+%>*X5n<6E|Ei}2HM z6a$4QucH$VB4g{WU2$NK`+-B(ZrD&K!IkUV!LW5G!?AwV`-Y2L@a{bx1*Q) zU&(&mao|94Kh6ZGAfkTXk6{@dhjS-*uNJsl_nfnB0H;btR2c(TL{j^Vv6*WodCw{q z?f&ftP%c0%ahAEQR9)`LO)3#M&Rht!Ix6`%Hq}4_goqBH_nNAPsJl%4?+A+(zg+`M zY-cAewsC2wAs?@{W?do|E6-Z~{Agic%|Px^gb@S?b)2muX__er1QII9_-m|LpM6+V zUSO2?iWB4_gFuRqVbha@o&^Y|!A zq@zYo#yczG#06e(2|Q^hoj*4o;5yZ{qa5-X)@HncXu3ojMUe5t>5#?{qAUTb@zMsShVgAp6Fb<378(l&ufAvNc` z*UpzSL)kJuzKZ%Spc=>UWj3<@BOu z!94_9!s<3Zi`LjWR6GH3 z@!|HQ3ycnDku-kB=98};KYn~rLH{9Ih!t7O%l^0*3cM?Vh2ruT=1*4X9w%l4urmk@ z-L=-NbZ;83PXikhQFaboG=YLjbLSAa(2U6|0X$--{_iV2St;cg!2dA;%0#4=D^kwE0f}{S3pd;Q?2XqXNwn zDO|8VPKm27{)!yY8KK(?4MpJ)98}bOh=;|GO8m1HGKre`iI7~EXL-pZzr2zWnL|Fb z|A;D56?)1ioG@&iuIO=zw*5l>>4|s&P5=Dc%d>z&@z2mUl0QzLJ{?+iv8zr=Qvn39 ze_e1u}@ z-rjQ?H5#id@$FAeoz;Q59$BI36|dv8V`5ilI^Cn}}GYq(t;F0o-}agopOY z$&%tZ^hxD%2@$#fJksp|-RYFpDWjEo#>{ZS@J7od*x7u`4yPuz#{< z0T($7uojYa2b?G&)-_f_JX zBs}d>_0t7^JUZW2t)kt%+Ime4uSrvF+&J3d8uYE&vV6yKk;@4jFQ&)@3$ltaiYWX7 zoBAy0_D_5|?CH0EVtAQZw=TCTGACAc$YKT?EEl5je4noHVHr@_3O)oFIn=rWM>2X- zByiZ)Sg%=f;hz(v+{d46*;UHQ!ST6s9Qno8>AkHI@dQmn{Sh+C2H7Dd3yxXP$Sh54 zTu!;KzD9KKpVizL&znwE^Bf})u&; zae3A)_dh$Ti<}w%hBD~#WODVBAFp1$5;Pr1D(P)qlMMPT5|m&JI%h&=Ug#vY8BIwHF4i$dsgiA+0H-A4kD@^44`u-;L+9`pZlIjT`(b zbX-I4W}NEkp7hkN$`DO-r!sayIEn*UZzbpz#4eGPxPAuOqLAspMztH~{zQ(Zy;XB? zBQd^MG)G4t!dd>9b1jhctyxJBQsqdykLnJb@I>qDQxwi|Xc^}i(UTf)Ty2OzEcCm}tFA???rY7nOkYE50-YvF}itFl#R39>k_Jg_{upJ(49 zPRh8i%zA6}nl)d5?$m=1&Dj#g51u+}aFkEjpO9t1>j=2uMGYN+=m;pqd6$3(;HObM z$)g}<-_%lqDsJ7reI@U_X6HZYv!G%0d?v{{0O-FmT;%0_iJ55&dloBv36Rollo`=l zz`wMZK*5oY0US6oXoyuqiF3QK{EU{C7TK+MtMSDRH{Y>t!-fqw?e-^!YX~9+SM^-J zTndh>JOa)Zh5@wzJ7w79BE4KEJ5~{SonRPp$QX@Lyy^Ljd>iH_&j1pVy!OX6JX>J2 z_XBc#&X6{0&-Bm2jZ&Fe@nD-A2NKem#o+8Aj28jLsEo33cTVGgQ=!GN;=we$pMu2S zp<#atk*zV&wNdZ-Xwbjs;*-w-2>=IONCw0u*f6(#_wh^6!4x5Z3k`*Vqa+`R2o*T> z#2VB8CCsxTL?j74uo^J-r8vceoJ78l$y$Y}Ms;j8)1zssJ-xW#v#{{2G!$0nx&(A#-CMO64OdyJFoc3M=P649Ur5G9wdJ|K1&9iJ z5R1R;|N1%%>XE*RPEIg^5NshKEQ#RRKps{fl(X~Nb!&IW=AB%s=;)Iy3S3<*#G(- z`Jm(BM4MBkMp;la8YvRU&p-UmTp~X|Zj;t~0cBF}^K&h6P3YM2z}aKS5^>0f#CYaG z%Rry}vtMLk%6opMePN}}^_1oPxhb3f3E5D{R(MJEN}-8Bi7kmy2SBwZg z{Q+cm8jxNQhe|TO+6JNNh(3S{8^J0a=ajG4`O`xN?T_vIw-UK-D@X34e%kL%{A;G^ z$T#u+yoRp`;S6Y&O6;vjqcfr64Qj}(gr~T(Y5!8in^%aH^v<0-1b6&NNt35K-rs%- z{y^04aU$XYU4}HeN4v~&((8a3S*(w!2LyL6=QW3tai6q+z#sik$-ltql>piF#8s+& z9KhKP&UgO;&YPg;o^q-SRO#v%AiEMfp2S|_r>lbvnL)%=4IY>;R+U0Mo@;~dqhUq- z5^g6;DcAb>QrHUa@IM{#nZsxf0Pc6#?y981|f^?t6vIo>G zZWTm4--H)OmgEC322lLjd)quy;SpXK9TcK3oq`u8MtE*aF5ybbdEjEHv^L^o13S|F zaNTPlrrrPRJ)XS3gXdI-^{5_)k3j<<$RB3IIPlSZc=*fkBg|@Of~-6!^JU}qiok%cc3rR2rWxq{!h^NB7W^0 zRojBX0gMR03uUvr#$tV86=6x?IFf|6?4z}laBdoIb2dT?v!iP_Zk)&%hJimCa!Oyt z=r#jl!9;JwfCg{x|II=%$Rl0L;$fO5n+L&O{_(zZgd_Oy;Vc1@&?QJi<3g{Y4n7zz zVZxP~xFr!RO!zVx!C$vnwSmc$NgxEfj9*Eb8F`8T5m9pM|m)jU*H4JpmELV668G zk=&(*n^ht0Nq%!(XS$bow`mHzr2*JLOGo%`6?%jYs19CfVo8NF$ULh8=N&P^N>oj_ zcoa~b4Lf&vyhMB(<9w(jU%gQ{vzeYg78@0Zz37L)gn@-?O<#$zj~>)kajkH9)obkw zIO2y%%PsTI+mbN{WD!7nFykj7@acWtNsbR7 zMGeHNKo3XMTQaNA<~n0Ss5q!=H3%cgm{UF^?Sldds1LaUnh~7{$8GlC!$3b%+!kiq zN$Fn3?+V0A1RTN*ucf7xwrd42j|F@}C^Vp0!K2hcog@q}Po-ekBA^w9;|aEdY5;H} z@zA$AC7aRae;9E6ycyOLR1Y@b{u`Vhx&I|6kWJJJih!Q8w{s|m0w(J11Z;sH%o>=P z=!KEDlu)>oaEt|M!Cb(3i#{TVbZ@QXS`yayXn?7ub*o={Z=g7>9g9gNs*~Je!sRrbmJPs{ZyCv=yi{$fAM3{Y@ClAb1 zim32}^GllULs=Kw=D>nhhdWJq%^!kg$xj&ICQaf|a|kE|<6#rm3Re99VF@RUW^veJ z(Kn3L@wVVFF1nPGrn!L68ukX!;Yo>iXL;88vOi7H9vbAjAL&t>T+y<|s-`D4Q|4z! zWyGpcDhBH&lXA!XK_q=wV4}MMyGo>VP`?7xM!}!%CqCN01i6V?;qwo>^$5VSzDHXS z0;?merh-Pm%rO*6sghbsp01>0zQvwDvbiwDXpI_+w{vF0MH3Be!U#p=EU~`9Zu1T`(>(igM&5=zf4)=B$ov9a#>CEU;bfNBW~qc)qvmhG^anvH7a^Nz zmZ?7goS{R5dFb-{58`S}Jj@?PcU7P}FuTUrHv^ez8zbXT`mZ4!c;|K^44@6EE(jyu zMg2^A#OC_u)?q{e8V)h+;aEi@V~~!9_`MhetPfQM47^5QXHtcE&DvUq`TTRaYMS!N z@EXb|>2~T9R0jyoC5jXz-h4A2QdU?&Ul9U&nfiG)a-@q*kV*}&9mr$iL6&2Y3Fdw6 zpGu4`BmtBu+b!!ZIPDLk#x~e|z-9#S;%4vlWgV3Hr^2GCb7N^!u^tCD3K)H5y5 zfq}4&D+eC2fgFRry8VK}it~sM!WkkP_hTDLaARt~*ew@2H|j!Amfdh7N)=uLpYdB; zHL@U)?$K+(|LOCijwu6QCZaVUzQluyzIizA4lUy$Zu6JnbG=)4+)v2Kb_0`eOHXHu z6!JVH%q<~#li$~o*dhKstb$a)^(rMYtA^)DZz6;!L>J-MPgzKykvRU*u+>8Viv?@( zeWGMN4!gV4<8r+k=&ebMZQDMvX=L48qjs>QPuNP7A+*=NHBt3$o?$nbK`%Cxb)VT8 zgR7BWVR8tDxf*V67kUxb9Nn7_p=L~`wYFZv>4l-?KBzv~g_N-CNw~U*V|G@bQ<&=s2T8TRmP2j$y7qAlZ-98 z3_#^N`|AR7yhBSdNK#l7&z(PS1glM{KVMvBQAPmXQ6D3bV`LZrmOM0#wALpyR$W3+ zy`9~yIgf)N2xKpbS*{zLq(99tCa(ZQeDChvH3kgGA>-3CRVcr`DXY$sW);}_g^~-0 zan-%dC!CShy>L;0VYeHNpxxj(PUne)cCqW}u z1&49ZSMqeugsvvm!}sssFI6mr8J$S*Nz>@Bs^Arn&v$is5}VbBCckQzSx$$I2>jAV zUefn0g6Q6=cly8Ia0f!9W{ZsAreyZlpR?vF#naEKd?W}NWgY9b7%%m(f)c7^?b@|1 z4U_n0{eUorBB%hyF{sxX6WgEz6PzAo*Y+zb33zt^c$b>Rq_5%p>s;})v1R>KV&21!wXJ0q~!`Z(=PC9L{2zyt;K-u z>Ud&MGV~CK1B1YGaKowE#k6Q3#L-cY8C8U#BNj&>D1jLe8Y)yL-66V6$v$?FQrL4v zu)0!xm69ZHYdCam^J|bn<;71}e=Ar*c82(_0KkRln~$u|o&0{kDaRoNKw7Au?3QQ| zA}efi(w>xI4WaN-7~%~;Ao(A+c*Q!$XVN53`W*k)qd~k5gi|sa=1ei0*~O#hbzoWiqLYKmObO~Ff!G8|L+~b?Bq&N5pgUWq zS+w$o=<*!D-(_hrCDL1g4Vf54aipR}o_6tn#wr&{j2E$r3I42e@M@7BmDE*EwTw_S zE{4Rn2@wrqQ6y>`8A5~RM@a9jo3FWg9ku^?m57_Q!st}R=77*=Z?vEN;BGE~Q$;!w zd;lrHWJ2|}40WOk;9oz@c@=YztB2Jxs%nLgfgZz8y=aQswj7pgXrUyF3e6iA;mJ)c z6-a0W_SHmrACwO4ow(Zyeu@msge=zw8>$58Lxn@TAIwh`hE4els`e1HfCc*{W}k+^ zs2a0hPMr^q@fy`0de8m@DPsR0tF`M4{eIgpGb9E|6q*FupK@6Wz4nQe{0)4 zB-c2!OK~83Ow(I4EW*H&Tz9=pKF)6Ip_VIXMr9#&Y8I>i?u5G=j=JoH0lrdj)C+z) zsXi|7p!?5zRbe`KDZfl(s~62W4cJ>>lAhw{PxJIPb`(%T#d9_I7t{`~e%1tUDHF2u1yfE3z9GjTWb zv+gUB>JrtP!-``Vg`K~SO~sf(#e$7EwWN!R)uoJNu}BA2q5cZ74m`Y^q#=}M+S)|1 zwVRnC$WvJgGdO9OpP&vl)|hF7x{yK!tHMgm@khScepn@(&|bcIe<~D_FeArS^{h_5 zdJl6>aj?jnrq5t1#)W^!v+RzqsBk^?ff{-1+vC53>bJ=*N1!{q>JqBVy%xkHFFHh& z^0qKT4MAe{#?FbskL5~N$${D+2l^s6FYX{*JOs88Qw|PPfILGrl2eT{gb!1h*mS@b zm}zUrQ~;G*{I%myg~)sjqhs%0zvjpi7`~>rJu02K5;MXE3@lZN`bmC#>`cNkQ@xj*tE|n@_8kY?rLdwlhm_{v3Fs zW{hP;){JifaEiDO3ea$UnDp@N=G79uhdOKnkg2CbH{%^?hU}3BQn6UXBw^Zqr6ZB} zX))}C^5r8_{HqqS>`U-~1AtAxGDw;xoy8(Gi%+m6?j}2SIToKV%Vl^NdetIlZ3OiX zl5mQeMn0Nwf{(%jWZIoD2&ZP64N@BuQw^<~hY#Vf+GUp`Gr3$^Lq3chq3zCitp9?{ zLdLw)=dTVYf{BO$aw9IV%A%hiz>AMno!N-GV#S!21PX`XiSob`a%fn1GX*m40ZXA- zBg$zr<#XUFV~o+lG2ve}AOg1-zB9hyI{3P{g}!n}x+n>5_ZRoJAC3jqGQgNAnTy;? zPv8Hi~{#l61GZ;fG3>yH=4P(3-%TK-G`>W*ERrH z;yHg__Kj-Fs0M+=r%ok?(4+MqZG5sd;Tz)AH2vTN z%5}6!Z@!MB?fZHoMn!;R5r5!LF;^QTUxv&d2KhImr5GSE74hrWkY6*{mfK9>2l^QQ z{lPxV0>vS)m5Hbi`IL$k&!l=fD}kyIM+Hzovx%n@mYcCHI9v+53AJ9UL%Y2oD=>Uq>wt&9Zdeza)BZhdnF~ZW>_rvB1XG#9279kNG?9eUzpGC zOW$4u@f`L;GTl!2Z36@>XIdGi*fbpb4iKzBEW++fmifZLBxiin0TG-9n%R4)7q|;Y zzC^8^#QdXbg1KwckR9y%Nv{gELRGtc4cPmR@hvc9?FZaD%CvZ8LV?m+NG<>kpeN_6 zacKju<&TTRB!K>1VBX(RBa$6Lpa$*Uv!Lj5!oP2Zm7EBQ>L5PJYP)iwg-IKpM$D@`wUV{zL zRQ;Jh>Bv~VvtJ5zN9>0|^{9!+BO|~#!dE~jTRAw#Ng$p;ef8UBWBg}&tmGhBY3HP? z@BZ$GchGTSC;=oWnd64*vjHm47@%MuMynYoT;TO~ndukaB5Dk1v0yUJ2uG-UpY+hx<;p+rq6Nul zEee`>5@azk{tlTYYF8>GsCQj75?KzrI$F10T}-vb?Qns=UsXpw@oMNpf1$9QtjoFN zxsj3p0Hu1cWG#6-L?}TB)F4Ua#2$s=jfjP02p_dG7R@`H;6CpQ3v>H- z)Sq%+5pu`N%R0Lp41^HlFwv0#c2!Nt6#yLrkcjLu^O0zJ0V@cXt!ktEh1lj7W_v_T z)8P;#`ou;yl2)!BfJ}cGU4AW&vwWF12Dm_pljJSnI-5b}xrpkHEGFPKpL0!Hn+y)Z z^+CqvV1CO2SrsdcQV6~~5=r0e_y9r%xVORe0ogObCx*2{e zxWU<=#YYw~f1b((;;=4k9MvzMeW@T>>EIHaAJ7U+z1-$IknUvcM<(lFo$xN+1v|Uy z0EVwM_U@%)ng=j2ACRpVU8xL?r3Mf|T|)%Vgla3`I2JuWKVybhl|e-vHxkK#QSyJRvtg9II90pzXYq*P>>a@3KK!RVT0whRMCK%wxLpYWI|BY+kVGv7Pl6^L_C zhNcBYWQLZeCATGCa%J*!@M_sMb(b)!v{>!y4?`ElaT-(<8j?QfcI*@8+=$rL%T0cX z#*TF<$K+XX4b3KknUqUe4$Z+QA$*5H7w~JaqZ%b_#adcCzxC5}`{vEBP`ugTFZtao z(wO@#E(Q1A?2|8L@8Q9SA>14@Z>oJ0TuAMA2&6?z)D`l z-HF5s7>zBa=_R0mR0p{5^C%ORaSyW7mpL|ZV&`CI9WmfwC#2U(+TGEpG?_w~WYhvd zLF(S-&6}-}meZS2Xg()UTZ3|h&~=get7;;PlyHhn0H~S_MMiDX!y}SbgV^Wrs8wNc zLX&v09c&VP)lZO*6p9j_()IBRJCg{;sv3l3XNKek>4xK4>YCd zdzTGh@~#~SXq3SzLKePpM(3ZWgy7(Jgy?{7c3ZE{;>%AQTFUX<6fRQJ^cb9V)d3lp zGs#?6Tsd0KM5Lq4x*}CFWdq@=ui>crHmK3qe$Wc6xGHJI+O3!FZayFnhdxT56q2kQ z8kuG4i#d}9sIMKSwH8x3=$z^Gc1T^KxJAN;2!pq8P0q{Dz?(}J*DX7KY zN2cwXC^uQbe?*D;ExvLA!+jvIoky?Tf=lMRZ8n*I$J9uK4Jh8Buk0^~As1~adzJ3u zkDFgW3^m|KUqL3Uqu9dER14vQGBS>nvG%t^wDPa3@7U4STngYfLFWHv z+l+P5B=ZCgb4X&DLLN^gpC35|)$;}?>DOu8Ptq>gF1Q)@TagTn6@CgXsKrzhrc2Vw zbWurKMvltn^8jfFHUaZ>eGAa2p7Q8Rr}v*g#=4MxW%0zBC+#ozTb1BLgI46@a!{4_6)_F7_XfFSM8*LqjuqfAQ#l!jn7Q+1a@b1{vu143(X9s zI6`n~HA(^3XVRY6N_p+faFx%rMH!&H0q0E3)CyzVus*gXlngAsU`B(*y1lcJcs_dU zZZk#jMNTgI5mE=CfINmth)ix#Y(WWt>F3^&rk8FspJ7rXbVwAQ87bsBZ(dCpFuJ zpTEM~1!K8>S4p78;xDwsfp+7;50a0DVG*bFq#W^%5{fN4EJYk%LHbH{d>2B z$>)0tk2qiYtz_FVk^E0oOWYSkAQ#Zb!$lDR3i^I6lS0lx?q!O@=zUF^MShJ>((j~qsZru4PF(Z7b-&Id2Bor6r~i(ZdR^e5O7?+p45XZdZ5>u$Fy;9XeN z;+Hg6wf-2xX=whtcJYsp_}`V4|J~2|-({r#-MsocL;iPb?SEJF{x)FJ{C6Mme|I_m zcX9P1_4EH1E_Q&<^#I}zMPIWj%Qw3SeKRhnwFY&7X+ zX2+@yT&d3;nQ}-9+L$<~lv42oj3T^v_?H!8V2#hR_kP76gUn4^OJ+FtPc)s_NMm<$ zDTf$T>2anOXo-X_l%SA{ltKJBsb=UwvKpTl1cxKt@B%l1c?=K0v&<4u9*H64i$0)i zB8e#!EH?xOKN+L^Rwc9)b49`mp%v0^0iCqO~{BBMER`LA;@+tg-4jh&`0HQ3?#~u z*|*ZC5tc@?OSo(MR;i6 zkSA&&cBl`|G;+;jDz2ac?&mCUbFTZz4Tu|Daj{oy8lL|eb*?TdW*ymD zspQr;m>{FEqqtW<0W2Tk?&n}ZryY>STf(qPOu_hod{+x-$OH?>6*4$OE^g_AuR_E7 z$u%;?0O+jm%!$zmdbYB5E5=G(E%!|jZOZkN3Cx-^(1Y}7;rRZi2e@u{F z8V^;i7rcIqhD7FcKXJc<86!Hbr;V&BQ#=Gkmxnh}5AKz6&>Vnzf(Dz&*%(Tc$I%dK zB5pJz{Dx0B+!%+-n=gQhA{t1^k@YjvtYicU*8~u$-LP5MWjfqJ;tor({Q2fQI8n)M z73113!9tN`!3@!0s<0XElu_{63Zop9oN&kTC)#B}{E2x?WELI=Jr<*|jg^>_oF+HJ znVQ7qSGbi-%v7~bLvlKVgAVCfB5Ue}VM-%u(LM9jTRrJ0`D7*#=K}UfpK$ninnkuu zk5d9-xnzWS2;oHp%)C~7R{=CqDiRNGv;B-iU%CG6AJeY`zw|`06h}mfXjgwP5tgVV zH!pzaU`Mc#TUp6wkcm%(sC2`Gj%JozO7=|CQ>)L7t~OnQzs57Hii4(4^ieX2%Nt99 zyebZoLxJ4L1yc&KgM#C5?2GWjB@^s@-GSm@&6N-s7$4CiSAdi0hQijRtX8~afEy=C z9$F)zDQ14nVP2Yzle2={D zm0n<*&iL#tA?CVG^z=qBlh8rpu+5r>D6?J+x8>Y=4c6z3&nAo&B)36tGsXoJJAJ%B zz|zBYa1?5(_C;>UaYwb@-;y7Y!KHPNbbOJP$W_35OAg_>?#IaIPA(w7dExNLr7u3R zUb`*F;XKSOcmw>`3pRgxoXlg)bc6}deb~$Z3&y-7`0C3T0g~4yR)L5KK~~n1PcY%` zEm6kh{;>^YLj58)hJ(#;hwaBlIvgsghw20{zj2hAF2rU0g-at+C}mg<(~yNT{-7&o z_{F(#QR%=JTTt}nk95vnxIk_^<}?|m5JK#X&t(|Cqmp2ZYJQ}HIg*ogmNMQkV{cuc zN}h)wt44dTt^*igo|Z_I7Dx?|nQi#*-~eW%EAmkHgl1aF5a$<)wdxCkuD_?b!^7-=e%&IV0>0_pC z^qKTh7sy4XkxB9oXHY5gW zSB%H8_uOSER#z#$L!MIIY}e-cFi6;?Nn-(Is%$R5 zZt2#U4A}G}s7?3_@-q9GnLlJ8ffiHk9V<>gsV0`-YIQTnG~;<@e)W~gH15W$lf7y+ zbG&z-xQ5|OgdS1Mq#N8|iQ6Dngkc8l>!5DuZ~jt*jWcb*=NBq{KRW?$kP}}8w%7|=A|4y@v1wW!1Qny zi}0C2`H$OxRDS?;bw-@QU1w~Cq|fD4gUi~uiK7Vj3_k#6?2xJsPnh_`4kso1k*+MvUrx_XDlY%jv|%prV~f@$W&jy>%^G8q>5mp zzMH)q=J^{%8c#Jd%75vuCQG_zSf*^aW}6t=Q5R#4^7+nM7JjMS?Gl zgwL1wD?FVTjq%XhNxaTS9mfm`^->x&hhepw>(PY-GdJ-Ffzk>P(hx6T;)4nH#;JT?=tj4~Bd zsWAA9e%o}FE+*f8xG|+z`Hjw9#0kW|LM|;pFCNrYt&K9(Sxbq}gk1a;IDgs!Aw>4| zkq#We^?9@PnxDxWa}}BO^I-1OT$uJ#>I|QK^9+V+;^(8Kkei0b%08lKZ4f&TrrZl> z{zR%ore#08#36;o73=A^Kg^fu+(Q+j^YKC&*ojpj#s%cs%P&u_m=VCV0WUKhJQU}# z2`-uJngv84xa67LOfA}F_SLOp%$G%zHb*Ej&}0TTljD8htqx>d$LiL>zrR5I;>9EI zZJUa?5%-iEDXdTU>2jGg-R9EvmPEsnRA@}z;r;vfUZClt+*D*ACb|qzj7|!;Reu>a4axL@;fSwGX9^a$fTAHLN4B|!Gx<3 za>wy*J3TrY^Txuvoemdd$%(L(3#6NFNDjQ6#H!>kVR?Lr+$Ik(litS*zt-f}?&y57 zxq{rg`$z}Z%Qi=}hkTyiJ%j&G1)MixWtn*cn+3qn?s4`Hm@Ie^8wnE%4l+h~9TdD- zdYo0jLht$ceAxg$tjbCNPQ)k!JN|pEp;vHE4*Z|?&MdCUD-Gjl`>Snrw3ND_BBP>+ z8z>?>wpEc31qB2OLPP`<1!YlWiD*00R!}5tA`;pPL{LH5!Xkl=Qe;;mVaEj_Mm80Q ztjRntow=I(xtL$?Q9i!!ocFxT|9KA99xObI0Ambj=~`dJS2zM`=3+#;2gi`*ODmrV zuig3;(Qa-vxSiz;y4}RCYZAjRP70K>|CBtuL*ha;{o`#YZB{V|E-{GQ13Yw9W%rmF z@F_J(Pl#=pi`jVTSQg9~Hb{D2W#gb0A=VJ-KQYd+0c^-mzGj1P@T1#+w;fi!8r0$s zT{>uFM+}dOjEy@vyc;DE{EC9tJU-6sTKT;}fO=B^z@tcRLmqJu{wCj$Ux0o|mf^ z{3#Q@uU~->0KaeqsUpXyEnbi@=IzTnYcc+^-FItz&mF&q9cSB-6is*>bVx3&%O8T< z8@YNB0(Qi9vGa8UE^i>nqhMAW$8Gw^&3j5d-sk*cYV*QN_X<=*4&5B0K za-1$dD;xCDDBZgaBDA3Xye7hr$fI7`WWD-?WkSK08>})SuW`5?!{n7PHn@F6y*U-I zdhVXFm;SwKzi=aTca4BM(5Z##VhimlE*@t1}VV8Gfp)gfqK z@4n0$2Ucv%yL(rBYYJSElSt)cy+{riNOtKHa)IL6%=iUizNO-Z|IqCHNVMs42^zr@ z7`J_%aSD{OR3LlLN|Wiy*@g2uqB_Oa4k7pEId#_w7=g`SV>Ks98*l8IH}TQeRv-Je zsSQPT=jyc$a%B;fKPBL2|2+azF%GhUugG4!;F8vO+08MF03O?7ytmzaOgTaH;CrL7 znp%WNY_fEGhc~d;qlGDSdUm`19tefC*n`9;lKK*7Dbz9FaZ(^`dV^@Z7)2kIuEbCR z>Ht|1O$Z*;Iai(Q?_5tBQc&n!0h?0uHSch}g(o;1hx=#lQDF)C;TTFyngZi7`z@`Q zsNHk2fNeRD&>PwZAcyq#Yv9xd*a)6#@3nqpEE3z=fy=NCoX@a=bgq4|7}z07b9}We zO@1R;Z_uE~u;yJRI2C&lmC|l174bxe<+FMI+GUH4&fHzF@xbf-=VC>gnb?y+j?~1V z^JP#&4?~vMEH6e$d~LJaMaNTV6++jwcf0~d>`#7RipXdUMs)@E1^8~d6|N40yD;4b z#_}r;N3!vy%c020h_sv38X(Os#LZ2qnrmbRa(3Q4;Y)9}X`uvf$NzA{Q;Jtf233hhbomoMNSMnbt2o(f=EZ{x7 z;FjbqUhc;H;;HMi6zmtGxV7?jt47jCMmXRrY^jc)PJkNi_|D&Rvt|7VE5BjCtwSp6 zfD`t?!b~Jfys;(^k9ZERJlbd4V2!#O)m>)tfX^m?;PlVn@)0pp&^YMDG(T7V&nE!y zY*2(+@4`A368;E>VDMFDP;6!FyAh_LQ&3Ff+AID;n&$zHS!fDBP-In!3-sHaS}t_` z{Wy22qd;$2YNB2E2$bWXOhkB&Jg8j>!XnWKDb^vVA^Ql4^hMSX>%H8>pD!35^;Au( zh-Q;FAS&Lp@%J%`pK`6fzVqE6{Dh}B6+gX zKEX2@l&~N71$m#E&`*ww>DpMb&6z3xQ1KQ-j#9=)3hfv5?>0pFCO#+at)yWUaaE1) zhf`{j8lg+#+0DK>Qk}1kbfnuCyT@W;cj3pyaAQc1IS-Zrh$|<@Z@2Tb?WYk^0JP8@<{^d84Ghbhya4NxL36=I_fk&*tc~DYpJzH=veJ* zd#$02B_2ll`5`_=1MqNzq(57pXM$20g;*kRtefaxm;+w)F&z?(_D;s%&Y5TYBAk6y z5$ObccGMZv?yK&)n&-t0u{G;asph_=oN_YI#0eKVAsvbt4sCl;iJZaR@%SWkYm-8Mb`w;Rzm_wmcu5u)Gy@tnQQ>f zg!RIX2oGoamB2B_%y&wAuEKMJnYaCEr2ztHKx#m*k~&m~wB%E<`FJo+jx8)w$Q{)Q z+H8^IUaQ7{7U^WGNq1Hl)?<1c|ESQkp_WzCQ1s<;xA)F=4A4Eo&gjxPoS&!d zHQi=Dj%gdJxh6OF4J{@oFjN3c4zXnjYiTV34tB3ocdG@#e1ymP0{zifcWV|_*i^A} z@i`L*?j7veuUmJ<_xRY$Gks9SQF9Ru#kv=HF^;iNS={1`U3xp5a0q z2-+_z1&oAf*r)nfoY=G&w!X+SY5PuW&dINhuK&F9zH5sTjs-?|R-L*>n+#-!2H-dR z?N(4^uL{i9G)`|3vXeUXdo(PM`B0NX`H^3>N}bfP>K|i3_APZ7Ar3W@5p}@!iQNU= zK>-gv6XyKA@ToH;PeH)^$P+Y^k zX+)Qjh=1y{t>{dTBW)YOzB5$mg`^xcb-6zPMG`Hc$&y=oS~eMIj6NHQ&##;8TeATP zAmR^P`-)PK{Gd2yl+$2jKrN@FiQE0&S*=_vpq0(BEUxfAy+ZUW#ahmo1u<9tj zEl6553F=u9;&6X86h0%R@+r$Omo=cbm1VIambmnA68mZ#8W83jyw&Ggnm=nwT}+Ky zbd7_C_afsXLLFhxu#wdXirQmJyiFbz6O`@t-(Q?Z8kV9AZ`hawp-F>O(dtl@S}Pav z%~R^n;ssm|tP(o3`yiM5qf$H_zfAQq9i$4zl5qRh7Anz-G1T1)YC2mIBy4Lpg5gTYA zP28yq0^6~IVF7QHs+Fuzl;TG-?Wm1Y0?q!ZGi>nK(zEy@`l_{qSjHWh=u$3$bRsuW zSy9pDE4UI+Nse|)U-iVW#8qweYJ-R|kiacXl{j|yVKlH(Pp?^Ui4%d?(bn{#e3RQE z-N*|#ym=Mha*YBvA5VTM8lo!-l`}&PEv4s+sa1gAN0nwXeDOt zNk>!wJgsA@i^E)EAilnGIAo|+H$5)c;Th`3KJj+I#8EIBv=RScIPo~Pt3^vT=vRn7 z_S~$%@q|LyW2}VEPg?&7ipsQZ->nYBQ6dkvPNCHn`qja8ms04vBLM}5Koql-IJo{J>O>fEQCPW!s{ z^yFywBu4~H6!(bPz6KWP63?0L33UyRV8x-TMh~b}u)cdV?(hy%)5QqVrU+%1U>Qz1+w z?*OV#Y#>~Qc5XZQ4dbD6QD#7G=D@jb@=3D__p%T=RmhfYao|{k3-yN;1(|}tTZ8{B zP2BgH0r7Lla;C4A!#X7IBm(pR;d(y0vYawZrqU0c&diH3j+WOMg_pEY=cQR*AE-P{ z(_ILT3#2#lV=PJ!pY&01nS_|Nj^py3cAE? zE^L;HH3W|hSRGFV>|nBf1~+X5)R3gBq=@kz>HZs5UQ2~5g#Sn)Q;`Cv!+Rfua|2!+ zf&J)_dE(E6O2ayA3i*MhODy{}IVF>RG#zy}T@6&=RkJWz13B@try2X1z(R%OXoa~3 zIlhvz33c@yWS~yyMQ|V3yL%;K!EpjBvUx^R%3Tqfbv!sJ9zpyeqcKeL{NKIYiEcHS zV?Tv{u1D)$KKfL`YsM{2%1N%=_bCekXmy=8;UCxsNZX)0!%!mko^`)*Wu(y|xg6VgOWv{ooNO?iA~QkCwDFqK&~2b(7Se_=92c2{ z?xJyQF;aYI9f@6`U?59UQj0ly&3Nv7NPCWw`kpc;7f5-6aI{ci(X4JeOQCGeWW49D9P50gl81Z*^oowRtOs?=#MMh`dFd;=TT)Mh*@TGpCtwBpa~@vBjpWfZ}Bi4 zAb%K&*HCWIWks076c7Idq}jW?p3v9PnRW*|ZjeJ5WxIe&txyNSw~q$QFj(J-Rfvn@ zN@hB(PZvjsDF;Qaq!GXCc;`|CRF|2UT`{Dmt1f1!%_v|Fxibp(0Rzo;_B*SWrbeCQ54^tH5;LI{Msxh8ySw$)bBV7*4(co~ zQD(ijdgt=xJ_j%E*m_Q2cl2L5cA?WP2TX%R?LT=wk$#&jm?d~%xYnjK)7rL_Klnxc z{Sg~j&AwxUq6|6Ec^X=X&3(g$Nm4a`xzDg6)0*?{>0lcZ7Hcon;Au7 zSFYXM^Znf|0q2=SnE<}m@)0t<1NF(7*1cZw8W|xaejF^vk4q>gXi0w)Ye+HlIV?>V zChmQqt*!0zbFMes`kzB%Rg;f9O$~hZW%D2FEQ!c=7>_>v&x+%hUb+AM_umVNsUtjh zb@$%Md-y9tj}`f_D5tnm9Zl;J&(NPT`8GA!m}*?h-kj}F8DX<(&6?wGiwnoKveWT- zF*iCtNBwD=Ta9DV$a{j)KRabf0vvh-QRr@F|{amo7aqs)~Gl!GkVJ z-1~6!rPnvtsxNc<>vyVqnXNs4;@X#QGo$UPSBtlQEG%@a(oVYau`0vLAW+bbeaN?< zzc!&r{RkhQiqCOHIdY9zwx-q5ijw>{IxeP^MMfT_PBog-3E3wq#i?~FX|CR|TfzU7 zX;r+Ypklm6eVoX5_1~2v^hP7aymq9mfXDL3In7+>`ik6w_wOg>`V;!&C@pe$^eLu| zr>OJ8d1`sCIj2k;LN&8&dq4ZIj5h3KQIcYGTS#h1HTJvOD(S~wy+_;m_3U_eNwfW% ztHoY@4XH8s{SZV@R`uF!&tK=}uFzK|x>V(-?HYCd;qHw6%QBA3hf6t9Cu=7gj1!JY z`m&B{30ieMk_i%u!e8VN#>8|k zPMuO?oRAaVR~3fYdy1M})*n$gJr>i{+V$ndp}Pg!h9hv`_v0Dq>0_i`aDPU2Sk9V6H zXX$_0Bwh;GL?1kKh^pD=5{JN{Y0)lqy?OKIvl9j~!V}-l&b2NrMhH7i z&16}V!kaIL_Dv77J zh%O|GQCYQfH9Y8fl|1NpCW;u{ROIM|y!#UJ1)Qd0aSgl8RqgH5*|l@`4POqjGik}@ ze^jL#+tfh4QA@T%w!Wv(*u|!`e;q!20S~R>=^?QnT3gnw`-a3+$h0=J zJ5?MLubmff*Xp87u17&Z;cfq(qnA#fy}P-3hpbTBtv}VgpvHep3fAX5m`y%&f z*}wBzEDaQlpyM&R-kR&;J273S=V|!u)fq(FBWCKmYz4Q~N;R>nim@t5_9gL}S>cFl zeoeR8u}&J_!A6Sg5!oQ?%*8?v`W>t>m)~4ya$^*^a|6Usa4& z7`0Qy^`Cygtyj1a0VaoYpy=E0+P5#(AjshYGCVD|?B2a~UxS3zQL<7(^N=V}S3W-I zt51&T^lmEPi4w{8`mt8R&ZHrwxHpqUIo>+c`Qw9KGJXl#c_Q!LzT`13q}mNNW%!&h zC|%WGH^>!K8?RZZ=P4Y{rk<8wy%=cMQvT(|3AXt4K@C}U3FP0$1>utNU3yRwjcVfq z)hK3xJ?Hl*t=qU!VZ7@rkL!Z{U~`u8)2C0lH=ezt+k;diY41v%RG#dwl|{u>?ELJb zm~lg&$E-=?r_)My^+qd zV}?!XmdCYovp4w6%jCII1MZNEsQvNrAp(U5<+2YEK_}vDf3uOBIm)0cXce;vC+?s* z-SSXNS$(oWs{QB{k~1_lt%K)`{#Miw5`?u`m#FA z^6`Gb@UE}^{VxoH+KgDWxphpM(#xOh9FB0M&e7BeT6{l!b8={beC)e9^c0yyEi?${ zBynE>i|_8+cJ6$pqn>Hgf9=DE4}7M{=B*-!^a>x*G?1E9RNYvKtJQSe!W`i^*+(c#I=CvUeUQDnd(-GqO-NF^T2U$zOJe zlasT2I6-M?C!1Q;UP0T~ZM$}LQU*oPP`7Q}s&kPWH`J}fctj?E)2Jra(5P|49(I!j zG?Lxsn*!R_vx*}i6z%Qpv-Q!;{4C2BrtWL%BfTp6NO$pN=3P>h;4-Q@dR|PdNL?vW z=gcNX5ux%D&WAgXh48jIpLjRc>bBI(!tp(t%SH^VZx|{fBq0qq{>|Z;WwmJONDa3kpcCJfb~OD4pw9r(qB@G)~WJ*5hxU zdpS-m^%tAy(r5Y*TzH{fWitEVtcjp=d1np$Bokwr? z)g}ag7oOGHr)j2FFLUYzLz$t*+`oOBPw4iHV$4z>UwrqIo5z zXmHhU#I^`eH(5#fw@bU`uK03lZnEF+yIg*hd_Riics+#!%Lz_8T)<;z{#0l z1duGJ?G4KDKz^&k@A}dEdDd*)`$T89r~FO(q_ANH)1iY057w73NIpBNi=uh#jA?gi zpjGDLP;-`WeX}Kcw$H2K!_qJLH0_34a%gJeaIKX#D4~W5acb3Jk|J5irKW6$6IxEP zQ?sZA9w^7m0$MscuSU^H)o&OF)T^%>MuR_l)3(Hy%_?&!QMcd`+B_Y}zEv85B{pxY_Ig#=p}NNd{#MZ!W$5o1MCOASPHN;|A>>4y}pl zc+19#-pb~NAtWm89(IipyV+^x`24x0p&%9N<1F*#LT-!MY38jA!;`=cTrEqjPPc1v zC|mE`z8!@R3GzMOJ2m)dICtLcW+$@5a!D8^*=C^bGHzcoEe|b^#5m1iqt+xnv70uC zs2JQ>#^qFVlg2b@9^;xSB(bKN+n48Dj(t%PUYcb-F0Or5$Arf|9YW_Y51}FfdhRm1 zT11^P=X0Ehth~R*s^imB9n}P_oGLs>%^XLbde&o9(`HB0nGSPQif_Sgi@n3#O;ZRq0qWyt0jNchxIzKTAOG%&mS`55PqSyV zv}I{POtddLq2-KfvB-tq6R_zEJ#hBU2R8K_$JCIJke%qIG0F)>==`G%`M_1kMblO3Mk=q_cuThP{f z*#5Te-oB=cWOj}8t>zA;0sPgmswZyWzHNwxL}R8Oz@>Mmt28hM;ltEmcVk{7bN>vV zItQAT!&pZ-a&pHPpDtr0()pYEs&B7eE)O~1&gRc&8Irp=*T1U2#bFB$faRSyKM+%y z(D)-V>yVnOcJ{{nSeTzy#r+*etlQqN-ozlp*CLQ{qw_)5>d_&W;jcfFt*$)Hv~l9o zA@m>ATUhzGk^j-yFiGPxfxW6)9DPH4+j@g^{w>KD5=Oz&&-l2_W#3*LXC(WAD?fa#JgzCe#7SxOQ zg#suE=FIh=CzfMM_2IYbO5brE|Im7I!GV%izMt2;r3#Jnq;=1?RgG-oKvIu+4=jE4 z=M7x*3dpAlpmWc(-#v0f7;O>S%1r|J^$KxdWro?S^b#(zpr7GyV{sA0~vLF31>Pw2OC1*|2WiB?1Gld{~G1y!2xncLbiGWl`BKpebcQ zupeyxJjO~l^;7{!qyq(bS`=k*DK(g}6y9DHCjo9Y3uxIcB6wfiNISEjv4{cZnfS21 z$TLQ_;12TlS)QbL1z^#FfGeispEZB}@rfc&MrDM&#><;Uis-tRFa@NT)N@nJ#LhXd zQn8CdojxoRu-CjEK-~xTy2`4r3ZuFgz}*(+b%~DCLxDPrEXA{?4~8WC*aI;@{Fpdq z0wf}p7>m18%e0QF%*AjMen{-`2kKIDV;^g*#K6-?tFABQK(OAig1}8$n-U3@k>h-Z zAX-I+1>dXwp;H-5WL~84wHa<{?iFDLuz$-l_csUz)J;}>L`usTARe>I^kl8Jo#O_R z*MHxxdaEyqc;+{Ip}SWt<@(bgry>4`_QMp8=C=0fSH9Vp-EogdXXaQdU{Cuatd%O-HvPI2*=PovSc=1{BH{Pzg* zTq$b~!<;Vxb|af36PKxQ{rdIn$)U}0#}%VPM@B}{FLi@}XvnlNzR5AH)GG4)8D(}3)%iJ$$E0vU#biYNS#~gf(N0#(Ji$i{PFD42aAiIVlMzB`|Gwoti zQy>Ko2u2}H!slGA-IU+mP<98KDUs36ecE<2{dFsGuel@d)-qm4r&we!h#DEO$eHc( zCk#isbh~aUs-E$}%xFWdOV;Lne6LW``oSm=9_q@KD;j+W#C<@D&p!KcBmf&4)+Op{ z#Y{g&en-j%i_CTTn`evEP#-MoXMgwZU9?=7L^e%hZGv|2_p{_g?M+cJb`AT+py$ir z{ze;SxbtsJp6y?6K*>ZJN|J_)g!;jjHy!m5hbD(6#uoE&*X7HXjWAW+6rT=j)RoJ1 zo+T|543W8>L!NVd$ZkZtuJoD18)>=E5n2uS!$o9@njhr%ZKgbDTp^Ip z@^7#!cG>z{geNX#FXf$Jtl7Wgu++sgZF7lW5tp0#sC-X#_p&cFWyEsfXPL9HFHRUZ zx(GILUHkHU)$$9-u9Pbu*9VHYsNsZb(Y_`zYp9FZBD#055=N=Bedh0T=g!^K7Z+~+ zP~Y(szn_*8-Z3-&^O?0+&y48WAn0uEXjiRWYy9EfwwL@?;j)A}Ie++=>hw@^s>{5s zo8Qxe+jN=>>V-t@L|=1&sX2~Y%dQ>Xlmc3VVR-56*|UnT|6bkyKC)T2a(qr(0Md__ zPXRur(3B8bzI-_bg$J2-!$Xypc(DDIqp`N&LdmS7 zRl2Npt4{Nw43@B=O);U3vNMu++99ULmE&WdJlX1LY^C_-g2#5&dGLg(0KMlLS;3%k zTTjydRWfRc6B}G z7_Y$+R)aIe7!d=9Dv_M3BDp?vr%ayf)B^+uFjT$~^E8^9=*5t++4;$S|D2_O}P9mjhb%rXxqhsnW4WkRl?vPYmw^>~Udegm~@4c0Y5gR2Im zqfw~3S(5}b8qk8~g$HNdZ9D_`tqO&8zrAoW-}B5&_DNvXjs|BcQzlq7rkT^)88^;j zNUz3ihJ5<;DZLZ9b{W4sLAW72a7S>S+b8^Z&9x?bE04Sz!#R@-d&#MLlg#7KpYH`! zB%qRx|3;`}u{~mLyU^`6+_>X#&h(F)4?camDE;!JI6nWzTPnXl>j*;7b9!lhdbl>Z zOvK+r`xV6K>d9a=@0nQ;bHE8OxwYiByIm$ zxwg-Px8)KB;%byZp6lOE?_yC>ApFpQvumosW>V*;DFdD}C@6EY-NEEktz0f{Kbt zNTVF8+tv9zWlZHeCQg7QuB7sv0Jj}svu4$*y(ptn6Vx4abVer4nLP1~cGI2v0m>}} zWWa51+qZ8Yudia!;^PhxKT_Oy!6nh5AU!E+eK#=HZo&8HNRa*eI`l;5c>@IA1>7n% zS2Jkg+0o1I(;ddcndcAjd|%IcWP6qeCt}O-`#);~a&4!*X@-5Os#RO$VwBiCXipq| zx9d#BAb$?(X~d2rGEDYy2r?st{msq;2M)YEVeq(8{ir6GNv^NKqN4A{kb?r6OJIWp zYzI`DcIm}8-Kmd|Wh4;e-57dT4~FSVK>hxSsdLAA#XoCKcKT_9A9JSh6%!NduS?RS z=@Ls$MhKHQxR@w}GO~6HgZ11Z4T#xv%XWouDcX|0>y_aim7Rn(0V&(0U%V*ttHK|a zdj1MoK9{wzWbd8VJw4Y;f~vGY<;H1dDGfHHCWnf;)qxAlo%yi=>3e0X4*ydXcOpnc zSdCqznD5B83p(066*}xN-j$jnqD;5|WP9HBP0d4H7JL&J3=9!N_eF%+(e39DRms8doAYNr#-noW@SD+_~%UBblzrn9|6!Q0NZ$J3^&`g zN?XMApvRp=ahgP19Yv&SD3rEWNHNegIH z;pxHiKjt=W+C(mJ;`^;FgfDt2XctfF6~>*~UgryT*?=Ev7>p4Y|-sR9tI0L7)lg6|oSJttrDN_C$B87RR8n~bJMLJb$+qP|L$=5uH7K10QgsJ5Q-@XU;?p*?#gv+Q&x1s(*lPnv- z*a03-*wHe?C`5VfX4i;BQDd5QX^`j0oe9B2s@EI%SMCjb-ML|jznwQ1jJ((Tr2)Ge z60K$B7NI90;f$7tUFIenC##ixaF@65-etiQj=`%2)yW!D-0gq=?WtDQmY&+Y{sgAc z*DX0t1R3~F_HNjG_bhZJdBDI0%?E$Pd7T~j_A56d3|kYxIGqIZR5IN095{j?{XkK- zmI~LLUT{IRn2Z)Q@BHW2AiVCogle)29O|%~^I<$96lF45c?ImLkHvvS;+)iyuH4pl zacl&*p^9vJ8pyTwm(+iX)8c!+!Y(aw3ghRA7N=pNtP#;xpW0R8CrebTxv4>8L(VQ~ zF!LjJG--vqe)$Gw>POp)$mkDfSkf9cBMlPyBvgqA*@Wp2O&M0zP#iVWE#6hQ#vxTn zX!xMgwT9JgSN>&2_-=qXP`VoW2ayN1h|Ih~$1yR?Ll-Q^%%q4iAvvG=5@HDV)q8m* ziEQz|G|qfaA_9TR4~rBp${9?p)v8q1b_x6bU8iI&+j;gais2jFglbJhHK)+~=YTH>BtW6ji937K5q>fDc(GVg-LhK_ULo^YRjCFN& ztEix!B=Z)=9zrZJRrSE|&{q@Z?>g6eq+~9IVCq!ef;Db_x`MxD)|p~J7louN=iU6; zo&usr;R=i@Lhqxubt*9e4Oc=*eU16a5L`?q6!9iw(v2ZQOrln*E55~SP!%ps|22TW z@~uc*io^Idl(^DX{krv(tv_$<`w{Rn<90M=G#fU^dol=F3xYnX&`?-=%Z?L?5Oa2?1s{^g)ME9ocy=8D6BQ9T0uk^6QRH*y`dAX~DtqnR zy7d*r`s;WYeXV(Uf1f>@YSXVobZyLayN-P$7Z4MLbgw8Akm4w9}9D)5T<65-^+yg#Vx zAj8VS7Lc0W|C%A+Pq&pMy<8BsPj<8`UMgMuXA!ACd6FM@FDD_mcDg zKlKx)0(~+}s{=?hu2#VfR$+=kAu-+hJ0JDHT#VY$h$F^)u9XGFffJg~dbVoCiWMiX ze%d-Y)T~a(c|di_9ZG!2+^d(ZB<x$z#@|MU{JW(=!ZBdP=Cd|N zkii4@a*U6!t~HFQq|KrS!KqB7X4nCGK#@#G=0OS|%rf~T#K`}A5)2m6b#*FaK0s~f zvFefn13R0w(+`(+9h@OCpgtq7V30 z0W&TR&T#emo!_AC9~18@e{&ZlzRgw}0hJuhD*2(XkaRK3@VkE-u0~!X>E^QjT}6@w zcntSNAuJl9MTw;V#Wbr~7Lq1w>}R^4(MOYZ`j_>}-4pVGJThd|j&?Lu(oaU)Wzr|F zWaM5!+c%(%N$m||cE6fd=x#EsD=0k6E4kNA&^*G3 zb(j}+9E3i2l)KjBUD7y`sEbbzk`P?6awQw%@KZ5{%RmSzX3YZog&h@uz-(fIL6;C_ zqh@#aKX6XWWvx;NWc?Y^&Q}ZWY+7VL5Jcbyh!Ee&J>X;@SoPmO5_AdV84k^X^lT_B ziVzDF!R_f6d!5H0s{t%PGwJI=t`}aMY3JTp@W!DK0c@ZutyGt6;K_D`I{n9_=KR5o zatmr)^;`8W0=n?eVjv+Cu)Lo57jli{fEQiY`5^xAprrkgxtAkI$pEb<}5pZqbw9< zGVcVt&P6dR>ydizMaF*0d^)DlA{!Ocr9~=oeE9jwU(PwkdH~xz$$Rpc=z$X(-iSb4 zAa$77Ys{v%;dHC+@&W;TA6{+MkBC1H5=Os9vh(g#g5k zQ&SO2)zD>o8%kTj-F}RRkt>eF(35+HTrEQ+rPLxG<{dG-;ub*o}0tF z8pV?+&y>cZ4`qnYk3RfNXf}1aZT*ybLajA?KNDJ4lkHROdtjIv$&OcX8&(Tqlg7$5I4WA z5wMh*QFt~M46=l3r0Tp|L3>9x`YW_P1RzRycz*tAN+A_Sj3%RQQ-ty4f8Tt7uv1Md z^M~Rf;jBi}E&ByJCe<5&7~T*}n!O0vH-Snm>7`}gwwh8XpaxK~mH~G~F;;TgF2TrU8_XL}YnI|tCW0Xcm_0!8nH#z+b?`4dM zmFJq!ugxf%)~|n?==A}BH7lhBaTE`OP%ma5MWFCzx_-nL83NQzT?l>fzmHG)gUjrg zKBW+g~*AATAHjQG? zY^I)a{c=KUg)j7xPKcq!Hu#bVKP^XbG^rYpA3w@{bV2&qX2o$J0scI_wqjE!B|-a< zSB<7n-x44$sVP6&K?uXKNw8Ycn2gqA9z}Qunbi3_1Dg-S#d$Nz^zEO8|GV8E%NjRI z-bADePyk!>hYZwsrnv^NM2dN?E~M)cuLw}N5S=k(?6fWSpi`3vcUQO8;M`BBWWksu zzYZRWP{eAc(B-)tGTdR>>IDzGTlp}-6D&%x7IUaTl~5CS@ksgsGvz_Z2+{Q;&Paic zGaI%(eDY+~6pthQpA=u&62$xY5daeOd1Ajmj0v_BbVRM!(YbqkPNhEtv={zYr7=X({jLhbH-gqj2 z=SW}jMDHeklI_eAJ!ooGm9nC7DA1AT?r&%COoeF+bVFggtMdU?)-V5^Njj9RKX6Oq z>7K;E66`#7pIOj-fWk~Hl z9NHp;5P$_Qd(9SxSTc+v4j5`3i%?KgZgfhN%#Ei(cmtwe8Gz(Cgkb{q-`!dpgNi{KEFs)^TkH!e_+Js#+%8O60wZS| zDX$T~Vf0FJ3KPAKi`#ea4#&_6&}QO0Nee?CAS)qhAjJg%gg!IzcXwX~(MMcXX!Kvq z286^>RVr&H!9-kV2v4ovR&~^bSl|Lcg}n9uY36H`?wnJ~aHSGnG8FurT8#nBene7% z@FnR*45^^cRmlj5md^yxq{3rVbqS;}pxY)WERFrjv>>OVt-4E(v1faQLhPUY?-RPw z@d&uuAPO)dm* zU>+Bwx83e%AUo&NEAy%9gDH6lxt!UBO(Xphad<{{Y*S0BY!B;*M>%_h`Jd5az;w=GgARJ2BJl$pTvqVJ86jNK$QxvDSp4 zncTPw63dmg_4wwy1ry%;hsFNWh?)~Z_z`nK&ST=Zvuf)`RE<8srE*w{-hh_@RF#I% zl(r|@`YRrM6(oN$GP%aQI}TY)UPa|Oz}tVC!C&wx!=>YqS8}lem8cp)4yHJ>sSEcP zt(qK8oQ#0F5>ScXXs`4GaYJNYHGpi#sevdUnSMb0adqJ!h*l6n6IcJ~GJpN`*Jk2nOHsF6oP4+3y;PzoL*)dQT8nBKPuz}ccM0sFrTu9~L;aEmbCYuIE1e4%7y$18 z{4oTBh#HQ;d@>^j2oOEtKdAO8oZA4~eqUf_hQ3yV``xbD{o(!&$AP3G!h(Q?)JC12 z(7nA>#JTb7bFQ;+7=RXW2?M;601Hj(?T@(HWCK}`y<7)B-d5RlT!HWm{{g?Dp`1T} z^A&Ii#DTji0babb#4eenS9B6`DNtEa_av-d#$z4D(JDzHgaAM<$9SztfH~l7V4B0| z$32AFoJ*H0Q;3rL*veeD;!kst`#D?de1dypNnHJ3zV*L& z(!mV8y;>adY(_B~92((|QXMCaNH0ssnRT+H_Q)S05!_I2<-cq-u*g+v=>josRt#c7EHn4fBgP`@kAlA2Uijy zh}fesipqmM-MMWWVRv01US@)VDfDCnRy>n6f1U|38smX~Zq;Ynipd>`L2MU<_5k4DGdziB-v^S(aek0O zOqU5)Lzj5uf6wX(q)o5I^aDUT@(!wgvAYGn8%;z*^15&>)UCphrhcK`jW!Vm)t z?pirpyqtOr{29O_(RLIm>`Igmn9D7L-7 zU7hV<6{nro;zh?4g>e>30#Eg+s#vl(jD%JCWqbzp-~KC;{oqt;Jh^`i}h?A#;bPNA!wjMEp$DMeK z8o>n;3oe=Nv7C?sW1FXOw02%DnJUP4fNG>k7&`N3EXI?sAIk{Pc*>&8P7Z?j)k{nX z)F5i%{6I2;rzi;Z$)57FI6sDIW^qVdmkAVejeb+mb_v`WTU7CSShlB8aL)euSp0IT zX=6=<9$>B_;s3!AwBPW@q)Mnf;zeA)hkc-Y2FZyuqzd&FyZ|UAPHzE+u~0E8M&^c) z2SP+C@>d)9_xJE6YLCEoKBaX1dZg?8ATQYtP{@KxDB%SWxUGDKu(%M4JL3$~NwbBW zyYS5-Oowfj7Y%NMNhAIp@Cmkmz|t-Fgy#ng|0U*jR6}XXJf;>VaZll?=VI;Cebtg= zdWrPxU`4wmY@?V20$v>PtUF?Uz z>=6TsiUZ}tbcje4aPED#b+TjC%&Zzr1HD34NvtshZD6_a6`DjOY|*pMP0w!rdCHLV zNq_DfUDYv7Lbo!ak9a3A6nuj%I1Xsa7(|JvCS0YI(WnzO`9=0vg6v)T^jX3 z201ej@4FIE)l~2EW1D{0MAs>tClSLRczC47mLWJlB9r@TdF+NXz<@}@EBXzOOk?N> z#4WR03lJQX#!Rwx1@^#3(7psm`EeI>0-6+Y4VM*3i~otGWU?RyTG?0YwjzwYWP1RM zHRUJ=#1&7OqoJX(%vy8e%nP5NELY>VZgkJc$Kjo1AC}txq$6n@= zx#WY{V=2MlJ|&Gf4?(&DyKR$|b41zvh2pEz%l!^Fto?l`X`_Jf4MRo&SXW4IPD6a` zR{Amb{LGo5RtsBL`!>XgHxO6`^f_me{p=CEFA&t87PMK+7I~lJ<%dwfqxkR$qfEXg zrudVSA~sW%fFgNj1@f}Oouj87(esujG$M-J=f%L#qU>qUW<9ch%plxn+X$jmRptJ4 z(IZS!kfPaQ4_mUSrCfTro6VWKhU&g-gS$2iZHkC8SK4`?^EsHd7r0O1)1EvhO9Alc zKp`)MlNfU`loUb}y*Kizg-Myx$NmvF${;|h&<3g8 zQ?M+s`tKn@p7;Q4Aa-$H{Tz69idSHg5jI*vuB$4Dj}gFufXQffMU3xO@=hn<0u%RC zvC8xY07h3{$ma???Bvn{R;*rs9gM^x`&q9E#H_=~Ej1W56YyPXDwlsikZUUskOSwE zlt|YtVBPZyZUYCGfO!(9dH#Utvh0;PjR1lW-i3l6)8I3omq*DTA+s7j^Ny~)b?rG2 zRYdef7O_KqCt|&r3)X4ghZqGQRi2Z*ifXPQWnk`wA-Fq9?~pB;5WBu+nR{LpY+qF? zC5U%r*lYQMTdT`-AR1%;Ft^ZRyE$qKoF`5Xqs5N`0E0?ULYOuWwF8X6j0Z)C7(~b@ zYOL2(h6Jd45BkDcfPu0F1O8vk>$YsE1#Ptpqg|~4VZjl|o^yLK0HUGlUOqoc{Qjiu zMS7z1_u!OwEA9-&*^^NkY2*;LR7IXV+ZQAe%vICHDxlIT2ubdpL>`pvu48iNu%dSf zjiA+t53~e=~BECxE>% z27|>g-Ts9oA^WFF&EgVq7{_i>piJ3zWBxCEq+AG`8;0o75L8`h0o-PZ0j-Go@0~kF z5HyJy5lcF~N{k5pZ#a-@7{WdKpN4{)baH+edV<)FKo}T1W^zb#yS}Jm!>|Aiut~5y-3kbDsr0NE$@*5~30-cEa1R}h6eDE>(!=$}8U;~HL z8fZ7Faz*H+Cy^zRbD8QeoScN;Ay13PPLzgB&K6=FJVM8JdLqz_<}=*kcQ2&WCcQt`~0 znxegAa|uz;Iyg>D#=zOnO^&XuMPW?zL2=meQ)DUbY01grHYkk+^VEZn7NO^b=0&_b z_)@mKw?~1KKomq_v(LydPrM#WDV>xV;sGR!i&Wc~Zt8>nx@C2r5l>+N#13J@pgpc* zfYs_H8#W`UrenOS0T<#d5Y9`?_CUdkI0t4b_BVP#t&pX`GxnXU$>S#e zFai^l=ccNeM)6VZ3B(Ocs8z5<&H_V%!`W}pBxkLqV&K_34d>|F&;+18qjxt~llg(Q zcMFZ>h67&K-}9G~sflO{hyY?#)&vDW43nETD?uM6vx1PrSkFIe87=`=D`wkUs!Pf3 z*}p#y816cnBWcORg8*j+$uC6R`Yl_OLGZ5M%^K;&EE$cu>npvYhYd!QDpaKuQ1kmm zT{TcG;rGjd`92N=A<$M3;luMvCh8zuPGZ<_3~PPX1rCm^quRnv4vgCiIG^b_Nwy<* zfz^YGgsvn_#&js^gybeFU#tERqV1C{V=U#RI8B=onGXvv=p&bKN6&yig-7yN5-kVd zXvimHv&K`o=_SmDsqhs7lxv~vRstB=fUjM>W=&z>38=SZ(HDY`L>iyLk#1L^h$4ta z$YnA#;3r{9&i)vOXBDPaFkT77P{UW44{P|;n-pf z!7hax^|a=>-4uZ{{pv}RI?nnu9D8D{newB(T<@#Wh&s?|gQbw`hH;RbCnW;C9$^+# zQ|rgX|EN~W>FZI2$S3N-?+{^oIkHD?CSeQu(5X{3UN5mTVJy!RiwVh46!ImUlRdgu zL1cI4g2T8f1TD_jmEHSF5q0qAg=;xD!MZ2L5h4mCcGm zd{d$bbwb{+Hg&FKgx);6ZLAIjk26(MX_X3cyAX?Uj}WcubF_fUDO_-`c;4EXtla^3 z&E5nmLf-?Wmln2DGjmDc?@^>99cho()dP~|7iCLP|2)88*((?$XGa0EXaSonsV`^W zn|2!1#CKaKFR#G{8f^jag1dYinz-R6vpHcB&tswH~@Y z!(ehp-J}Zrh0j96sKe>)*j2v(HpkgkhAj5JT{>0&5e@usXlMGAYBe*=@ zz@Hf2Fw~G*65ZUl9T$z};Q^&BGsO&)I9tpK@ZOznp`eDYFQBA{r=7c79;eD%T^hZtq?8<*5?HYI26olAA3g;NQuG@u5_QiKEJR~OyfTDRmz-9| z##Q$A_YJfEcT}|`1*ETUq z2rpETD|_$gZlpi;g(bKg#gweNSs1I!{aCc?0!A(@*djXMqZXqWbIqhK@tp#_?8?|@ z7BalJ2-AitT*O|mDq_l-%u|(-m*3dC4T@ld?^NE_GV1{TQ&=F^PLigmfm5!_0q-Di zKjFu&$=%{SE?wDb*F5V0it`b4pgAY+K;jN4YIT9S)#f8A@ty|@CgP^cYcN4cfAzjn zU3PYhaK~si9a8TCI0P3pJE)%?=y%WKt4-V|VZNjLc}s<`^gE?!f5m~2HTyzL;u>0H z>5LLuie_CNHVQY!BcL{V$P1@ZHHTKI;Q5aC>Vsa!8t5a`o0svm1A8)Hf@$3gAGI2TndVlOC2-dZ*9Jqj3kzntBDmLEt#iOhL~oL_7zE>t?No_V3uChe526!=@XNHPP|o+R9k?xMz5e=-eUv)0?DuA-l1g z1JaiYynj(Izq&qULHUu5kAKc%>>D+BF=~Fv3}o&F%w!8nZdXKy)~Foo4KO>E{~6P8 z?b4;4+qYkVgxq=^c7fVyWnWg+M|cn!HUaVtzp62Wqwf#k0HB9CeX=j_GRS?NJDc~@ znVU(w@nN;F9PB=Y(*F7`1NUw=wT@cT{H3HNt7P2_q#`jUV3XRn)kp<&y~yH>9;G37 zyi}09x8dWij4r?uN7UJz%wggHAu4k9DR^9d7{!vYTU-uR1q+m@Q~;uZVtSx8RZtA< z44VaQi16@+%exZU&!&}K7o*422{=h8@21g_J7BcnrK&NewvNI*Rl>PZ-c)XGaS22T z1U^>dhhuN%X9HZpV&DuN!-fTcekQR8cpbE&)_yUs(qPd9Q2vl1r^l0g2V7cKx@Qr5 zLs&a}o+z=`&h?9!Et`9I5b?mCVb^Ks`a;h9UQiiNfD-=ih%L!BBz|@xkea zpnus%NjyLA?z5h7k9W5)+Qygyvyitz;CG1HwtnMA>#WB_T*R&ncl9-xc8Hs;nW1t$ zaV^0e)?G`tU2l3>zYJ#;W)1LlehpHH);C<5roo`GiR08On{I%tB>>}1sx8Hn)pqRl zf@u{>gYOHO_oZ`Eer~Z9?=Zk*-hKPQ!Y!*zp3MwGJ;_NI9_?*YTK6F-?Q#7$!!jn= z5{2kEb==8A0-M^4JW)LDp1SQFdX{3895XgQ&I8{irZZcGV5Gls@5Mglv!Ca6mmupGd9hq1rlH2Ap&tQegWdVNf)>hqA0v^- zHez^V=#(DYY*#kCu_6$dN_xuz-P$#XllR;_!KZliMjykMCH@0iiIC?gsaVmtJAuH8 zLfH5QCPOnOuaSU(^lyw7H8?86*{#Xu z^@6?H%$EJRlNUEf%)qYk2tHzZ5Ro@xhJjm}rsrEZH|k+y z!ED&=Zh>wJRxD@GFFY{k7d0+{Gv*>x8_s$k!+yPFE1j?pR+;tui9=Lz|5I`07`XK? z=oEqqdW3FGfHEH%AQzaMH-Oi^B5{f6@`dnaT-hh=ScN@2o{jBOSBDAWZE@^pqlj9S z!Fl517Q3l^k#D#;4!ml3q0VELW%xoausDWL=)PRURHnZqB2MY14#F;)1nsFENoQ7V zhkbC;eNLgknTFzZA7PgJH{ZPsrRWW0k3zVD+Nb$5bvBcBa@HMIE;e~8=>3TBzM<+E zzg}-Y7VSlF=KVF5+{C$uiHN&?5u3awj=_@LnDAbhw6?5Egk8ylfCdnM_bE-afVuEx zN@+AA1DGR4lNjyX?z^H4Yxao}k6rFQ0#C-K6Lr(4nTJY0Ovlf(E-e~lE)_92eF@7I zo;^4XUqku?Unl184C>V!I8{077v;wmdEqK5P8i4QJ7P65a3KkrS=Wev-b|FMOv>Fy zuBeHZ`i=p#*G)$To)Ssu;T(stMDA9Zzve!$s5d(g;r(42F?&U3(-_O0A=Z+H=RIB zFo=bpgfK3n@ORK+I^hNQGr;?oa4)xj7%(Zr-7vu!E)!@JAYk*kHETP=U-_9OR0f^% z=g+@rD1@I67^#Ug%H{sTx$$RLP1THFqe8HGwK+5)DN`$e-pklfmDht6vNY_-&CL1pLqM6_shiL* zt@`(bfE(ed&&2}~MJTH)zub9T;S+hmK-3@sd+J3Eza9pl0I^?0S=B*EY^D?Qf`q$S z59OELlWf8HEj_pBE^4#bOF(|q(lf{3A&xiWxmTk)Ux(yfGJ{#o1HgwCVhHE^_wSn) zdB0Q!BUR~;ktcpmeqhK7QRSL)GdE0~15%zB&L{6kixPoTL6>4gmffX25K4he^H~;c zH+wI!A_@z!KPO$AYuzhXd8D|5U2u{qAMQ5oZ1u*0LKF9D?A_Q8x?z&`YXpy6t6+M~ z>~c2mLJZ!l5jA*&IsX9$ZI@l|F(nxq`C~9?aa(e!96q6(JCHek9=e-tct3)51~ZtH z=OkeJk$MA()}^7Qko{!4ss8Q9iBka8$eE%Edz}8U*?=J#cVcrVZ#oD!PJk_;H;IXs z$bY>_L_Vr)C$Gk+caCPft00wuVfXH9S4#uxKVjs)Oy~i)s|o?1uVQ(-g3xE9SdiUIIA1Qj zBt;MOf*Do);j^Na6Cwq2;AFT`bF*YqSg@fIMWY4T$G@YWybuj4x>WVIJU6%V=gvJh zIwTIYqgoGdHG%+;k+KMaE)|}K1fka<0HlP`L|&RXv@YHl?jVwRItucSipn$av4)@{ zWC_(E%{0{#08gO@I(pftwE?^k8%NYBl=zdv7({KPDEx4&DIad%4*Z>u^o;{=1ql-kgp^r*3Oi;*{>Fy*;0^zdv;)k;OJuznvq1RV7l89dS&e6* zm==!1L8dj!8k%O6nbl?i!cdyh3mb&Go?_&sch>#@8O&KSMuIiAg2Ui>^A6-ooCjBC zXhcO3GRk*fK1Zr|v?jpYGvv3t>2@oyFnHzP2L*r7Q!jHXewZN^cv2T}d(8|iTx7Bx z>-q||da-MuWQ52-a_;06733XEgxIug#(R0rgPmZn?uc1dqTJ;0VF7=ied)fzSa+Fu z-@|}<7O9+%^z&|jbtDt34N#bTAgETR+N&E0M`RrWhb}^25?FK_hrnN4%U{zKRt2QF zEO-0&;T7KnK?j_m`hCaay#zvLqS$9cDR==TG`5q~;gG@@JYHY{3XbiJ>_tq7LUd&> z@K%U#V#ote^435&7 z^~;rx>s{OYS`Y(x2q=yi07Zha@uro4dJZ!zIALvh%)SXZos~TV9@v|DzJ)cJ;uOBK z^yUG)8)f47Q3G&PegoQ6IB7${fn`={qY7?k#cl)_HEcu8hIO3NW!}79MsFX2ZhfvM ziZ_N}e3_8r2@;R%wzk7N9_OruVnnU>8ISYf**`gHc0fv>m~Y|WshZF>EQ2+doFTD< zk(GEcMwg!(_&AFkfitbBoYHZ@;C6^Y) z8Ebaz$9da^CCu}|QIjl+(H&D~`LaE%9Q)oS;k{Ezhw>%#@urD5@+LQszcyK(=&Q!S znRHli4Q=!rz;vgM8%o5VUx8*-Q;3t&9tEH{MhVLAh(f%NZAjbznk@{f`0CXkMJIQ1 zXlcM^SdJmoYmiV_;%ijmTdqOeBQ7kqcQ@Rc*;xPtO)J38Ou%;GpWC-4D7k-;cRn-; zWQs%7_A*NuSz*2!yx`4fl}gk%V%*AGT2u%1j+e`k?QEDMEXOyKchMmUlrRSgFCHXY zLM##!nLt>xS^w@Nd=r)|^lo;7L$W=VPZl+;vHB7rd%X!JdCVFEa{Eio7_;Sr6MnvY zlF#DR;NhJzYy-JVc!+vNF4{7Srn|c*s&46Rg2Yw0PbKOShRKt}=FB)55P*;E!)GcX zaX=9Bpw^cT@*jrAq+@B*qB}*S8>Ml&x>rmTWPG-d@YhwnI!4ccdz2sOK zi!q3la-;H)+olEH^QsbcOLugi=N|u7?{nMs9l!A8cNM&!A!eISm>hnu208?5PIK7{ zd}uUzaTW}tg^%|eJC^Rv`XcshU)RAKnpcWW0tFjE1DAARntFCdIas6)c>Y|lLT8Nn zIy6sZvXy`{nk=@z#}PKL1gWvoYWGWr_5KO}bLuL%FR~PdUAFRmJ+h5~d0QT)O0t09 z*ZAVaqg}_&$}PWqg)-S}j0!0LrvqM%Rufl=SwYh%xQZ`#rh*58SSp+;92Ay=`h#wE zxf-p4MFD{p|NVG>D$Q7U2Bq-RhBs#qps$Si$KPrV269WKIF=JcxxzkW?Tqy$Hnh_**bOSCLq3*PHA(Q}zY@dtltZ`9f%x@F5$Jn)3C zX(qhkd0g`&;xt64W7bF^_HH=a`oU4wLP>ZHfag#(4Zi1DhtCPv z#dxY)K{*RYuWj+ua3`u9{*+ZkwhVScB*f(du%Rvc3<$Km{NMt&XZSn=URO)F!GtRB zhR_abFt!Wi`&%=(%OC&WLtYV^)d4TFHNE-5`&4W=R+^G_?XdrTG2Z+MN{*PljR6>m zI*5YVRinX%;d~C`%XXI>y!9x24zr4XZ%plXQ2fmjw)>UM4>h6Ai!3czp#YVJO={94 zYDAUo2PEN1bp??!2?573%(v<&^RQd8a;_N&Xh|RY$NyFEGauG#r!g5K!+dMoWP+7i z8VraZ_9Wiw0gdcy9Dg#(oL7%Aia1v_@pBVdCv#1mBt{_xynxlOW)RDalKn73tAnnY zcy+uieeB!KtW@m17Z-Qw%HTo43JUOt$Dd-=EyJPMPWwNP3yt?wb62glTWa=WK#Lb< z?J|Q(1U)ZeWFv+Yg{;tcKA0~b_X?2L9afs^h{kKMF=s61uf+2myMyBQBDa|@BO~*B z=Cjj%ym4jX}IhgdxUQdZALf9^55&2G> z*WnFhnlGLP z?^(sP8&XwTwA}RnwfE)!ROkKsry0%EOieSDmMN-Je)PA5!b_|{;uqX!BRo?q!1Hsbv=FX26UvtH=JC}wX4eQ*4Q ztPjd$2L@iw;fXo`gzT{UsK7%GZF#12nY!n!OEiC~dge#=257!JFl-GPyb?u>I8-Q4 zqmseb8`*HRj%PgPOgj+-6%Suqhe3f6iUzP5H`2JnMkiK%yCG-DvaQC1H)Hnf4V)s*mCP-p zALeD$b1Hb31eF!xyPte63QV8I_$)N7Ruz3* z97NaET)?H&K4cA+?K^YkDY}dp8puUAdf{Xt>JM_G3`Kn%m?($`}p zs@t9b?6s~-dDx+ho+<`7P!l(AIWTBSZF(5B%%3-JWyerD!MPZm*bUBfLJ!qd+umzO zcHAg$W#ax;g?-447w^~BoPaS>bh9NQ^`5@iyRkKb$CC|DtpZQI^+_fgE#eB*Zm}+y zG51^lTsjqA8?MzE-$Z}UO_S*VhVc%dtS9=q-H6Bz@!WsSEv}2G)IMBJp0k(+>*3sx z#l*7>Cs3>2k~7P-cq0v0;Mn*n({rM;4w!8PKYKm6)B3h1A-)sHjq3%$>M&7Wi{kJN z@?Do>7+$*8oweI=)vItJBHj&Rs7Xf6rflVDlVm$VJ?Cz3Vv-KXaSe$$M?F;BKY%U? z(hRQ6!CZj^0A$n<(I@k)>UlX{U?lukGLrUy8~DkX6sqP8h54Wn zY465>ec+-=xBY!n9pmLFD&uMofW}0>aM&~tJj3WQ3=64yZR->I8@>5H0Qw{-)o;yo zbl!`qM(d4FG2T5*q402Ywv2y14>U!%Cpimw9^A4U#M!}RJBZg;Ljon39f;MpQ?&~4 zB5VJgm%RfUxBIAhf3_pQg>wS)bg1c#|BQT&8kp1uAY8tIwPs_I?1u4+g0pWY;n}bc zgYAw947Q_zeo^&Cf;S>BlS|LeogFYwCw4at`h;Z;ka3&>Cr{-|IOFf(U3Ilo8~?0M z#}f5@4aG7rm0@sn7%9CP$L361sj!^E4-8+YZ4+zq{RxtWwZnFxs3{HJq=!LGUyYft zOoB`2=)ZkBh)6_E!N8B;mng$?ezEo`hQsJ9HObzn zV{|TP2KR~B_moHcFu=Hw2&hLFWt!vRl0#ioL;qHi45J~#^LOYW?Mg)k~1y&iU8?y zZ(JBow~I6*08+y28ek5UVRyLq5(ZU|koBpP>qtk!uR@R~*}t4Yv_bEgB>wTqIiNw& zSHV-y*1IP6rDPvE61?RT+?3XMdZnhK(Y+4=7a5~YtP%em(@`5t9ik<~gY33cWuZ>6 z3$R^uiB2B64|;Q=7maYGsx{?uaMvNqeT3fiIafY$2;EI|oY`4HAtz==ecRBsj-mbE zVhr*uuk19GDCS`JckzM+k+8afl}y#OnvpNv64wV59S6QtLcxyRyN&CYF&In$B-_D_ zpvsmIl;(#8lJFKF6BMNFEKV`T;3Ve!F3dn?`=Q)fDTNH4MAdnn*)_{vWK$_5ZgaLiUbH`jjTY!tev+*0*UO8k!NDb zjvjEiE+YrO>*HQFgzJ4JF0NMdUo(fN3kltsNO@m!`%)80ay?b&EA|)cV`8x76z4AW zMvyZ3J;ZZhQ-)ZZTYfp3KKO+H3@Blt3wwFKBLRKu!K)^+Cz$MN%Lw+O47@<*z&#vY z<0?x4A5Wnlj+~rp1j;mNY=TVwY68!7Y7>B9CrCoui4|b`;wC>NgaOwAvSBezDDuYD ztcF!r_JTjXFjOP%YwSi`&PrUD9K8Sz9@iF3_i${7>TOdnzoZ*yG^Raks{iF~aoxVz zXI$+^hHuP_$0lTJ0cM0THZd3x?|7pf@*9aa$$ZpKRZUeAAD^Urq?IS0Wc_dsabS_2 z=yL)Vi99ZVCYwox2B|Gkp&Y2~$pNiquxN=rF$+oX@TO>63!vZjKH1+X&U%;Kmm{7W zy2FeCmvnkT02fHgMBYu+ToBG}56Zf@=5U0fQ~`S zE*^Tn*ld)%@k#Xu?iD8NJ}KhiGsF=AVUXm(D6%AZGapccgwkGXP#yzGQ1;ync5681 zbz}B+AJrr=*gQVm+`Ts=&lne(czl@^0d;cGhJu?Hr|SNpNYDgMBCV2#(ry6>w!E$| z%Ct~BzCyT#fI^Zg1Jb0Nv?KQqq#1>z3e25p7P`PN{3)iSIlVqI7zg{wFF z7>?tVLntid@Qtb=@!EVhqf8jFsTP?e5n2^c92`7au1GXyO(%~a;6{~*I8%l$K%_){ zo?qMmZ;CtJ)r!^7wIPY}AN^K=)_XfWUzA1k5T*-dx*T%Zw3Li&Nj*<6@l3lycg#fh z);K^jZQ!)zJqMA<3^IQK3P`#EDB5f~uLhxV?m{ZB1kT!;cq)e0R<9(adHs42p1<* zUz7$hw+F25PK`oeg9wLy0{|{-TnO5G00BT8@l)}oh@eTNORTV2s^s{HOf(P*!38aq zv-li_+LJJCqAC-0B0|-Za9lsnbFeJgiiB;5c^!JoK&%rMz2#(3f&t0Hu)B=Dq>9oiFB@NxwcniWb_}_$mrhQ+g#b5p~ zl^8@Rsmj7&)Clj39IN1IU<`zUXx5b0F>0fIg0V7MT1!~mx7YzrcHWJ(N&*ef+!g0Pgri6TR`}qW@>fnG+rk{quDh+J8)S7+*KPeO+_+^;S$p1;+oi z=I-l0#4o~L2IK24$$z!7Ul(V7%@tpB#sBBI;ywI1E|C!_dP6?@7QYB;78!KtXnRK3 z^D`wkEPDZ(?jy)`Nm&Rqj5PE z%?l;pr`~1-9Cp-euoPwRU@OLg6G7|5`=5UJp$c`XiFF3>S-?*PX%}rkKwX?sK?J8W z5oi%4*k)!RrvS19z0j2P6v8y}ivj@wa}jp79zO@<$43DE51{kV$298}cBG<{(;;>^ zDrGOd^M@M+N?F4auq>hu6&;>F=Pc6-aETPY9O#R1-UuM&mItJ1L>Pekm^2in*i_Ny zdN92$pkE?e?pbSTdjWss6lV+X!clZ1w08ANBm};; zl!>KptT=LN8smt_H!>15#RPC8_Dma18Zfu^uyZ_h*X=QwgerRrcnllBJ2Or5&<2}4 zc8*C#f7=C?Ihk#Pymr#Lq<0*HYqDA;hf*}rM1G?^mt+tI>bf;VTcy|y2c+;_wH(id za3YYaq~STI1?zYhGULOGM1liC>g{%d;l@` zAwb3Z0F;1PnS}n3P?4Fn5m-Wjw@J>2M658&J4*+MjFr$7(`ZH+to-8E#wR$S247^X242@> zI9-c2+D0T8(A0DL#k<6!!SnJ<6B+|$$j1}9Y)6x>Q!J`wo@ODW$ba>?0+)|E{8 z@&tY2K7jH_7vJFcqFs$+uH%?^q17Y@pz3tYUUde7es*orFR|r=o(EX2EOU4}jrFmT z5dJpGi52reV7Vbix@b7kTp12k>5*M$Yr+A-+l~choLV~g<$kw3?hXv3;&E+4hy#ay2c1&T z(rJ@3kvM6{Z|Xg`|1h>7VuitNe9R~S55%GYH1#wW7Ry4eKQ@Lupk;-`CBz`|PtZmR zbMmmT?^`@9&Oo|{qbOTnAD~?Lkf&ucepUQ=7f>_==~ozE$ixi%m;^GRJ-Ht&Ie*v7%%(Fk4uBTdA}5fkUtofzM$OVWa#HKfi&KOCbQom~t`9 zxAAkJ<5~?Xn43yYC)8QJ;Q18PI3xqiFU+|Mh0+5+@x4W%SPr7e-wZ|Q-`HHXqT~Qr zz}au`TrBn|0I#>l8iJ-977(4RZc@g6%|BL@ELwk3w=o4sND(&%suUqUPI-bu!|IYp zpky02kV}F(>n64ht;7#~$jy0!OM!KoBuXEkHGh>iEV4&huJs17`FAy}8y3nQvVfpl z*;}shAl5Q;SY&kYDk?$wiTLD!Dce#3uxf#y))X#S}Ig=72A< z0c4(t?%cJrn!P7xzsNE_x#-e9xMr!dnCOAp!leECil1Hu-vQ5}zmgSkW zc9zrBc|Fk_%$ryexX9H%WF5lRAAA#wio2ZCo0if>A7UI8+UkH>a~+YT0A52+)*Jt? zLtD;Y^JG|8Pp{Lx>S_gfKF?;7eifYMqZck*SOk*S229CYA{t1?f|Iav`SSeLy7#s= zwwKnmPn7e?)M^*W-1GDEg}eyZHbe0>=(wfUQz;2H)q`5~?!wawrdw#P9CDMBTw$5VU=nK&OJ(p}?nO-N}Q2}0ka z0DFGbn65m4|ChvC!9v(TMwG*IS~>6~TQaO!gw)s?1W(>YK)~h27Guaj%KOE`^$}(- zdE?vRlW-~X4fYM<_cnp3-C4N_FIj<@?t2uFVXXl}uS)s{1HcyR%;B<~Q1b0Vnows| zQUo(wjjF&8i(MA6{16sfF>71H9R{lVE6WcWAQ`(l!06Xer~HapEz+u@A4b26S$?3r z7bMOT5wVQ|we3dB_sdJXrv+NfmpSn24(=3bom=tf?QGv5MTCBk8%jFeUiN!TkECV8 zS){B?vvHocoFCR>BqiRSRtx!kYwp&@(c`rd!$B&xtcGPIa}irif+{d#Tk0d!yz5C= zu%g5bV;B}^VeZ)Yl1pjDuhz2WJbqbAL&r^mKb>QCtt(#ptkty`*&T14cAEKhls`db za`h%uYPhk`_!M|oUh((e2z^s(rZPOaI)~E5i#Uw3ZqK^g{W0;y9FC9q+}3h=&6g2! z_gJ*Ax#-7V7s#0|U8t7}8f$Nnyr&E&wvJ;SK}E=s-(oAS$bFN5F!{7I)mb8+Mg9h_ zHo-{}#p*9mc=>^8g2U^OjA^qnueprY3^l8h;1}|(fsYTzX-KMX274FXgmM+<-r`%eCH zWN~kvTTfkTF=@&W5RpOWj?V=DdhF4?T*oDMoYu4N&jhQO{j}LzN2y^5EOUHOh(0$Vo{j#PAw10xj5&E+hRg~b z&~;i&o!WESw8K6O6=U#)*N&7tH#;4b#Y&X7F#d5Jdm~_vcJ|vZsufj#aauNCLElWz zEa@N77a#naMVQ|5uI+D0rFTh;G%LO3O0G!01vf0n7maJH>Bqi*sctw$x?RU8fX$vP z5-W-@54yw7dwEycS?YNg%F=7`0-)oUj%K>zU?`{BbDogB~f@wD5VaM2}kJosP+9ip)x=vna`o%=X6m0UGp^39LAGB4>2WfuJYE%hoiW@!4(yIt;8absD zrrFO^YTaoFb`s z4XnXvga|F*RZk)ku;wcog$WO4j)i>Bcx&{R{kz!42(w4jXJSsTiMa6^Q?tdxV-Y0{ zJ$p?;8|B{7lnnuwV2@pz3#LLf>MU65x}eZP@-kG0MzXK3?={pRT}|F%8`z>Jocl(V`ph5YFOmPTTHGA~<*<2A`i zNlCdC5)zx4xvA~L2ZPb)be|(FBXbUG@UBI0ckJ4wK{gJ{KD$6T^cXNn?GK-M`{DCK z?;AyZ+1Ovb5bzp!=o~r}N}U)6$X#$Np>4V-da+|?;qKC(yU!9-rB@h|k8aUDXYZsb z`qoFKDV|pPxo>TM)K0BV-(D&D@M?Uaf`Y=Wn>X)+4!2rDVmGzVIOqddm)41rjU2xP zNe`mO@(lW&7o8d%pSfRT%sj>pwk}u~XV6is?`&<|oPAw*l|+4tf{|$maa8PyE}YN zI;1$XfjAai>&}LZd~7@jk<*YznyrZW+!)u9+JD(%RL8VXrVQC_QPTW^3LUyHjm2*!m zSvkvGI;*rpxV6r!U+*|5`r4uI>`_cG^q(&aAB{ks>0JDEI_piUUGk*_oVEE?$a%A*oP*5}! zaE~%G56~w^P`G{fE|HZC_;t|B@x2o7-OGQXP+zAF_XBYzB$W@}RD@a1UisT^QnJes zccZS#oybkvu~wpIwt96O{pT-T6D%)Ne{W3KS*|V=G@m-XtXsn zG^)_%#ATmoD%CYLwTpN@^biO3!(HWp!fZjIvDu8BB8J7*j7hVV09^-B0Y|MP}P;BD1-C#N_+9-9UV#l#~v#aT-;BCTs4c2#F*S8Fz07m?;CvKm1ol})Wbfbm5wpEp=?#3g+lY!t=C#6F>UrER5yLSgvX6oP1V za*iEwSc$eza5a#|PC(X=P04+DJuoM1KP~Q>chPGmfOTu@xHV?E2>?2+-sS&p+U~hF z&nr~t9|wi}lvFePzx$6J`}69xYc(MK+9K9fiMK73Gkp!2rbWc{94Bo#Cb9qU{hdKm zhYGoPY@ZkY3t_y_MoGOgnrvn+To8isU6YM*rqgdjx+(hK-#-}u52au+vLeS^!X<&6K;gtl)1cBEgG2{H?ba@^E8ZVY&lu`fdt$%=#ARpG}l(e*(&Cx zOIN+wveYuWgXenh`3DZC+D|u!NxYP#sO?fySL2x={b#Hibb$4>}?@ zH@AmvC>-SLGwkgXu_CGzZIPnbV${3q5UtUr0oPBcz;@^I8y2AM)Y>Q^H3B|B!1dH= zfT$Ry<>h@aZwEvcqb<@3nfl`<8=gHL_H6}-US6GqyXA_K&u*J{IXb4?3=cnLyKcjV z8f=ra-snM2^BMuRymo|>*sEG5w|9F^v&S22sUA(|0c-o4{$!P&BKR>@&T>^yKOZzGpAkAf` zle4w~-@Q6Quv$?uqkg#gA8ipKen{tpC}MOGI^0CTAJ?v}Lt3;T26e;VrKNE$W(d4t z;c@B!{1D&Ka{@>zSFE8iEyflxIb$E-B(VD6Lp=ztqO1_$9n4 zYEFVxwqX}`169Is=~>!cC@2l;g7jODKQ_O3RH!+K>mQlh$>GTtEnz!<{0D&#FUHF& zn;?P<7cWkIR}+))v=!;;p6D;|Y3Td7O++H1 z(>Np~1RX1|N7IaTaHIh?cl0lzkNs!2*WcB8TaQ8*rcq5oZePl+8TT^bqr%wzf7a zF!4!)3*d_6804Q!I5POGVkKSXzUPm+s({R21)(MJ|3UhUd-P}zV8kjqm<0*&bzV$ET`~%8Zc~mi z0M$w`qmuz3lcOE(>^_7k8YaR8U5nJZV;NWpkV}kt6#FpZ+Al6HuA!r2S}0@OCa zeQQ!MRY80^SfwdP8*yL&ppWO0hM6B3+-^(kGJPBSZA^nXN-@&vVU>d(8Vo6E>1wDD zg+)b^(0p4%jEKR=fwZpJ*a>?_O%V@l^0S0>)m}2%MZXo-xN*T%`NCyv=fKd=INAnJ z+uiVmhyzMy3Q)t0frN|cW}{StqjmE+5oxjZ`jo>i0rE{3{@j8iZiUv4x|Pz>QmPP0 z(}HTbie@Rtk8%G!SI*AfFW0CXpILNXS-YtxSNIQfTGlX1p~ajqI5;!ZeUK&!D79wi zbfn^?RRn0v_I0prmy;v|*Nc=}=o<8OBd7abX5KlvX_M7A6LMs}No2#j-a`j%jyZ!K zoG<^~jO&2Ir~Jq;x^+h3%|E=9!B`5u=A78^aW9*n{$PjbeAhDTXGZ={{_KH(k|Syf$4J*>?r5e)H{S`qi%I3o!W;>OwbDi6lu0jK)pS8dI;vWL`nI0fI93)ykl0jLdn(i|}_{_{QjnYLptpcBoUyU%St3 zGx4qI762=!qlfw?yLqP&WAnXDMfel>R(o51!oTs4QR}~J_86J}i@DFA$k1r+ulLJ|K-0<|Cjjp^~ZgEc3%(5|8pzqCmA|Xu1e Examples - WireGuard Portal

Examples

Below are some sample YAML configurations demonstrating how to override some default values.

Basic

core:
+ Examples - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Examples
 
Below are some sample YAML configurations demonstrating how to override some default values.
 
Basic
 
core:
   admin_user: test@example.com
   admin_password: password
   admin_api_token: super-s3cr3t-api-token-or-a-UUID
diff --git a/master/documentation/configuration/overview/index.html b/master/documentation/configuration/overview/index.html
index d492070..51b3cd3 100644
--- a/master/documentation/configuration/overview/index.html
+++ b/master/documentation/configuration/overview/index.html
@@ -1,4 +1,4 @@
- Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
 
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file when starting the Portal. The path of the configuration file defaults to config/config.yaml (or config/config.yml) in the working directory of the executable.
 It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal.
 Also, environment variable substitution in the config file is supported. Refer to the syntax.
 
Configuration examples are available on the Examples page.
 
 Default configuration 
core:
+ Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
 
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file when starting the Portal. The path of the configuration file defaults to config/config.yaml (or config/config.yml) in the working directory of the executable.
 It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal.
 Also, environment variable substitution in the config file is supported. Refer to the syntax.
 
Configuration examples are available on the Examples page.
 
 Default configuration 
core:
   admin_user: admin@wgportal.local
   admin_password: wgportal-default
   admin_api_token: ""
diff --git a/master/documentation/getting-started/binaries/index.html b/master/documentation/getting-started/binaries/index.html
index af61b1a..9cf6f2e 100644
--- a/master/documentation/getting-started/binaries/index.html
+++ b/master/documentation/getting-started/binaries/index.html
@@ -1,4 +1,4 @@
- Binaries - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Binaries
 
Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
 
Download
 
Make sure that you download the correct binary for your architecture. The available binaries are:
 
     
  • wg-portal_linux_amd64 - Linux x86_64
    •  
  • wg-portal_linux_arm64 - Linux ARM 64-bit
    •  
  • wg-portal_linux_arm_v7 - Linux ARM 32-bit
    •  
 
Released versions
 
To download a specific version, replace ${WG_PORTAL_VERSION} with the desired version (or set an environment variable). All official release versions can be found on the GitHub Releases Page.
 
With curl:
 
curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 
+ Binaries - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Binaries
 
Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
 
Download
 
Make sure that you download the correct binary for your architecture. The available binaries are:
 
     
  • wg-portal_linux_amd64 - Linux x86_64
    •  
  • wg-portal_linux_arm64 - Linux ARM 64-bit
    •  
  • wg-portal_linux_arm_v7 - Linux ARM 32-bit
    •  
 
Released versions
 
To download a specific version, replace ${WG_PORTAL_VERSION} with the desired version (or set an environment variable). All official release versions can be found on the GitHub Releases Page.
 
With curl:
 
curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 
 
 
With wget:
 
wget -O wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64
 
 
with gh cli:
 
gh release download ${WG_PORTAL_VERSION} --repo h44z/wg-portal --output wg-portal --pattern '*amd64'
 
 
The downloaded file will be named wg-portal and can be moved to a directory of your choice, see Install for more information.
 
Unreleased versions (master branch builds)
 
Unreleased versions can be fetched directly from the artifacts section of the GitHub Workflow.
 
Install
 
The following command can be used to install the downloaded binary (wg-portal) to /opt/wg-portal/wg-portal. It ensures that the binary is executable.
 
sudo mkdir -p /opt/wg-portal
diff --git a/master/documentation/getting-started/docker/index.html b/master/documentation/getting-started/docker/index.html
index fbedf9c..1c800a8 100644
--- a/master/documentation/getting-started/docker/index.html
+++ b/master/documentation/getting-started/docker/index.html
@@ -1,4 +1,4 @@
- Docker - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Docker
 
Image Usage
 
The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
 
This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
 
The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
 
A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
 
---
+ Docker - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Docker
 
Image Usage
 
The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
 
This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
 
The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
 
A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
 
---
 services:
   wg-portal:
     image: wgportal/wg-portal:v2
diff --git a/master/documentation/getting-started/helm/index.html b/master/documentation/getting-started/helm/index.html
index b32ad01..4caf98a 100644
--- a/master/documentation/getting-started/helm/index.html
+++ b/master/documentation/getting-started/helm/index.html
@@ -1,2 +1,2 @@
- Helm - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Helm
 
Installing the Chart
 
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal
+ Helm - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Helm
 
Installing the Chart
 
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal
 
 
This command deploy wg-portal on the Kubernetes cluster in the default configuration. The Values section lists the parameters that can be configured during installation.
 
Values
 
  
 Key Type Default Description 
   
 nameOverride string "" Partially override resource names (adds suffix) 
 
 fullnameOverride string "" Fully override resource names 
 
 extraDeploy list [] Array of extra objects to deploy with the release 
 
 config.advanced tpl/object {} Advanced configuration options. 
 
 config.auth tpl/object {} Auth configuration options. 
 
 config.core tpl/object {} Core configuration options.
 If external admins in auth are defined and there are no admin_user and admin_password defined here, the default admin account will be disabled.		 
 
 config.database tpl/object {} Database configuration options 
 
 config.mail tpl/object {} Mail configuration options 
 
 config.statistics tpl/object {} Statistics configuration options 
 
 config.web tpl/object {} Web configuration options.
 listening_address will be set automatically from service.web.port. external_url is required to enable ingress and certificate resources.		 
 
 revisionHistoryLimit string 10 The number of old ReplicaSets to retain to allow rollback. 
 
 workloadType string "Deployment" Workload type - Deployment or StatefulSet 
 
 strategy object {"type":"RollingUpdate"} Update strategy for the workload Valid values are: RollingUpdate or Recreate for Deployment, RollingUpdate or OnDelete for StatefulSet 
 
 image.repository string "ghcr.io/h44z/wg-portal" Image repository 
 
 image.pullPolicy string "IfNotPresent" Image pull policy 
 
 image.tag string "" Overrides the image tag whose default is the chart appVersion 
 
 imagePullSecrets list [] Image pull secrets 
 
 podAnnotations tpl/object {} Extra annotations to add to the pod 
 
 podLabels object {} Extra labels to add to the pod 
 
 podSecurityContext object {} Pod Security Context 
 
 securityContext.capabilities.add list ["NET_ADMIN"] Add capabilities to the container 
 
 initContainers tpl/list [] Pod init containers 
 
 sidecarContainers tpl/list [] Pod sidecar containers 
 
 dnsPolicy string "ClusterFirst" Set DNS policy for the pod. Valid values are ClusterFirstWithHostNet, ClusterFirst, Default or None. 
 
 restartPolicy string "Always" Restart policy for all containers within the pod. Valid values are Always, OnFailure or Never. 
 
 hostNetwork string false. Use the host's network namespace. 
 
 resources object {} Resources requests and limits 
 
 command list [] Overwrite pod command 
 
 args list [] Additional pod arguments 
 
 env tpl/list [] Additional environment variables 
 
 envFrom tpl/list [] Additional environment variables from a secret or configMap 
 
 livenessProbe object {} Liveness probe configuration 
 
 readinessProbe object {} Readiness probe configuration 
 
 startupProbe object {} Startup probe configuration 
 
 volumes tpl/list [] Additional volumes 
 
 volumeMounts tpl/list [] Additional volumeMounts 
 
 nodeSelector object {"kubernetes.io/os":"linux"} Node Selector configuration 
 
 tolerations list [] Tolerations configuration 
 
 affinity object {} Affinity configuration 
 
 service.mixed.enabled bool false Whether to create a single service for the web and wireguard interfaces 
 
 service.mixed.type string "LoadBalancer" Service type 
 
 service.web.annotations object {} Annotations for the web service 
 
 service.web.type string "ClusterIP" Web service type 
 
 service.web.port int 8888 Web service port Used for the web interface listener 
 
 service.web.appProtocol string "http" Web service appProtocol. Will be auto set to https if certificate is enabled. 
 
 service.wireguard.annotations object {} Annotations for the WireGuard service 
 
 service.wireguard.type string "LoadBalancer" Wireguard service type 
 
 service.wireguard.ports list [51820] Wireguard service ports. Exposes the WireGuard ports for created interfaces. Lowerest port is selected as start port for the first interface. Increment next port by 1 for each additional interface. 
 
 service.metrics.port int 8787  
 
 ingress.enabled bool false Specifies whether an ingress resource should be created 
 
 ingress.className string "" Ingress class name 
 
 ingress.annotations object {} Ingress annotations 
 
 ingress.tls bool false Ingress TLS configuration. Enable certificate resource or add ingress annotation to create required secret 
 
 certificate.enabled bool false Specifies whether a certificate resource should be created. If enabled, certificate will be used for the web. 
 
 certificate.issuer.name string "" Certificate issuer name 
 
 certificate.issuer.kind string "" Certificate issuer kind (ClusterIssuer or Issuer) 
 
 certificate.issuer.group string "cert-manager.io" Certificate issuer group 
 
 certificate.duration string "" Optional. Documentation 
 
 certificate.renewBefore string "" Optional. Documentation 
 
 certificate.commonName string "" Optional. Documentation 
 
 certificate.emailAddresses list [] Optional. Documentation 
 
 certificate.ipAddresses list [] Optional. Documentation 
 
 certificate.keystores object {} Optional. Documentation 
 
 certificate.privateKey object {} Optional. Documentation 
 
 certificate.secretTemplate object {} Optional. Documentation 
 
 certificate.subject object {} Optional. Documentation 
 
 certificate.uris list [] Optional. Documentation 
 
 certificate.usages list [] Optional. Documentation 
 
 persistence.enabled bool false Specifies whether an persistent volume should be created 
 
 persistence.annotations object {} Persistent Volume Claim annotations 
 
 persistence.storageClass string "" Persistent Volume storage class. If undefined (the default) cluster's default provisioner will be used. 
 
 persistence.accessMode string "ReadWriteOnce" Persistent Volume Access Mode 
 
 persistence.size string "1Gi" Persistent Volume size 
 
 persistence.volumeName string "" Persistent Volume Name (optional) 
 
 serviceAccount.create bool true Specifies whether a service account should be created 
 
 serviceAccount.annotations object {} Service account annotations 
 
 serviceAccount.automount bool false Automatically mount a ServiceAccount's API credentials 
 
 serviceAccount.name string "" The name of the service account to use. If not set and create is true, a name is generated using the fullname template 
 
 monitoring.enabled bool false Enable Prometheus monitoring. 
 
 monitoring.apiVersion string "monitoring.coreos.com/v1" API version of the Prometheus resource. Use azmonitoring.coreos.com/v1 for Azure Managed Prometheus. 
 
 monitoring.kind string "PodMonitor" Kind of the Prometheus resource. Could be PodMonitor or ServiceMonitor. 
 
 monitoring.labels object {} Resource labels. 
 
 monitoring.annotations object {} Resource annotations. 
 
 monitoring.interval string 1m Interval at which metrics should be scraped. If not specified config.statistics.data_collection_interval interval is used. 
 
 monitoring.metricRelabelings list [] Relabelings to samples before ingestion. 
 
 monitoring.relabelings list [] Relabelings to samples before scraping. 
 
 monitoring.scrapeTimeout string "" Timeout after which the scrape is ended If not specified, the Prometheus global scrape interval is used. 
 
 monitoring.jobLabel string "" The label to use to retrieve the job name from. 
 
 monitoring.podTargetLabels object {} Transfers labels on the Kubernetes Pod onto the target. 
 
 monitoring.dashboard.enabled bool false Enable Grafana dashboard. 
 
 monitoring.dashboard.annotations object {} Annotations for the dashboard ConfigMap. 
 
 monitoring.dashboard.labels object {} Additional labels for the dashboard ConfigMap. 
 
 monitoring.dashboard.namespace string "" Dashboard ConfigMap namespace Overrides the namespace for the dashboard ConfigMap. 
  
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/getting-started/reverse-proxy/index.html b/master/documentation/getting-started/reverse-proxy/index.html
index 9259a3a..2e1d3eb 100644
--- a/master/documentation/getting-started/reverse-proxy/index.html
+++ b/master/documentation/getting-started/reverse-proxy/index.html
@@ -1,4 +1,4 @@
- Reverse Proxy (HTTPS) - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Reverse Proxy (HTTPS)
 
Reverse Proxy for HTTPS
 
For production deployments, always serve the WireGuard Portal over HTTPS. You have two options to secure your connection:
 
Reverse Proxy
 
Let a front‐end proxy handle HTTPS for you. This also frees you from managing certificates manually and is therefore the preferred option. You can use Nginx, Traefik, Caddy or any other proxy. 
 
Below is an example using a Docker Compose stack with Traefik. It exposes the WireGuard Portal on https://wg.domain.com and redirects initial HTTP traffic to HTTPS.
 
services:
+ Reverse Proxy (HTTPS) - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Reverse Proxy (HTTPS)
 
Reverse Proxy for HTTPS
 
For production deployments, always serve the WireGuard Portal over HTTPS. You have two options to secure your connection:
 
Reverse Proxy
 
Let a front‐end proxy handle HTTPS for you. This also frees you from managing certificates manually and is therefore the preferred option. You can use Nginx, Traefik, Caddy or any other proxy. 
 
Below is an example using a Docker Compose stack with Traefik. It exposes the WireGuard Portal on https://wg.domain.com and redirects initial HTTP traffic to HTTPS.
 
services:
   reverse-proxy:
     image: traefik:v3.3
     restart: unless-stopped
diff --git a/master/documentation/getting-started/sources/index.html b/master/documentation/getting-started/sources/index.html
index e519213..4b4ac25 100644
--- a/master/documentation/getting-started/sources/index.html
+++ b/master/documentation/getting-started/sources/index.html
@@ -1,4 +1,4 @@
- Sources - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Sources
 
To build the application from source files, use the Makefile provided in the repository.
 
Requirements
  
Build
 
# Get source code
+ Sources - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Sources
 
To build the application from source files, use the Makefile provided in the repository.
 
Requirements
  
Build
 
# Get source code
 git clone https://github.com/h44z/wg-portal -b ${WG_PORTAL_VERSION:-master} --depth 1
 cd wg-portal
 # Build the frontend
diff --git a/master/documentation/monitoring/prometheus/index.html b/master/documentation/monitoring/prometheus/index.html
index a1f0b1b..520ff87 100644
--- a/master/documentation/monitoring/prometheus/index.html
+++ b/master/documentation/monitoring/prometheus/index.html
@@ -1,4 +1,4 @@
- Monitoring - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
 
Exposed Metrics
 
  
 Metric Type Description 
   
 wireguard_interface_received_bytes_total gauge Bytes received through the interface. 
 
 wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. 
 
 wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. 
 
 wireguard_peer_received_bytes_total gauge Bytes received from the peer. 
 
 wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. 
 
 wireguard_peer_up gauge Peer connection state (boolean: 1/0). 
  
 
Prometheus Config
 
Add the following scrape job to your Prometheus config file:
 
# prometheus.yaml
+ Monitoring - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
 
Exposed Metrics
 
  
 Metric Type Description 
   
 wireguard_interface_received_bytes_total gauge Bytes received through the interface. 
 
 wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. 
 
 wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. 
 
 wireguard_peer_received_bytes_total gauge Bytes received from the peer. 
 
 wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. 
 
 wireguard_peer_up gauge Peer connection state (boolean: 1/0). 
  
 
Prometheus Config
 
Add the following scrape job to your Prometheus config file:
 
# prometheus.yaml
 scrape_configs:
   - job_name: wg-portal
     scrape_interval: 60s
diff --git a/master/documentation/overview/index.html b/master/documentation/overview/index.html
index e4a8706..b082869 100644
--- a/master/documentation/overview/index.html
+++ b/master/documentation/overview/index.html
@@ -1 +1 @@
- Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
  
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL, or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
 
Features
 
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI with dark-mode written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP), Passkey support
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Supports multiple WireGuard backends (wgctrl, MikroTik, or pfSense)
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface, or user updates
    •  
 
 
  
 
   
 
 
 
     
\ No newline at end of file
+ Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
  
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL, or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
 
Features
 
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI with dark-mode written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP), Passkey support
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Supports multiple WireGuard backends (wgctrl, MikroTik, or pfSense)
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface, or user updates
    •  
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/rest-api/api-doc/index.html b/master/documentation/rest-api/api-doc/index.html
index dcdbc51..356b622 100644
--- a/master/documentation/rest-api/api-doc/index.html
+++ b/master/documentation/rest-api/api-doc/index.html
@@ -1,5 +1,5 @@
 
- REST API - WireGuard Portal     
 
 
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
REST API
 
 
 
  
 
   
 
 
 
         
 
 
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
REST API
 
 
 
  
 
   
 
 
 
          
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Upgrade
 
Major upgrades between different versions may require special procedures, which are described in the following sections.
 
Upgrade from v1 to v2
 
 
⚠ Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yaml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db
+ Upgrade - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Upgrade
 
Major upgrades between different versions may require special procedures, which are described in the following sections.
 
Upgrade from v1 to v2
 
 
⚠ Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yaml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db
 
 
You can also specify the database type using the parameter -migrateFromType. Supported database types: mysql, mssql, postgres or sqlite.
 
For example:
 
./wg-portal-amd64 -migrateFromType=mysql -migrateFrom='user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local'
 
 
The upgrade will transform the old, existing database and store the values in the new database specified in the config.yaml configuration file. Ensure that the new database does not contain any data!
 
If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
 
services:
   wg-portal:
diff --git a/master/documentation/usage/authentication/index.html b/master/documentation/usage/authentication/index.html
new file mode 100644
index 0000000..d3b785b
--- /dev/null
+++ b/master/documentation/usage/authentication/index.html
@@ -0,0 +1,28 @@
+ Authentication - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Authentication
 
WireGuard Portal supports multiple authentication mechanisms to manage user access. This includes
 
     
  • Local user accounts
    •  
  • LDAP authentication
    •  
  • OAuth2 and OIDC authentication
    •  
  • Passkey authentication (WebAuthn)
    •  
 
Users can have two roles which limit their permissions in WireGuard Portal:
 
     
  • User: Can manage their own account and peers.
    •  
  • Admin: Can manage all users and peers, including the ability to manage WireGuard interfaces.
    •  
 
In general, each user is identified by a unique identifier. If the same user identifier exists across multiple authentication sources, WireGuard Portal automatically merges those accounts into a single user record. When a user is associated with multiple authentication sources, their information in WireGuard Portal is updated based on the most recently logged-in source. For more details, see User Synchronization documentation.
 
Password Authentication
 
WireGuard Portal supports username and password authentication for both local and LDAP-backed accounts. Local users are stored in the database, while LDAP users are authenticated against an external LDAP server.
 
On initial startup, WireGuard Portal automatically creates a local admin account with the password wgportal-default.
 
 
⚠ This password must be changed immediately after the first login.
 
 
The minimum password length for all local users can be configured in the auth section of the configuration file. The default value is 16 characters, see min_password_length. The minimum password length is also enforced for the default admin user.
 
Passkey (WebAuthn) Authentication
 
Besides the standard authentication mechanisms, WireGuard Portal supports Passkey authentication. This feature is enabled by default and can be configured in the webauthn section of the configuration file.
 
Users can register multiple Passkeys to their account. These Passkeys can be used to log in to the web UI as long as the user is not locked.
 
 
⚠ Passkey authentication does not disable password authentication. The password can still be used to log in (e.g., as a fallback).
 
 
To register a Passkey, open the settings page (1) in the web UI and click on the "Register Passkey" (2) button.
 
Passkey UI
 
OAuth2 and OIDC Authentication
 
WireGuard Portal supports OAuth2 and OIDC authentication. You can use any OAuth2 or OIDC provider that supports the authorization code flow, such as Google, GitHub, or Keycloak.
 
For OAuth2 or OIDC to work, you need to configure the external_url property in the web section of the configuration file. If you are planning to expose the portal to the internet, make sure that the external_url is configured to use HTTPS.
 
To add OIDC or OAuth2 authentication to WireGuard Portal, create a Client-ID and Client-Secret in your OAuth2 provider and configure a new authentication provider in the auth section of the configuration file. Make sure that each configured provider has a unique provider_name property set. Samples can be seen here.
 
Limiting Login to Specific Domains
 
You can limit the login to specific domains by setting the allowed_domains property for OAuth2 or OIDC providers. This property is a comma-separated list of domains that are allowed to log in. The user's email address is checked against this list. For example, if you want to allow only users with an email address ending in outlook.com to log in, set the property as follows:
 
auth:
+  oidc:
+    - provider_name: "oidc1"
+      # ... other settings
+      allowed_domains:
+        - "outlook.com"
+
 
Limit Login to Existing Users
 
You can limit the login to existing users only by setting the registration_enabled property to false for OAuth2 or OIDC providers. If registration is enabled, new users will be created in the database when they log in for the first time.
 
Admin Mapping
 
You can map users to admin roles based on their attributes in the OAuth2 or OIDC provider. To do this, set the admin_mapping property for the provider. Administrative access can either be mapped by a specific attribute or by group membership.
 
Attribute specific mapping can be achieved by setting the admin_value_regex and the is_admin property. The admin_value_regex property is a regular expression that is matched against the value of the is_admin attribute. The user is granted admin access if the regex matches the attribute value.
 
Example: 
auth:
+  oidc:
+    - provider_name: "oidc1"
+      # ... other settings
+      field_map:
+        is_admin: "wg_admin_prop"
+      admin_mapping:
+        admin_value_regex: "^true$"
+
 The example above will grant admin access to users with the wg_admin_prop attribute set to true.
 
Group membership mapping can be achieved by setting the admin_group_regex and user_groups property. The admin_group_regex property is a regular expression that is matched against the group names of the user. The user is granted admin access if the regex matches any of the group names.
 
Example: 
auth:
+  oidc:
+    - provider_name: "oidc1"
+      # ... other settings
+      field_map:
+        user_groups: "groups"
+      admin_mapping:
+        admin_group_regex: "^the-admin-group$"
+
 The example above will grant admin access to users who are members of the the-admin-group group.
 
LDAP Authentication
 
WireGuard Portal supports LDAP authentication. You can use any LDAP server that supports the LDAP protocol, such as Active Directory or OpenLDAP. Multiple LDAP servers can be configured in the auth section of the configuration file. WireGuard Portal remembers the authentication provider of the user and therefore avoids conflicts between multiple LDAP providers.
 
To configure LDAP authentication, create a new ldap authentication provider in the auth section of the configuration file.
 
Limiting Login to Specific Users
 
You can limit the login to specific users by setting the login_filter property for LDAP provider. This filter uses the LDAP search filter syntax. The username can be inserted into the query by placing the {{login_identifier}} placeholder in the filter. This placeholder will then be replaced with the username entered by the user during login.
 
For example, if you want to allow only users with the objectClass attribute set to organizationalPerson to log in, set the property as follows:
 
auth:
+  ldap:
+    - provider_name: "ldap1"
+      # ... other settings
+      login_filter: "(&(objectClass=organizationalPerson)(uid={{login_identifier}}))"
+
 
The login_filter should always be designed to return at most one user.
 
Limit Login to Existing Users
 
You can limit the login to existing users only by setting the registration_enabled property to false for LDAP providers. If registration is enabled, new users will be created in the database when they log in for the first time.
 
Admin Mapping
 
You can map users to admin roles based on their group membership in the LDAP server. To do this, set the admin_group and memberof property for the provider. The admin_group property defines the distinguished name of the group that is allowed to log in as admin. All groups that are listed in the memberof attribute of the user will be checked against this group. If one of the groups matches, the user is granted admin access.
 
User Synchronization
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/usage/backends/index.html b/master/documentation/usage/backends/index.html
index db9740f..f2453e2 100644
--- a/master/documentation/usage/backends/index.html
+++ b/master/documentation/usage/backends/index.html
@@ -1,4 +1,4 @@
- Backends - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Backends
 
WireGuard Portal can manage WireGuard interfaces and peers on different backends. Each backend represents a system where interfaces actually live. You can register multiple backends and choose which one to use per interface. A global default backend determines where newly created interfaces go (unless you explicitly choose another in the UI).
 
Supported backends: - Local (default): Manages interfaces on the host running WireGuard Portal (Linux WireGuard via wgctrl). Use this when the portal should directly configure wg devices on the same server. - MikroTik RouterOS (beta): Manages interfaces and peers on MikroTik devices via the RouterOS REST API. Use this to control WG interfaces on RouterOS v7+. - pfSense (alpha): Manages interfaces and peers on pfSense firewalls via the pfSense REST API.
 
How backend selection works: - The default backend is configured at backend.default (local or the id of a defined MikroTik backend). New interfaces created in the UI will use this backend by default. - Each interface stores its backend. You can select a different backend when creating a new interface.
 
Configuring MikroTik backends (RouterOS v7+)
 
 
⚠ The MikroTik backend is currently marked beta. While basic functionality is implemented, some advanced features are not yet implemented or contain bugs. Please test carefully before using in production.
 
 
The MikroTik backend uses the REST API under a base URL ending with /rest. You can register one or more MikroTik devices as backends for a single WireGuard Portal instance.
 
Prerequisites on MikroTik:
 
     
  • RouterOS v7 with WireGuard support.
    •  
  • REST API enabled and reachable over HTTP(S). A typical base URL is https://:8729/rest or https:///rest depending on your service setup.
    •  
  • A dedicated RouterOS user with the following group permissions:
    •  
  • api (for logging in via REST API)
    •  
  • rest-api (for logging in via REST API)
    •  
  • read (to read interface and peer data)
    •  
  • write (to create/update interfaces and peers)
    •  
  • test (to perform ping checks)
    •  
  • sensitive (to read private keys)
    •  
  • TLS certificate on the device is recommended. If you use a self-signed certificate during testing, set api_verify_tls: false in wg-portal (not recommended for production).
    •  
 
Example WireGuard Portal configuration (config/config.yaml):
 
backend:
+ Backends - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Backends
 
WireGuard Portal can manage WireGuard interfaces and peers on different backends. Each backend represents a system where interfaces actually live. You can register multiple backends and choose which one to use per interface. A global default backend determines where newly created interfaces go (unless you explicitly choose another in the UI).
 
Supported backends: - Local (default): Manages interfaces on the host running WireGuard Portal (Linux WireGuard via wgctrl). Use this when the portal should directly configure wg devices on the same server. - MikroTik RouterOS (beta): Manages interfaces and peers on MikroTik devices via the RouterOS REST API. Use this to control WG interfaces on RouterOS v7+. - pfSense (alpha): Manages interfaces and peers on pfSense firewalls via the pfSense REST API.
 
How backend selection works: - The default backend is configured at backend.default (local or the id of a defined MikroTik backend). New interfaces created in the UI will use this backend by default. - Each interface stores its backend. You can select a different backend when creating a new interface.
 
Configuring MikroTik backends (RouterOS v7+)
 
 
⚠ The MikroTik backend is currently marked beta. While basic functionality is implemented, some advanced features are not yet implemented or contain bugs. Please test carefully before using in production.
 
 
The MikroTik backend uses the REST API under a base URL ending with /rest. You can register one or more MikroTik devices as backends for a single WireGuard Portal instance.
 
Prerequisites on MikroTik:
 
     
  • RouterOS v7 with WireGuard support.
    •  
  • REST API enabled and reachable over HTTP(S). A typical base URL is https://:8729/rest or https:///rest depending on your service setup.
    •  
  • A dedicated RouterOS user with the following group permissions:
    •  
  • api (for logging in via REST API)
    •  
  • rest-api (for logging in via REST API)
    •  
  • read (to read interface and peer data)
    •  
  • write (to create/update interfaces and peers)
    •  
  • test (to perform ping checks)
    •  
  • sensitive (to read private keys)
    •  
  • TLS certificate on the device is recommended. If you use a self-signed certificate during testing, set api_verify_tls: false in wg-portal (not recommended for production).
    •  
 
Example WireGuard Portal configuration (config/config.yaml):
 
backend:
   # default backend decides where new interfaces are created
   default: mikrotik-prod
 
diff --git a/master/documentation/usage/general/index.html b/master/documentation/usage/general/index.html
index e64885f..26947ea 100644
--- a/master/documentation/usage/general/index.html
+++ b/master/documentation/usage/general/index.html
@@ -1,2 +1,2 @@
- General - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
General
 
This documentation section describes the general usage of WireGuard Portal. If you are looking for specific setup instructions, please refer to the Getting Started and Configuration sections, for example, using a Docker deployment.
 
Basic Concepts
 
WireGuard Portal is a web-based configuration portal for WireGuard server management. It allows managing multiple WireGuard interfaces and users from a single web UI. WireGuard Interfaces can be categorized into three types:
 
     
  • Server: A WireGuard server interface that to which multiple peers can connect. In this mode, it is possible to specify default settings for all peers, such as the IP address range, DNS servers, and MTU size.
    •  
  • Client: A WireGuard client interface that can be used to connect to a WireGuard server. Usually, such an interface has exactly one peer.
    •  
  • Unknown: This is the default type for imported interfaces. It is encouraged to change the type to either Server or Client after importing the interface. 
    •  
 
Accessing the Web UI
 
The web UI should be accessed via the URL specified in the external_url property of the configuration file. By default, WireGuard Portal listens on port 8888 for HTTP connections. Check the Security section for more information on securing the web UI.
 
So the default URL to access the web UI is:
 
http://localhost:8888
+ General - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
General
 
This documentation section describes the general usage of WireGuard Portal. If you are looking for specific setup instructions, please refer to the Getting Started and Configuration sections, for example, using a Docker deployment.
 
Basic Concepts
 
WireGuard Portal is a web-based configuration portal for WireGuard server management. It allows managing multiple WireGuard interfaces and users from a single web UI. WireGuard Interfaces can be categorized into three types:
 
     
  • Server: A WireGuard server interface that to which multiple peers can connect. In this mode, it is possible to specify default settings for all peers, such as the IP address range, DNS servers, and MTU size.
    •  
  • Client: A WireGuard client interface that can be used to connect to a WireGuard server. Usually, such an interface has exactly one peer.
    •  
  • Unknown: This is the default type for imported interfaces. It is encouraged to change the type to either Server or Client after importing the interface. 
    •  
 
Accessing the Web UI
 
The web UI should be accessed via the URL specified in the external_url property of the configuration file. By default, WireGuard Portal listens on port 8888 for HTTP connections. Check the Security or Authentication sections for more information on securing the web UI.
 
So the default URL to access the web UI is:
 
http://localhost:8888
 
 
A freshly set-up WireGuard Portal instance will have a default admin user with the username admin@wgportal.local and the password wgportal-default. You can and should override the default credentials in the configuration file. Make sure to change the default password immediately after the first login!
 
Basic UI Description
 
WireGuard Portal Web UI
 
As seen in the screenshot above, the web UI is divided into several sections which are accessible via the navigation bar on the top of the screen.
 
     
  1. Home: The landing page of WireGuard Portal. It provides a staring point for the user to access the different sections of the web UI. It also provides quick links to WireGuard Client downloads or official documentation.
    2.  
  2. Interfaces: This section allows you to manage the WireGuard interfaces. You can add, edit, or delete interfaces, as well as view their status and statistics. Peers for each interface can be managed here as well.
    3.  
  3. Users: This section allows you to manage the users of WireGuard Portal. You can add, edit, or delete users, as well as view their status and statistics.
    4.  
  4. Key Generator: This section allows you to generate WireGuard keys locally on your browser. The generated keys are never sent to the server. This is useful if you want to generate keys for a new peer without having to store the private keys in the database.
    5.  
  5. Profile / Settings: This section allows you to access your own profile page, settings, and audit logs. 
    6.  
 
Interface View
 
WireGuard Portal Interface View
 
The interface view provides an overview of the WireGuard interfaces and peers configured in WireGuard Portal.
 
The most important elements are:
 
     
  1. Interface Selector: This dropdown allows you to select the WireGuard interface you want to manage. All further actions will be performed on the selected interface.
    2.  
  2. Create new Interface: This button allows you to create a new WireGuard interface.
    3.  
  3. Interface Overview: This section provides an overview of the selected WireGuard interface. It shows the interface type, number of peers, and other important information.
    4.  
  4. List of Peers: This section provides a list of all peers associated with the selected WireGuard interface. You can view, add, edit, or delete peers from this list.
    5.  
  5. Add new Peer: This button allows you to add a new peer to the selected WireGuard interface.
    6.  
  6. Add multiple Peers: This button allows you to add multiple peers to the selected WireGuard interface. This is useful if you want to add a large number of peers at once.
    7.  
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/usage/ldap/index.html b/master/documentation/usage/ldap/index.html
deleted file mode 100644
index 62a52e1..0000000
--- a/master/documentation/usage/ldap/index.html
+++ /dev/null
@@ -1,6 +0,0 @@
- LDAP - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
LDAP
 
WireGuard Portal lets you hook up any LDAP server such as Active Directory or OpenLDAP for both authentication and user sync. You can even register multiple LDAP servers side-by-side. When someone logs in via LDAP, their specific provider is remembered, so there's no risk of cross-provider conflicts. Details on the log-in process can be found in the Security documentation.
 
If you enable LDAP synchronization, all users within the LDAP directory will be created automatically in the WireGuard Portal database if they do not exist. If a user is disabled or deleted in LDAP, the user will be disabled in WireGuard Portal as well. The synchronization process can be fine-tuned by multiple parameters, which are described below.
 
LDAP Synchronization
 
WireGuard Portal can automatically synchronize users from LDAP to the database. To enable this feature, set the sync_interval property in the LDAP provider configuration to a value greater than "0". The value is a string representing a duration, such as "15m" for 15 minutes or "1h" for 1 hour (check the exact format definition for details). The synchronization process will run in the background and synchronize users from LDAP to the database at the specified interval. Also make sure that the sync_filter property is a well-formed LDAP filter, or synchronization will fail.
 
Limiting Synchronization to Specific Users
 
Use the sync_filter property in your LDAP provider block to restrict which users get synchronized. It accepts any valid LDAP search filter, only entries matching that filter will be pulled into the portal's database. 
 
For example, to import only users with a mail attribute: 
auth:
-  ldap:
-    - id: ldap
-      # ... other settings
-      sync_filter: (mail=*)
-
 
Disable Missing Users
 
If you set the disable_missing property to true, any user that is not found in LDAP during synchronization will be disabled in WireGuard Portal. All peers associated with that user will also be disabled.
 
If you want a user and its peers to be automatically re-enabled once they are found in LDAP again, set the auto_re_enable property to true. This will only re-enable the user if they where disabled by the synchronization process. Manually disabled users will not be re-enabled.
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/usage/mail-templates/index.html b/master/documentation/usage/mail-templates/index.html
index f277d3f..dbf3c01 100644
--- a/master/documentation/usage/mail-templates/index.html
+++ b/master/documentation/usage/mail-templates/index.html
@@ -1,4 +1,4 @@
- Mail Templates - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Mail Templates
 
WireGuard Portal sends emails when you share a configuration with a user. By default, the application uses embedded templates. You can fully customize these emails by pointing the Portal to a folder containing your own templates. If the folder is empty on startup, the default embedded templates are written there to get you started.
 
Configuration
 
To enable custom templates, set the mail.templates_path option in the application configuration file or the WG_PORTAL_MAIL_TEMPLATES_PATH environment variable to a valid folder path.
 
For example:
 
mail:
+ Mail Templates - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Mail Templates
 
WireGuard Portal sends emails when you share a configuration with a user. By default, the application uses embedded templates. You can fully customize these emails by pointing the Portal to a folder containing your own templates. If the folder is empty on startup, the default embedded templates are written there to get you started.
 
Configuration
 
To enable custom templates, set the mail.templates_path option in the application configuration file or the WG_PORTAL_MAIL_TEMPLATES_PATH environment variable to a valid folder path.
 
For example:
 
mail:
   # ... other mail options ...
   # Path where custom email templates (.gotpl and .gohtml) are stored.
   # If the directory is empty on startup, the default embedded templates
diff --git a/master/documentation/usage/security/index.html b/master/documentation/usage/security/index.html
index a8874c0..1d33b30 100644
--- a/master/documentation/usage/security/index.html
+++ b/master/documentation/usage/security/index.html
@@ -1,28 +1 @@
- Security - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Security
 
This section describes the security features available to administrators for hardening WireGuard Portal and protecting its data.
 
Authentication
 
WireGuard Portal supports multiple authentication methods, including:
 
     
  • Local user accounts
    •  
  • LDAP authentication
    •  
  • OAuth and OIDC authentication
    •  
  • Passkey authentication (WebAuthn)
    •  
 
Users can have two roles which limit their permissions in WireGuard Portal:
 
     
  • User: Can manage their own account and peers.
    •  
  • Admin: Can manage all users and peers, including the ability to manage WireGuard interfaces.
    •  
 
Password Security
 
WireGuard Portal supports username and password authentication for both local and LDAP-backed accounts. Local users are stored in the database, while LDAP users are authenticated against an external LDAP server.
 
On initial startup, WireGuard Portal automatically creates a local admin account with the password wgportal-default.
 
 
⚠ This password must be changed immediately after the first login.
 
 
The minimum password length for all local users can be configured in the auth section of the configuration file. The default value is 16 characters, see min_password_length. The minimum password length is also enforced for the default admin user.
 
Passkey (WebAuthn) Authentication
 
Besides the standard authentication mechanisms, WireGuard Portal supports Passkey authentication. This feature is enabled by default and can be configured in the webauthn section of the configuration file.
 
Users can register multiple Passkeys to their account. These Passkeys can be used to log in to the web UI as long as the user is not locked.
 
 
⚠ Passkey authentication does not disable password authentication. The password can still be used to log in (e.g., as a fallback).
 
 
To register a Passkey, open the settings page (1) in the web UI and click on the "Register Passkey" (2) button.
 
Passkey UI
 
OAuth and OIDC Authentication
 
WireGuard Portal supports OAuth and OIDC authentication. You can use any OAuth or OIDC provider that supports the authorization code flow, such as Google, GitHub, or Keycloak.
 
For OAuth or OIDC to work, you need to configure the external_url property in the web section of the configuration file. If you are planning to expose the portal to the internet, make sure that the external_url is configured to use HTTPS.
 
To add OIDC or OAuth authentication to WireGuard Portal, create a Client-ID and Client-Secret in your OAuth provider and configure a new authentication provider in the auth section of the configuration file. Make sure that each configured provider has a unique provider_name property set. Samples can be seen here.
 
Limiting Login to Specific Domains
 
You can limit the login to specific domains by setting the allowed_domains property for OAuth or OIDC providers. This property is a comma-separated list of domains that are allowed to log in. The user's email address is checked against this list. For example, if you want to allow only users with an email address ending in outlook.com to log in, set the property as follows:
 
auth:
-  oidc:
-    - provider_name: "oidc1"
-      # ... other settings
-      allowed_domains:
-        - "outlook.com"
-
 
Limit Login to Existing Users
 
You can limit the login to existing users only by setting the registration_enabled property to false for OAuth or OIDC providers. If registration is enabled, new users will be created in the database when they log in for the first time.
 
Admin Mapping
 
You can map users to admin roles based on their attributes in the OAuth or OIDC provider. To do this, set the admin_mapping property for the provider. Administrative access can either be mapped by a specific attribute or by group membership.
 
Attribute specific mapping can be achieved by setting the admin_value_regex and the is_admin property. The admin_value_regex property is a regular expression that is matched against the value of the is_admin attribute. The user is granted admin access if the regex matches the attribute value.
 
Example: 
auth:
-  oidc:
-    - provider_name: "oidc1"
-      # ... other settings
-      field_map:
-        is_admin: "wg_admin_prop"
-      admin_mapping:
-        admin_value_regex: "^true$"
-
 The example above will grant admin access to users with the wg_admin_prop attribute set to true.
 
Group membership mapping can be achieved by setting the admin_group_regex and user_groups property. The admin_group_regex property is a regular expression that is matched against the group names of the user. The user is granted admin access if the regex matches any of the group names.
 
Example: 
auth:
-  oidc:
-    - provider_name: "oidc1"
-      # ... other settings
-      field_map:
-        user_groups: "groups"
-      admin_mapping:
-        admin_group_regex: "^the-admin-group$"
-
 The example above will grant admin access to users who are members of the the-admin-group group.
 
LDAP Authentication
 
WireGuard Portal supports LDAP authentication. You can use any LDAP server that supports the LDAP protocol, such as Active Directory or OpenLDAP. Multiple LDAP servers can be configured in the auth section of the configuration file. WireGuard Portal remembers the authentication provider of the user and therefore avoids conflicts between multiple LDAP providers.
 
To configure LDAP authentication, create a new ldap authentication provider in the auth section of the configuration file.
 
Limiting Login to Specific Users
 
You can limit the login to specific users by setting the login_filter property for LDAP provider. This filter uses the LDAP search filter syntax. The username can be inserted into the query by placing the {{login_identifier}} placeholder in the filter. This placeholder will then be replaced with the username entered by the user during login.
 
For example, if you want to allow only users with the objectClass attribute set to organizationalPerson to log in, set the property as follows:
 
auth:
-  ldap:
-    - provider_name: "ldap1"
-      # ... other settings
-      login_filter: "(&(objectClass=organizationalPerson)(uid={{login_identifier}}))"
-
 
The login_filter should always be designed to return at most one user.
 
Limit Login to Existing Users
 
You can limit the login to existing users only by setting the registration_enabled property to false for LDAP providers. If registration is enabled, new users will be created in the database when they log in for the first time.
 
Admin Mapping
 
You can map users to admin roles based on their group membership in the LDAP server. To do this, set the admin_group and memberof property for the provider. The admin_group property defines the distinguished name of the group that is allowed to log in as admin. All groups that are listed in the memberof attribute of the user will be checked against this group. If one of the groups matches, the user is granted admin access.
 
UI and API Access
 
WireGuard Portal provides a web UI and a REST API for user interaction. It is important to secure these interfaces to prevent unauthorized access and data breaches.
 
HTTPS
 
It is recommended to use HTTPS for all communication with the portal to prevent eavesdropping. 
 
Event though, WireGuard Portal supports HTTPS out of the box, it is recommended to use a reverse proxy like Nginx or Traefik to handle SSL termination and other security features. A detailed explanation is available in the Reverse Proxy section.
 
 
  
 
   
 
 
 
     
\ No newline at end of file
+ Security - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Security
 
This section describes the security features available to administrators for hardening WireGuard Portal and protecting its data.
 
Database Encryption
 
WireGuard Portal supports multiple database backends. To reduce the risk of data exposure, sensitive information stored in the database can be encrypted. To enable encryption, set the encryption_passphrase in the database configuration section.
 
 
⚠ Important: Once encryption is enabled, it cannot be disabled, and the passphrase cannot be changed! Only new or updated records will be encrypted; existing data remains in plaintext until it’s next modified.
 
 
UI and API Access
 
WireGuard Portal provides a web UI and a REST API for user interaction. It is important to secure these interfaces to prevent unauthorized access and data breaches.
 
HTTPS
 
It is recommended to use HTTPS for all communication with the portal to prevent eavesdropping. 
 
Event though, WireGuard Portal supports HTTPS out of the box, it is recommended to use a reverse proxy like Nginx or Traefik to handle SSL termination and other security features. A detailed explanation is available in the Reverse Proxy section.
 
Secure Authentication
 
To prevent unauthorized access, WireGuard Portal supports integrating with secure authentication providers such as LDAP, OAuth2, or Passkeys, see Authentication for more details. When possible, use centralized authentication and enforce multi-factor authentication (MFA) at the provider level for enhanced account security. For local accounts, administrators should enforce strong password requirements.
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/usage/user-sync/index.html b/master/documentation/usage/user-sync/index.html
new file mode 100644
index 0000000..748de8e
--- /dev/null
+++ b/master/documentation/usage/user-sync/index.html
@@ -0,0 +1,6 @@
+ User Management - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
User Management
 
For all external authentication providers (LDAP, OIDC, OAuth2), WireGuard Portal can automatically create a local user record upon the user's first successful login. This behavior is controlled by the registration_enabled setting in each authentication provider's configuration.
 
User information from external authentication sources is merged into the corresponding local WireGuard Portal user record whenever the user logs in. Additionally, WireGuard Portal supports periodic synchronization of user data from an LDAP directory.
 
To prevent overwriting local changes, WireGuard Portal allows you to set a per-user flag that disables synchronization of external attributes. When this flag is set, the user in WireGuard Portal will not be updated automatically during log-ins or LDAP synchronization.
 
LDAP Synchronization
 
WireGuard Portal lets you hook up any LDAP server such as Active Directory or OpenLDAP for both authentication and user sync. You can even register multiple LDAP servers side-by-side. Details on the log-in process can be found in the LDAP Authentication section.
 
If you enable LDAP synchronization, all users within the LDAP directory will be created automatically in the WireGuard Portal database if they do not exist. If a user is disabled or deleted in LDAP, the user will be disabled in WireGuard Portal as well. The synchronization process can be fine-tuned by multiple parameters, which are described below.
 
Synchronization Parameters
 
To enable the LDAP sycnhronization this feature, set the sync_interval property in the LDAP provider configuration to a value greater than "0". The value is a string representing a duration, such as "15m" for 15 minutes or "1h" for 1 hour (check the exact format definition for details). The synchronization process will run in the background and synchronize users from LDAP to the database at the specified interval. Also make sure that the sync_filter property is a well-formed LDAP filter, or synchronization will fail.
 
Limiting Synchronization to Specific Users
 
Use the sync_filter property in your LDAP provider block to restrict which users get synchronized. It accepts any valid LDAP search filter, only entries matching that filter will be pulled into the portal's database.
 
For example, to import only users with a mail attribute: 
auth:
+  ldap:
+    - id: ldap
+      # ... other settings
+      sync_filter: (mail=*)
+
 
Disable Missing Users
 
If you set the disable_missing property to true, any user that is not found in LDAP during synchronization will be disabled in WireGuard Portal. All peers associated with that user will also be disabled.
 
If you want a user and its peers to be automatically re-enabled once they are found in LDAP again, set the auto_re_enable property to true. This will only re-enable the user if they were disabled by the synchronization process. Manually disabled users will not be re-enabled.
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/documentation/usage/webhooks/index.html b/master/documentation/usage/webhooks/index.html
index 4ef828f..0d8f7d8 100644
--- a/master/documentation/usage/webhooks/index.html
+++ b/master/documentation/usage/webhooks/index.html
@@ -1,4 +1,4 @@
- Webhooks - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Webhooks
 
Webhooks allow WireGuard Portal to notify external services about events such as user creation, device changes, or configuration updates. This enables integration with other systems and automation workflows.
 
When webhooks are configured and a specified event occurs, WireGuard Portal sends an HTTP POST request to the configured webhook URL. The payload contains event-specific data in JSON format.
 
Configuration
 
All available configuration options for webhooks can be found in the configuration overview.
 
A basic webhook configuration looks like this:
 
webhook:
+ Webhooks - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Webhooks
 
Webhooks allow WireGuard Portal to notify external services about events such as user creation, device changes, or configuration updates. This enables integration with other systems and automation workflows.
 
When webhooks are configured and a specified event occurs, WireGuard Portal sends an HTTP POST request to the configured webhook URL. The payload contains event-specific data in JSON format.
 
Configuration
 
All available configuration options for webhooks can be found in the configuration overview.
 
A basic webhook configuration looks like this:
 
webhook:
   url: https://your-service.example.com/webhook
 
 
Security
 
Webhooks can be secured by using a shared secret. This secret is included in the Authorization header of the webhook request, allowing your service to verify the authenticity of the request. You can set the shared secret in the webhook configuration:
 
webhook:
   url: https://your-service.example.com/webhook
@@ -12,7 +12,7 @@
     // Detailed model descriptions are provided below.
   }
 }
-
 
Payload Models
 
All payload models are encoded as JSON objects. Fields with empty values might be omitted in the payload.
 
User Payload (entity: user)
 
  
 JSON Field Type Description 
   
 CreatedBy string Creator identifier 
 
 UpdatedBy string Last updater identifier 
 
 CreatedAt time.Time Time of creation 
 
 UpdatedAt time.Time Time of last update 
 
 Identifier string Unique user identifier 
 
 Email string User email 
 
 Source string Authentication source 
 
 ProviderName string Name of auth provider 
 
 IsAdmin bool Whether user has admin privileges 
 
 Firstname string User's first name (optional) 
 
 Lastname string User's last name (optional) 
 
 Phone string Contact phone number (optional) 
 
 Department string User's department (optional) 
 
 Notes string Additional notes (optional) 
 
 Disabled *time.Time When user was disabled 
 
 DisabledReason string Reason for deactivation 
 
 Locked *time.Time When user account was locked 
 
 LockedReason string Reason for being locked 
  
 
Peer Payload (entity: peer)
 
  
 JSON Field Type Description 
   
 CreatedBy string Creator identifier 
 
 UpdatedBy string Last updater identifier 
 
 CreatedAt time.Time Creation timestamp 
 
 UpdatedAt time.Time Last update timestamp 
 
 Endpoint string Peer endpoint address 
 
 EndpointPublicKey string Public key of peer endpoint 
 
 AllowedIPsStr string Allowed IPs 
 
 ExtraAllowedIPsStr string Extra allowed IPs 
 
 PresharedKey string Pre-shared key for encryption 
 
 PersistentKeepalive int Keepalive interval in seconds 
 
 DisplayName string Display name of the peer 
 
 Identifier string Unique identifier 
 
 UserIdentifier string Associated user ID (optional) 
 
 InterfaceIdentifier string Interface this peer is attached to 
 
 Disabled *time.Time When the peer was disabled 
 
 DisabledReason string Reason for being disabled 
 
 ExpiresAt *time.Time Expiration date 
 
 Notes string Notes for this peer 
 
 AutomaticallyCreated bool Whether peer was auto-generated 
 
 PrivateKey string Peer private key 
 
 PublicKey string Peer public key 
 
 InterfaceType string Type of the peer interface 
 
 Addresses []string IP addresses 
 
 CheckAliveAddress string Address used for alive checks 
 
 DnsStr string DNS servers 
 
 DnsSearchStr string DNS search domains 
 
 Mtu int MTU (Maximum Transmission Unit) 
 
 FirewallMark uint32 Firewall mark (optional) 
 
 RoutingTable string Custom routing table (optional) 
 
 PreUp string Command before bringing up interface 
 
 PostUp string Command after bringing up interface 
 
 PreDown string Command before bringing down interface 
 
 PostDown string Command after bringing down interface 
  
 
Interface Payload (entity: interface)
 
  
 JSON Field Type Description 
   
 CreatedBy string Creator identifier 
 
 UpdatedBy string Last updater identifier 
 
 CreatedAt time.Time Creation timestamp 
 
 UpdatedAt time.Time Last update timestamp 
 
 Identifier string Unique identifier 
 
 PrivateKey string Private key for the interface 
 
 PublicKey string Public key for the interface 
 
 ListenPort int Listening port 
 
 Addresses []string IP addresses 
 
 DnsStr string DNS servers 
 
 DnsSearchStr string DNS search domains 
 
 Mtu int MTU (Maximum Transmission Unit) 
 
 FirewallMark uint32 Firewall mark 
 
 RoutingTable string Custom routing table 
 
 PreUp string Command before bringing up interface 
 
 PostUp string Command after bringing up interface 
 
 PreDown string Command before bringing down interface 
 
 PostDown string Command after bringing down interface 
 
 SaveConfig bool Whether to save config to file 
 
 DisplayName string Human-readable name 
 
 Type string Type of interface 
 
 DriverType string Driver used 
 
 Disabled *time.Time When the interface was disabled 
 
 DisabledReason string Reason for being disabled 
 
 PeerDefNetworkStr string Default peer network configuration 
 
 PeerDefDnsStr string Default peer DNS servers 
 
 PeerDefDnsSearchStr string Default peer DNS search domains 
 
 PeerDefEndpoint string Default peer endpoint 
 
 PeerDefAllowedIPsStr string Default peer allowed IPs 
 
 PeerDefMtu int Default peer MTU 
 
 PeerDefPersistentKeepalive int Default keepalive value 
 
 PeerDefFirewallMark uint32 Default firewall mark for peers 
 
 PeerDefRoutingTable string Default routing table for peers 
 
 PeerDefPreUp string Default peer pre-up command 
 
 PeerDefPostUp string Default peer post-up command 
 
 PeerDefPreDown string Default peer pre-down command 
 
 PeerDefPostDown string Default peer post-down command 
  
 
Peer Metrics Payload (entity: peer_metric)
 
  
 JSON Field Type Description 
   
 Status PeerStatus Current status of the peer 
 
 Peer Peer Peer data 
  
 
PeerStatus sub-structure:
 
  
 JSON Field Type Description 
   
 UpdatedAt time.Time Time of last status update 
 
 IsConnected bool Is peer currently connected 
 
 IsPingable bool Can peer be pinged 
 
 LastPing *time.Time Time of last successful ping 
 
 BytesReceived uint64 Bytes received from peer 
 
 BytesTransmitted uint64 Bytes sent to peer 
 
 Endpoint string Last known endpoint 
 
 LastHandshake *time.Time Last successful handshake 
 
 LastSessionStart *time.Time Time the last session began 
  
 
Example Payloads
 
The following payload is an example of a webhook event when a peer connects to the VPN:
 
{
+
 
Payload Models
 
All payload models are encoded as JSON objects. Fields with empty values might be omitted in the payload.
 
User Payload (entity: user)
 
  
 JSON Field Type Description 
   
 CreatedBy string Creator identifier 
 
 UpdatedBy string Last updater identifier 
 
 CreatedAt time.Time Time of creation 
 
 UpdatedAt time.Time Time of last update 
 
 Identifier string Unique user identifier 
 
 Email string User email 
 
 AuthSources []AuthSource Authentication sources 
 
 IsAdmin bool Whether user has admin privileges 
 
 Firstname string User's first name (optional) 
 
 Lastname string User's last name (optional) 
 
 Phone string Contact phone number (optional) 
 
 Department string User's department (optional) 
 
 Notes string Additional notes (optional) 
 
 Disabled *time.Time When user was disabled 
 
 DisabledReason string Reason for deactivation 
 
 Locked *time.Time When user account was locked 
 
 LockedReason string Reason for being locked 
  
 
AuthSource:
 
  
 JSON Field Type Description 
   
 Source string The authentication source (e.g. LDAP, OAuth, or DB) 
 
 ProviderName string The identifier of the authentication provider 
  
 
Peer Payload (entity: peer)
 
  
 JSON Field Type Description 
   
 CreatedBy string Creator identifier 
 
 UpdatedBy string Last updater identifier 
 
 CreatedAt time.Time Creation timestamp 
 
 UpdatedAt time.Time Last update timestamp 
 
 Endpoint string Peer endpoint address 
 
 EndpointPublicKey string Public key of peer endpoint 
 
 AllowedIPsStr string Allowed IPs 
 
 ExtraAllowedIPsStr string Extra allowed IPs 
 
 PresharedKey string Pre-shared key for encryption 
 
 PersistentKeepalive int Keepalive interval in seconds 
 
 DisplayName string Display name of the peer 
 
 Identifier string Unique identifier 
 
 UserIdentifier string Associated user ID (optional) 
 
 InterfaceIdentifier string Interface this peer is attached to 
 
 Disabled *time.Time When the peer was disabled 
 
 DisabledReason string Reason for being disabled 
 
 ExpiresAt *time.Time Expiration date 
 
 Notes string Notes for this peer 
 
 AutomaticallyCreated bool Whether peer was auto-generated 
 
 PrivateKey string Peer private key 
 
 PublicKey string Peer public key 
 
 InterfaceType string Type of the peer interface 
 
 Addresses []string IP addresses 
 
 CheckAliveAddress string Address used for alive checks 
 
 DnsStr string DNS servers 
 
 DnsSearchStr string DNS search domains 
 
 Mtu int MTU (Maximum Transmission Unit) 
 
 FirewallMark uint32 Firewall mark (optional) 
 
 RoutingTable string Custom routing table (optional) 
 
 PreUp string Command before bringing up interface 
 
 PostUp string Command after bringing up interface 
 
 PreDown string Command before bringing down interface 
 
 PostDown string Command after bringing down interface 
  
 
Interface Payload (entity: interface)
 
  
 JSON Field Type Description 
   
 CreatedBy string Creator identifier 
 
 UpdatedBy string Last updater identifier 
 
 CreatedAt time.Time Creation timestamp 
 
 UpdatedAt time.Time Last update timestamp 
 
 Identifier string Unique identifier 
 
 PrivateKey string Private key for the interface 
 
 PublicKey string Public key for the interface 
 
 ListenPort int Listening port 
 
 Addresses []string IP addresses 
 
 DnsStr string DNS servers 
 
 DnsSearchStr string DNS search domains 
 
 Mtu int MTU (Maximum Transmission Unit) 
 
 FirewallMark uint32 Firewall mark 
 
 RoutingTable string Custom routing table 
 
 PreUp string Command before bringing up interface 
 
 PostUp string Command after bringing up interface 
 
 PreDown string Command before bringing down interface 
 
 PostDown string Command after bringing down interface 
 
 SaveConfig bool Whether to save config to file 
 
 DisplayName string Human-readable name 
 
 Type string Type of interface 
 
 DriverType string Driver used 
 
 Disabled *time.Time When the interface was disabled 
 
 DisabledReason string Reason for being disabled 
 
 PeerDefNetworkStr string Default peer network configuration 
 
 PeerDefDnsStr string Default peer DNS servers 
 
 PeerDefDnsSearchStr string Default peer DNS search domains 
 
 PeerDefEndpoint string Default peer endpoint 
 
 PeerDefAllowedIPsStr string Default peer allowed IPs 
 
 PeerDefMtu int Default peer MTU 
 
 PeerDefPersistentKeepalive int Default keepalive value 
 
 PeerDefFirewallMark uint32 Default firewall mark for peers 
 
 PeerDefRoutingTable string Default routing table for peers 
 
 PeerDefPreUp string Default peer pre-up command 
 
 PeerDefPostUp string Default peer post-up command 
 
 PeerDefPreDown string Default peer pre-down command 
 
 PeerDefPostDown string Default peer post-down command 
  
 
Peer Metrics Payload (entity: peer_metric)
 
  
 JSON Field Type Description 
   
 Status PeerStatus Current status of the peer 
 
 Peer Peer Peer data 
  
 
PeerStatus sub-structure:
 
  
 JSON Field Type Description 
   
 UpdatedAt time.Time Time of last status update 
 
 IsConnected bool Is peer currently connected 
 
 IsPingable bool Can peer be pinged 
 
 LastPing *time.Time Time of last successful ping 
 
 BytesReceived uint64 Bytes received from peer 
 
 BytesTransmitted uint64 Bytes sent to peer 
 
 Endpoint string Last known endpoint 
 
 LastHandshake *time.Time Last successful handshake 
 
 LastSessionStart *time.Time Time the last session began 
  
 
Example Payloads
 
The following payload is an example of a webhook event when a peer connects to the VPN:
 
{
   "event": "connect",
   "entity": "peer_metric",
   "identifier": "Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=",
diff --git a/master/index.html b/master/index.html
index 7df098f..dcbe8ce 100644
--- a/master/index.html
+++ b/master/index.html
@@ -345,4 +345,4 @@
 }
 
 
-  
 
 
 
 
A beautiful and simple UI to manage your WireGuard peers and interfaces
 
WireGuard Portal is an open source web-based user interface that makes it easy to setup and manage WireGuard VPN connections. It's built on top of WireGuard's official wgctrl library.
  Get started   
 
 
 
 
 
 
  
 Light Mode 
Light Mode
 
 
 Dark Mode 
Dark Mode
 
          
 
 
 
 
  
 
 
 
More information about WireGuard
 
 WireGuard® is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography. 
 
 WireGuard uses state-of-the-art cryptography and still manages to be as easy to configure and deploy as SSH. A combination of extremely high-speed cryptographic primitives and the fact that WireGuard lives inside the Linux kernel means that secure networking can be very high-speed. It is suitable for both small embedded devices like smartphones and fully loaded backbone routers. 
 
 
 
  
 
 
 
 
Explore official documentation
  
  
  
 
Official Website
 
 If you'd like a general conceptual overview of what WireGuard is about, read onward here. 
 
 
    
  
 
Protocol & Cryptography
 
 WireGuard uses state-of-the-art cryptography, like the Noise protocol framework, Curve25519, ChaCha20, Poly1305, BLAKE2, SipHash24, HKDF, and secure trusted constructions. 
 
 
    
  
 
Client Installation
 
 You may progress to installation and reading the quickstart instructions on how to use it. 
 
 
  
 
 
 
 
 
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
 
  
 
   
 
 
 
     
\ No newline at end of file
+  
 
 
 
 
A beautiful and simple UI to manage your WireGuard peers and interfaces
 
WireGuard Portal is an open source web-based user interface that makes it easy to setup and manage WireGuard VPN connections. It's built on top of WireGuard's official wgctrl library.
  Get started   
 
 
 
 
 
 
  
 Light Mode 
Light Mode
 
 
 Dark Mode 
Dark Mode
 
          
 
 
 
 
  
 
 
 
More information about WireGuard
 
 WireGuard® is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography. 
 
 WireGuard uses state-of-the-art cryptography and still manages to be as easy to configure and deploy as SSH. A combination of extremely high-speed cryptographic primitives and the fact that WireGuard lives inside the Linux kernel means that secure networking can be very high-speed. It is suitable for both small embedded devices like smartphones and fully loaded backbone routers. 
 
 
 
  
 
 
 
 
Explore official documentation
  
  
  
 
Official Website
 
 If you'd like a general conceptual overview of what WireGuard is about, read onward here. 
 
 
    
  
 
Protocol & Cryptography
 
 WireGuard uses state-of-the-art cryptography, like the Noise protocol framework, Curve25519, ChaCha20, Poly1305, BLAKE2, SipHash24, HKDF, and secure trusted constructions. 
 
 
    
  
 
Client Installation
 
 You may progress to installation and reading the quickstart instructions on how to use it. 
 
 
  
 
 
 
 
 
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
 
  
 
   
 
 
 
     
\ No newline at end of file
diff --git a/master/search/search_index.json b/master/search/search_index.json
index ce41346..72d510d 100644
--- a/master/search/search_index.json
+++ b/master/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"documentation/overview/","title":"Overview","text":"
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL, or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
"},{"location":"documentation/overview/#features","title":"Features","text":"
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI with dark-mode written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP), Passkey support
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Supports multiple WireGuard backends (wgctrl, MikroTik, or pfSense)
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface, or user updates
    •  
"},{"location":"documentation/configuration/examples/","title":"Examples","text":"
Below are some sample YAML configurations demonstrating how to override some default values.
"},{"location":"documentation/configuration/examples/#basic","title":"Basic","text":"
core:\n  admin_user: test@example.com\n  admin_password: password\n  admin_api_token: super-s3cr3t-api-token-or-a-UUID\n  import_existing: false\n  create_default_peer: true\n  self_provisioning_allowed: true\n\nbackend:\n  # default backend decides where new interfaces are created\n  default: mikrotik\n\n  # A prefix for resolvconf. Usually it is \"tun.\". If you are using systemd, the prefix should be empty.\n  local_resolvconf_prefix: \"tun.\"\n\n  mikrotik:\n    - id: mikrotik                   # unique id, not \"local\"\n      display_name: RouterOS RB5009  # optional nice name\n      api_url: https://10.10.10.10/rest\n      api_user: wgportal\n      api_password: a-super-secret-password\n      api_verify_tls: false        # set to false only if using self-signed during testing\n      api_timeout: 30s             # maximum request duration\n      concurrency: 5               # limit parallel REST calls to device\n      debug: false                 # verbose logging for this backend\n      ignored_interfaces:          # ignore these interfaces during import\n      - wgTest1\n      - wgTest2\n\nweb:\n  site_title: My WireGuard Server\n  site_company_name: My Company\n  listening_address: :8080\n  external_url: https://my.external-domain.com\n  csrf_secret: super-s3cr3t-csrf\n  session_secret: super-s3cr3t-session\n  request_logging: true\n\nadvanced:\n  log_level: trace\n  log_pretty: true\n  log_json: false\n  config_storage_path: /etc/wireguard\n  expiry_check_interval: 5m\n\ndatabase:\n  debug: true\n  type: sqlite\n  dsn: data/sqlite.db\n  encryption_passphrase: change-this-s3cr3t-encryption-passphrase\n\nauth:\n  webauthn:\n    enabled: true\n
"},{"location":"documentation/configuration/examples/#ldap-authentication-and-synchronization","title":"LDAP Authentication and Synchronization","text":"
# ... (basic configuration)\n\nauth:\n  ldap:\n    # a sample LDAP provider with user sync enabled\n    - provider_name: ldap\n      url: ldap://srv-ad1.company.local:389\n      bind_user: ldap_wireguard@company.local\n      bind_pass: super-s3cr3t-ldap\n      base_dn: DC=COMPANY,DC=LOCAL\n      login_filter: (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n      sync_interval: 15m\n      sync_filter: (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n      disable_missing: true\n      field_map:\n        user_identifier: sAMAccountName\n        email: mail\n        firstname: givenName\n        lastname: sn\n        phone: telephoneNumber\n        department: department\n        memberof: memberOf\n      admin_group: CN=WireGuardAdmins,OU=Some-OU,DC=COMPANY,DC=LOCAL\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/examples/#openid-connect-oidc-authentication","title":"OpenID Connect (OIDC) Authentication","text":"
# ... (basic configuration)\n\nauth:\n  oidc:\n    # A sample Entra ID provider with environment variable substitution.\n    # Only users with an @outlook.com email address are allowed to register or login.\n    - provider_name: azure\n      display_name: Login with</br>Entra ID\n      registration_enabled: true\n      base_url: \"https://login.microsoftonline.com/${AZURE_TENANT_ID}/v2.0\"\n      client_id: \"${AZURE_CLIENT_ID}\"\n      client_secret: \"${AZURE_CLIENT_SECRET}\"\n      allowed_domains:\n        - \"outlook.com\"\n      extra_scopes:\n        - profile\n        - email\n\n    # a sample provider where users with the attribute `wg_admin` set to `true` are considered as admins\n    - provider_name: google\n      display_name: Login with</br>Google\n      base_url: https://accounts.google.com\n      client_id: the-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        is_admin: wg_admin\n      admin_mapping:\n        admin_value_regex: ^true$\n      registration_enabled: true\n      log_user_info: true\n\n    # a sample provider where users in the group `the-admin-group` are considered as admins\n    - provider_name: google2\n      display_name: Login with</br>Google2\n      base_url: https://accounts.google.com\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        user_groups: groups\n      admin_mapping:\n        admin_group_regex: ^the-admin-group$\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/examples/#plain-oauth2-authentication","title":"Plain OAuth2 Authentication","text":"
# ... (basic configuration)\n\nauth:\n  oauth:\n    # a sample provider where users with the attribute `this-attribute-must-be-true` set to `true` or `True`\n    # are considered as admins\n    - provider_name: google3\n      display_name: Login with</br>Google3\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: name\n        is_admin: this-attribute-must-be-true\n      admin_mapping:\n        admin_value_regex: ^(True|true)$\n      registration_enabled: true\n\n    # a sample provider where either users with the attribute `this-attribute-must-be-true` set to `true` or \n    # users in the group `admin-group-name` are considered as admins\n    - provider_name: google4\n      display_name: Login with</br>Google4\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n        - i-want-some-groups\n      field_map:\n        email: email\n        firstname: name\n        user_identifier: sub\n        is_admin: this-attribute-must-be-true\n        user_groups: groups\n      admin_mapping:\n        admin_value_regex: ^true$\n        admin_group_regex: ^admin-group-name$\n      registration_enabled: true\n      log_user_info: true\n
 
For more information, check out the usage documentation (e.g. General Configuration or Backends Configuration).
"},{"location":"documentation/configuration/overview/","title":"Overview","text":"
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file when starting the Portal. The path of the configuration file defaults to config/config.yaml (or config/config.yml) in the working directory of the executable. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal. Also, environment variable substitution in the config file is supported. Refer to the syntax.
 
Configuration examples are available on the Examples page.
 Default configuration 
core:\n  admin_user: admin@wgportal.local\n  admin_password: wgportal-default\n  admin_api_token: \"\"\n  disable_admin_user: false\n  editable_keys: true\n  create_default_peer: false\n  create_default_peer_on_creation: false\n  re_enable_peer_after_user_enable: true\n  delete_peer_after_user_deleted: false\n  self_provisioning_allowed: false\n  import_existing: true\n  restore_state: true\n\nbackend:\n  default: local\n  local_resolvconf_prefix: tun.\n\nadvanced:\n  log_level: info\n  log_pretty: false\n  log_json: false\n  start_listen_port: 51820\n  start_cidr_v4: 10.11.12.0/24\n  start_cidr_v6: fdfd:d3ad:c0de:1234::0/64\n  use_ip_v6: true\n  config_storage_path: \"\"\n  expiry_check_interval: 15m\n  rule_prio_offset: 20000\n  route_table_offset: 20000\n  api_admin_only: true\n  limit_additional_user_peers: 0\n\ndatabase:\n  debug: false\n  slow_query_threshold: \"0\"\n  type: sqlite\n  dsn: data/sqlite.db\n  encryption_passphrase: \"\"\n\nstatistics:\n  use_ping_checks: true\n  ping_check_workers: 10\n  ping_unprivileged: false\n  ping_check_interval: 1m\n  data_collection_interval: 1m\n  collect_interface_data: true\n  collect_peer_data: true\n  collect_audit_data: true\n  listening_address: :8787\n\nmail:\n  host: 127.0.0.1\n  port: 25\n  encryption: none\n  cert_validation: true\n  username: \"\"\n  password: \"\"\n  auth_type: plain\n  from: Wireguard Portal <noreply@wireguard.local>\n  link_only: false\n  allow_peer_email: false\n  templates_path: \"\"\n\nauth:\n  oidc: []\n  oauth: []\n  ldap: []\n  webauthn:\n    enabled: true\n  min_password_length: 16\n  hide_login_form: false\n\nweb:\n  listening_address: :8888\n  external_url: http://localhost:8888\n  base_path: \"\"\n  site_company_name: WireGuard Portal\n  site_title: WireGuard Portal\n  session_identifier: wgPortalSession\n  session_secret: very_secret\n  csrf_secret: extremely_secret\n  request_logging: false\n  expose_host_info: false\n  cert_file: \"\"\n  key_File: \"\"\n  frontend_filepath: \"\"\n\nwebhook:\n  url: \"\"\n  authentication: \"\"\n  timeout: 10s\n
 
Below you will find sections like core, backend, advanced, database, statistics, mail, auth, web and webhook. Each section describes the individual configuration keys, their default values, and a brief explanation of their purpose.
"},{"location":"documentation/configuration/overview/#core","title":"Core","text":"
These are the primary configuration options that control fundamental WireGuard Portal behavior. More advanced options are found in the subsequent Advanced section.
"},{"location":"documentation/configuration/overview/#admin_user","title":"admin_user","text":"
     
  • Default: admin@wgportal.local
    •  
  • Environment Variable: WG_PORTAL_CORE_ADMIN_USER
    •  
  • Description: The administrator user. This user will be created as a default admin if it does not yet exist.
    •  
"},{"location":"documentation/configuration/overview/#admin_password","title":"admin_password","text":"
     
  • Default: wgportal-default
    •  
  • Environment Variable: WG_PORTAL_CORE_ADMIN_PASSWORD
    •  
  • Description: The administrator password. The default password should be changed immediately!
    •  
  • Important: The password should be strong and secure. The minimum password length is specified in auth.min_password_length. By default, it is 16 characters.
    •  
"},{"location":"documentation/configuration/overview/#disable_admin_user","title":"disable_admin_user","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_CORE_DISABLE_ADMIN_USER
    •  
  • Description: If true, no admin user is created. This is useful if you plan to manage users exclusively through external authentication providers such as LDAP or OAuth.
    •  
"},{"location":"documentation/configuration/overview/#admin_api_token","title":"admin_api_token","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_CORE_ADMIN_API_TOKEN
    •  
  • Description: An API token for the admin user. If a token is provided, the REST API can be accessed using this token. If empty, the API is initially disabled for the admin user.
    •  
"},{"location":"documentation/configuration/overview/#editable_keys","title":"editable_keys","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_CORE_EDITABLE_KEYS
    •  
  • Description: Allow editing of WireGuard key-pairs directly in the UI.
    •  
"},{"location":"documentation/configuration/overview/#create_default_peer","title":"create_default_peer","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_CORE_CREATE_DEFAULT_PEER
    •  
  • Description: If a user logs in for the first time with no existing peers, automatically create a new WireGuard peer for all server interfaces where the \"Create default peer\" flag is set.
    •  
  • Important: This option is only effective for interfaces where the \"Create default peer\" flag is set (via the UI).
    •  
"},{"location":"documentation/configuration/overview/#create_default_peer_on_creation","title":"create_default_peer_on_creation","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_CORE_CREATE_DEFAULT_PEER_ON_CREATION
    •  
  • Description: If an LDAP user is created (e.g., through LDAP sync) and has no peers, automatically create a new WireGuard peer for all server interfaces where the \"Create default peer\" flag is set.
    •  
  • Important: This option requires create_default_peer to be enabled.
    •  
"},{"location":"documentation/configuration/overview/#re_enable_peer_after_user_enable","title":"re_enable_peer_after_user_enable","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_CORE_RE_ENABLE_PEER_AFTER_USER_ENABLE
    •  
  • Description: Re-enable all peers that were previously disabled if the associated user is re-enabled.
    •  
"},{"location":"documentation/configuration/overview/#delete_peer_after_user_deleted","title":"delete_peer_after_user_deleted","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_CORE_DELETE_PEER_AFTER_USER_DELETED
    •  
  • Description: If a user is deleted, remove all linked peers. Otherwise, peers remain but are disabled.
    •  
"},{"location":"documentation/configuration/overview/#self_provisioning_allowed","title":"self_provisioning_allowed","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_CORE_SELF_PROVISIONING_ALLOWED
    •  
  • Description: Allow registered (non-admin) users to self-provision peers from their profile page.
    •  
"},{"location":"documentation/configuration/overview/#import_existing","title":"import_existing","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_CORE_IMPORT_EXISTING
    •  
  • Description: On startup, import existing WireGuard interfaces and peers into WireGuard Portal.
    •  
"},{"location":"documentation/configuration/overview/#restore_state","title":"restore_state","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_CORE_RESTORE_STATE
    •  
  • Description: Restore the WireGuard interface states (up/down) that existed before WireGuard Portal started.
    •  
"},{"location":"documentation/configuration/overview/#backend","title":"Backend","text":"
Configuration options for the WireGuard backend, which manages the WireGuard interfaces and peers. The current MikroTik backend is in BETA and may not support all features.
"},{"location":"documentation/configuration/overview/#default","title":"default","text":"
     
  • Default: local
    •  
  • Description: The default backend to use for managing WireGuard interfaces.    Valid options are: local, or other backend id's configured in the mikrotik section.
    •  
"},{"location":"documentation/configuration/overview/#local_resolvconf_prefix","title":"local_resolvconf_prefix","text":"
     
  • Default: tun.
    •  
  • Environment Variable: WG_PORTAL_BACKEND_LOCAL_RESOLVCONF_PREFIX
    •  
  • Description: Interface name prefix for WireGuard interfaces on the local system which is used to configure DNS servers with resolvconf.    It depends on the resolvconf implementation you are using, most use a prefix of tun., but some have an empty prefix (e.g., systemd).
    •  
"},{"location":"documentation/configuration/overview/#ignored_local_interfaces","title":"ignored_local_interfaces","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_BACKEND_IGNORED_LOCAL_INTERFACES   (comma-separated values)
    •  
  • Description: A list of interface names to exclude when enumerating local interfaces.   This is useful if you want to prevent certain interfaces from being imported from the local system.
    •  
"},{"location":"documentation/configuration/overview/#mikrotik","title":"Mikrotik","text":"
The mikrotik array contains a list of MikroTik backend definitions. Each entry describes how to connect to a MikroTik RouterOS instance that hosts WireGuard interfaces.
 
Below are the properties for each entry inside backend.mikrotik:
"},{"location":"documentation/configuration/overview/#id","title":"id","text":"
     
  • Default: (empty)
    •  
  • Description: A unique identifier for this backend.    This value can be referenced by backend.default to use this backend as default.   The identifier must be unique across all backends and must not use the reserved keyword local.
    •  
"},{"location":"documentation/configuration/overview/#display_name","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A human-friendly display name for this backend. If omitted, the id will be used as the display name.
    •  
"},{"location":"documentation/configuration/overview/#api_url","title":"api_url","text":"
     
  • Default: (empty)
    •  
  • Description: Base URL of the MikroTik REST API, including scheme and path, e.g., https://10.10.10.10:8729/rest.
    •  
"},{"location":"documentation/configuration/overview/#api_user","title":"api_user","text":"
     
  • Default: (empty)
    •  
  • Description: Username for authenticating against the MikroTik API.   Ensure that the user has sufficient permissions to manage WireGuard interfaces and peers.
    •  
"},{"location":"documentation/configuration/overview/#api_password","title":"api_password","text":"
     
  • Default: (empty)
    •  
  • Description: Password for the specified API user.
    •  
"},{"location":"documentation/configuration/overview/#api_verify_tls","title":"api_verify_tls","text":"
     
  • Default: false
    •  
  • Description: Whether to verify the TLS certificate of the MikroTik API endpoint. Set to false to allow self-signed certificates (not recommended for production).
    •  
"},{"location":"documentation/configuration/overview/#api_timeout","title":"api_timeout","text":"
     
  • Default: 30s
    •  
  • Description: Timeout for API requests to the MikroTik device. Uses Go duration format (e.g., 10s, 1m). If omitted, a default of 30 seconds is used.
    •  
"},{"location":"documentation/configuration/overview/#concurrency","title":"concurrency","text":"
     
  • Default: 5
    •  
  • Description: Maximum number of concurrent API requests the backend will issue when enumerating interfaces and their details. If 0 or negative, a sane default of 5 is used.
    •  
"},{"location":"documentation/configuration/overview/#ignored_interfaces","title":"ignored_interfaces","text":"
     
  • Default: (empty)
    •  
  • Description: A list of interface names to exclude during interface enumeration.   This is useful if you want to prevent specific interfaces from being imported from the MikroTik device.
    •  
"},{"location":"documentation/configuration/overview/#debug","title":"debug","text":"
     
  • Default: false
    •  
  • Description: Enable verbose debug logging for the MikroTik backend.
    •  
 
For more details on configuring the MikroTik backend, see the Backends documentation.
"},{"location":"documentation/configuration/overview/#advanced","title":"Advanced","text":"
Additional or more specialized configuration options for logging and interface creation details.
"},{"location":"documentation/configuration/overview/#log_level","title":"log_level","text":"
     
  • Default: info
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_LOG_LEVEL
    •  
  • Description: The log level used by the application. Valid options are: trace, debug, info, warn, error.
    •  
"},{"location":"documentation/configuration/overview/#log_pretty","title":"log_pretty","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_LOG_PRETTY
    •  
  • Description: If true, log messages are colorized and formatted for readability (pretty-print).
    •  
"},{"location":"documentation/configuration/overview/#log_json","title":"log_json","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_LOG_JSON
    •  
  • Description: If true, log messages are structured in JSON format.
    •  
"},{"location":"documentation/configuration/overview/#start_listen_port","title":"start_listen_port","text":"
     
  • Default: 51820
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_START_LISTEN_PORT
    •  
  • Description: The first port to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#start_cidr_v4","title":"start_cidr_v4","text":"
     
  • Default: 10.11.12.0/24
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_START_CIDR_V4
    •  
  • Description: The initial IPv4 subnet to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#start_cidr_v6","title":"start_cidr_v6","text":"
     
  • Default: fdfd:d3ad:c0de:1234::0/64
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_START_CIDR_V6
    •  
  • Description: The initial IPv6 subnet to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#use_ip_v6","title":"use_ip_v6","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_USE_IP_V6
    •  
  • Description: Enable or disable IPv6 support.
    •  
"},{"location":"documentation/configuration/overview/#config_storage_path","title":"config_storage_path","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_CONFIG_STORAGE_PATH
    •  
  • Description: Path to a directory where wg-quick style configuration files will be stored (if you need local filesystem configs).
    •  
"},{"location":"documentation/configuration/overview/#expiry_check_interval","title":"expiry_check_interval","text":"
     
  • Default: 15m
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_EXPIRY_CHECK_INTERVAL
    •  
  • Description: Interval after which existing peers are checked if they are expired. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#rule_prio_offset","title":"rule_prio_offset","text":"
     
  • Default: 20000
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_RULE_PRIO_OFFSET
    •  
  • Description: Offset for IP route rule priorities when configuring routing.
    •  
"},{"location":"documentation/configuration/overview/#route_table_offset","title":"route_table_offset","text":"
     
  • Default: 20000
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_ROUTE_TABLE_OFFSET
    •  
  • Description: Offset for IP route table IDs when configuring routing.
    •  
"},{"location":"documentation/configuration/overview/#api_admin_only","title":"api_admin_only","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_API_ADMIN_ONLY
    •  
  • Description: If true, the public REST API is accessible only to admin users. The API docs live at /api/v1/doc.html.
    •  
"},{"location":"documentation/configuration/overview/#limit_additional_user_peers","title":"limit_additional_user_peers","text":"
     
  • Default: 0
    •  
  • Environment Variable: WG_PORTAL_ADVANCED_LIMIT_ADDITIONAL_USER_PEERS
    •  
  • Description: Limit additional peers a normal user can create. 0 means unlimited.
    •  
"},{"location":"documentation/configuration/overview/#database","title":"Database","text":"
Configuration for the underlying database used by WireGuard Portal.  Supported databases include SQLite, MySQL, Microsoft SQL Server, and Postgres.
 
If sensitive values (like private keys) should be stored in an encrypted format, set the encryption_passphrase option.
"},{"location":"documentation/configuration/overview/#debug_1","title":"debug","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_DATABASE_DEBUG
    •  
  • Description: If true, logs all database statements (verbose).
    •  
"},{"location":"documentation/configuration/overview/#slow_query_threshold","title":"slow_query_threshold","text":"
     
  • Default: \"0\"
    •  
  • Environment Variable: WG_PORTAL_DATABASE_SLOW_QUERY_THRESHOLD
    •  
  • Description: A time threshold (e.g., 100ms) above which queries are considered slow and logged as warnings. If zero, slow query logging is disabled. Format uses s, ms for seconds, milliseconds, see time.ParseDuration. The value must be a string.
    •  
"},{"location":"documentation/configuration/overview/#type","title":"type","text":"
     
  • Default: sqlite
    •  
  • Environment Variable: WG_PORTAL_DATABASE_TYPE
    •  
  • Description: The database type. Valid options: sqlite, mssql, mysql, postgres.
    •  
"},{"location":"documentation/configuration/overview/#dsn","title":"dsn","text":"
     
  • Default: data/sqlite.db
    •  
  • Environment Variable: WG_PORTAL_DATABASE_DSN
    •  
  • Description: The Data Source Name (DSN) for connecting to the database.   For example:   
    user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local\n
    •  
"},{"location":"documentation/configuration/overview/#encryption_passphrase","title":"encryption_passphrase","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_DATABASE_ENCRYPTION_PASSPHRASE
    •  
  • Description: Passphrase for encrypting sensitive values such as private keys in the database. Encryption is only applied if this passphrase is set.   Important: Once you enable encryption by setting this passphrase, you cannot disable it or change it afterward.    New or updated records will be encrypted; existing data remains in plaintext until it\u2019s next modified.
    •  
"},{"location":"documentation/configuration/overview/#statistics","title":"Statistics","text":"
Controls how WireGuard Portal collects and reports usage statistics, including ping checks and Prometheus metrics.
"},{"location":"documentation/configuration/overview/#use_ping_checks","title":"use_ping_checks","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_USE_PING_CHECKS
    •  
  • Description: Enable periodic ping checks to verify that peers remain responsive.
    •  
"},{"location":"documentation/configuration/overview/#ping_check_workers","title":"ping_check_workers","text":"
     
  • Default: 10
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_PING_CHECK_WORKERS
    •  
  • Description: Number of parallel worker processes for ping checks.
    •  
"},{"location":"documentation/configuration/overview/#ping_unprivileged","title":"ping_unprivileged","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_PING_UNPRIVILEGED
    •  
  • Description: If false, ping checks run without root privileges. This is currently considered BETA.
    •  
"},{"location":"documentation/configuration/overview/#ping_check_interval","title":"ping_check_interval","text":"
     
  • Default: 1m
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_PING_CHECK_INTERVAL
    •  
  • Description: Interval between consecutive ping checks for all peers. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#data_collection_interval","title":"data_collection_interval","text":"
     
  • Default: 1m
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_DATA_COLLECTION_INTERVAL
    •  
  • Description: Interval between data collection cycles (bytes sent/received, handshake times, etc.). Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#collect_interface_data","title":"collect_interface_data","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_COLLECT_INTERFACE_DATA
    •  
  • Description: If true, collects interface-level data (bytes in/out) for monitoring and statistics.
    •  
"},{"location":"documentation/configuration/overview/#collect_peer_data","title":"collect_peer_data","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_COLLECT_PEER_DATA
    •  
  • Description: If true, collects peer-level data (bytes, last handshake, endpoint, etc.).
    •  
"},{"location":"documentation/configuration/overview/#collect_audit_data","title":"collect_audit_data","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_COLLECT_AUDIT_DATA
    •  
  • Description: If true, logs certain portal events (such as user logins) to the database.
    •  
"},{"location":"documentation/configuration/overview/#listening_address","title":"listening_address","text":"
     
  • Default: :8787
    •  
  • Environment Variable: WG_PORTAL_STATISTICS_LISTENING_ADDRESS
    •  
  • Description: Address and port for the integrated Prometheus metric server (e.g., :8787 or 127.0.0.1:8787).
    •  
"},{"location":"documentation/configuration/overview/#mail","title":"Mail","text":"
Options for configuring email notifications or sending peer configurations via email.  By default, emails will only be sent to peers that have a valid user record linked.  To send emails to all peers that have a valid email-address as user-identifier, set allow_peer_email to true.
"},{"location":"documentation/configuration/overview/#host","title":"host","text":"
     
  • Default: 127.0.0.1
    •  
  • Environment Variable: WG_PORTAL_MAIL_HOST
    •  
  • Description: Hostname or IP of the SMTP server.
    •  
"},{"location":"documentation/configuration/overview/#port","title":"port","text":"
     
  • Default: 25
    •  
  • Environment Variable: WG_PORTAL_MAIL_PORT
    •  
  • Description: Port number for the SMTP server.
    •  
"},{"location":"documentation/configuration/overview/#encryption","title":"encryption","text":"
     
  • Default: none
    •  
  • Environment Variable: WG_PORTAL_MAIL_ENCRYPTION
    •  
  • Description: SMTP encryption type. Valid values: none, tls, starttls.
    •  
"},{"location":"documentation/configuration/overview/#cert_validation","title":"cert_validation","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_MAIL_CERT_VALIDATION
    •  
  • Description: If true, validate the SMTP server certificate (relevant if encryption = tls).
    •  
"},{"location":"documentation/configuration/overview/#username","title":"username","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_MAIL_USERNAME
    •  
  • Description: Optional SMTP username for authentication.
    •  
"},{"location":"documentation/configuration/overview/#password","title":"password","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_MAIL_PASSWORD
    •  
  • Description: Optional SMTP password for authentication.
    •  
"},{"location":"documentation/configuration/overview/#auth_type","title":"auth_type","text":"
     
  • Default: plain
    •  
  • Environment Variable: WG_PORTAL_MAIL_AUTH_TYPE
    •  
  • Description: SMTP authentication type. Valid values: plain, login, crammd5.
    •  
"},{"location":"documentation/configuration/overview/#from","title":"from","text":"
     
  • Default: Wireguard Portal <noreply@wireguard.local>
    •  
  • Environment Variable: WG_PORTAL_MAIL_FROM
    •  
  • Description: The default \"From\" address when sending emails.
    •  
"},{"location":"documentation/configuration/overview/#link_only","title":"link_only","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_MAIL_LINK_ONLY
    •  
  • Description: If true, emails only contain a link to WireGuard Portal, rather than attaching the full configuration.
    •  
"},{"location":"documentation/configuration/overview/#allow_peer_email","title":"allow_peer_email","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_MAIL_ALLOW_PEER_EMAIL
    •  
  • Description: If true, and a peer has no valid user record linked, but the user-identifier of the peer is a valid email address, emails will be sent to that email address.   If false, and the peer has no valid user record linked, emails will not be sent.   If a peer has linked a valid user, the email address is always taken from the user record.
    •  
"},{"location":"documentation/configuration/overview/#templates_path","title":"templates_path","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_MAIL_TEMPLATES_PATH
    •  
  • Description: Path to the email template files that override embedded templates. Check usage documentation for an example.`
    •  
"},{"location":"documentation/configuration/overview/#auth","title":"Auth","text":"
WireGuard Portal supports multiple authentication strategies, including OpenID Connect (oidc), OAuth (oauth), Passkeys (webauthn) and LDAP (ldap). Each can have multiple providers configured. Below are the relevant keys.
 
Some core authentication options are shared across all providers, while others are specific to each provider type.
"},{"location":"documentation/configuration/overview/#min_password_length","title":"min_password_length","text":"
     
  • Default: 16
    •  
  • Environment Variable: WG_PORTAL_AUTH_MIN_PASSWORD_LENGTH
    •  
  • Description: Minimum password length for local authentication. This is not enforced for LDAP authentication.   The default admin password strength is also enforced by this setting.
    •  
  • Important: The password should be strong and secure. It is recommended to use a password with at least 16 characters, including uppercase and lowercase letters, numbers, and special characters.
    •  
"},{"location":"documentation/configuration/overview/#hide_login_form","title":"hide_login_form","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_AUTH_HIDE_LOGIN_FORM
    •  
  • Description: If true, the login form is hidden and only the OIDC, OAuth, LDAP, or WebAuthn providers are shown. This is useful if you want to enforce a specific authentication method.   If no social login providers are configured, the login form is always shown, regardless of this setting.
    •  
  • Important: You can still access the login form by adding the ?all query parameter to the login URL (e.g. https://wg.portal/#/login?all). 
    •  
"},{"location":"documentation/configuration/overview/#oidc","title":"OIDC","text":"
The oidc array contains a list of OpenID Connect providers.  Below are the properties for each OIDC provider entry inside auth.oidc:
"},{"location":"documentation/configuration/overview/#provider_name","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#display_name_1","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page (e.g., \"Login with Google\").
    •  
"},{"location":"documentation/configuration/overview/#base_url","title":"base_url","text":"
     
  • Default: (empty)
    •  
  • Description: The OIDC provider\u2019s base URL (e.g., https://accounts.google.com).
    •  
"},{"location":"documentation/configuration/overview/#client_id","title":"client_id","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID from the OIDC provider.
    •  
"},{"location":"documentation/configuration/overview/#client_secret","title":"client_secret","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret from the OIDC provider.
    •  
"},{"location":"documentation/configuration/overview/#extra_scopes","title":"extra_scopes","text":"
     
  • Default: (empty)
    •  
  • Description: A list of additional OIDC scopes (e.g., profile, email).
    •  
"},{"location":"documentation/configuration/overview/#allowed_domains","title":"allowed_domains","text":"
     
  • Default: (empty)
    •  
  • Description: A list of allowlisted domains. Only users with email addresses in these domains can log in or register. This is useful for restricting access to specific organizations or groups.
    •  
"},{"location":"documentation/configuration/overview/#field_map","title":"field_map","text":"
     
  • Default: (empty)
    •  
  • Description: Maps OIDC claims to WireGuard Portal user fields. 
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     Field Typical OIDC Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
    •  
"},{"location":"documentation/configuration/overview/#admin_mapping","title":"admin_mapping","text":"
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
       
    • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
      •  
    • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
      •  
     
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled","title":"registration_enabled","text":"
     
  • Default: false
    •  
  • Description: If true, a new user will be created in WireGuard Portal if not already present.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info","title":"log_user_info","text":"
     
  • Default: false
    •  
  • Description: If true, OIDC user data is logged at the trace level upon login (for debugging).
    •  
"},{"location":"documentation/configuration/overview/#log_sensitive_info","title":"log_sensitive_info","text":"
     
  • Default: false
    •  
  • Description: If true, sensitive OIDC user data, such as tokens and raw responses, will be logged at the trace level upon login (for debugging).
    •  
  • Important: Keep this setting disabled in production environments! Remove logs once you finished debugging authentication issues.
    •  
"},{"location":"documentation/configuration/overview/#oauth","title":"OAuth","text":"
The oauth array contains a list of plain OAuth2 providers. Below are the properties for each OAuth provider entry inside auth.oauth:
"},{"location":"documentation/configuration/overview/#provider_name_1","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#display_name_2","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page.
    •  
"},{"location":"documentation/configuration/overview/#client_id_1","title":"client_id","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID for the provider.
    •  
"},{"location":"documentation/configuration/overview/#client_secret_1","title":"client_secret","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret for the provider.
    •  
"},{"location":"documentation/configuration/overview/#auth_url","title":"auth_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the authentication endpoint.
    •  
"},{"location":"documentation/configuration/overview/#token_url","title":"token_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the token endpoint.
    •  
"},{"location":"documentation/configuration/overview/#user_info_url","title":"user_info_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the user information endpoint.
    •  
"},{"location":"documentation/configuration/overview/#scopes","title":"scopes","text":"
     
  • Default: (empty)
    •  
  • Description: A list of OAuth scopes.
    •  
"},{"location":"documentation/configuration/overview/#allowed_domains_1","title":"allowed_domains","text":"
     
  • Default: (empty)
    •  
  • Description: A list of allowlisted domains. Only users with email addresses in these domains can log in or register. This is useful for restricting access to specific organizations or groups.
    •  
"},{"location":"documentation/configuration/overview/#field_map_1","title":"field_map","text":"
     
  • Default: (empty)
    •  
  • Description: Maps OAuth attributes to WireGuard Portal fields.
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     Field Typical Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
    •  
"},{"location":"documentation/configuration/overview/#admin_mapping_1","title":"admin_mapping","text":"
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
    •  
  • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
    •  
  • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled_1","title":"registration_enabled","text":"
     
  • Default: false
    •  
  • Description: If true, new users are created automatically on successful login.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info_1","title":"log_user_info","text":"
     
  • Default: false
    •  
  • Description: If true, logs user info at the trace level upon login.
    •  
"},{"location":"documentation/configuration/overview/#log_sensitive_info_1","title":"log_sensitive_info","text":"
     
  • Default: false
    •  
  • Description: If true, sensitive OIDC user data, such as tokens and raw responses, will be logged at the trace level upon login (for debugging).
    •  
  • Important: Keep this setting disabled in production environments! Remove logs once you finished debugging authentication issues.
    •  
"},{"location":"documentation/configuration/overview/#ldap","title":"LDAP","text":"
The ldap array contains a list of LDAP authentication providers. Below are the properties for each LDAP provider entry inside auth.ldap:
"},{"location":"documentation/configuration/overview/#provider_name_2","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#url","title":"url","text":"
     
  • Default: (empty)
    •  
  • Description: The LDAP server URL (e.g., ldap://srv-ad01.company.local:389).
    •  
"},{"location":"documentation/configuration/overview/#start_tls","title":"start_tls","text":"
     
  • Default: false
    •  
  • Description: If true, use STARTTLS to secure the LDAP connection.
    •  
"},{"location":"documentation/configuration/overview/#cert_validation_1","title":"cert_validation","text":"
     
  • Default: false
    •  
  • Description: If true, validate the LDAP server\u2019s TLS certificate.
    •  
"},{"location":"documentation/configuration/overview/#tls_certificate_path","title":"tls_certificate_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to a TLS certificate if needed for LDAP connections.
    •  
"},{"location":"documentation/configuration/overview/#tls_key_path","title":"tls_key_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to the corresponding TLS certificate key.
    •  
"},{"location":"documentation/configuration/overview/#base_dn","title":"base_dn","text":"
     
  • Default: (empty)
    •  
  • Description: The base DN for user searches (e.g., DC=COMPANY,DC=LOCAL).
    •  
"},{"location":"documentation/configuration/overview/#bind_user","title":"bind_user","text":"
     
  • Default: (empty)
    •  
  • Description: The bind user for LDAP (e.g., company\\\\ldap_wireguard or ldap_wireguard@company.local).
    •  
"},{"location":"documentation/configuration/overview/#bind_pass","title":"bind_pass","text":"
     
  • Default: (empty)
    •  
  • Description: The bind password for LDAP authentication.
    •  
"},{"location":"documentation/configuration/overview/#field_map_2","title":"field_map","text":"
     
  • Default: (empty)
    •  
  •  
    Description: Maps LDAP attributes to WireGuard Portal fields.
     
       
    • Available fields: user_identifier, email, firstname, lastname, phone, department, memberof.
      •  
     WireGuard Portal Field Typical LDAP Attribute Short Description user_identifier sAMAccountName / uid Uniquely identifies the user within the LDAP directory. email mail / userPrincipalName Stores the user's primary email address. firstname givenName Contains the user's first (given) name. lastname sn Contains the user's last (surname) name. phone telephoneNumber / mobile Holds the user's phone or mobile number. department departmentNumber / ou Specifies the department or organizational unit of the user. memberof memberOf Lists the groups and roles to which the user belongs. 
    •  
"},{"location":"documentation/configuration/overview/#login_filter","title":"login_filter","text":"
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to restrict which users can log in. Use {{login_identifier}} to insert the username.   For example:   
    (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n
    •  
  • Important: The login_filter must always be a valid LDAP filter. It should at most return one user.    If the filter returns multiple or no users, the login will fail.
    •  
"},{"location":"documentation/configuration/overview/#admin_group","title":"admin_group","text":"
     
  • Default: (empty)
    •  
  • Description: A specific LDAP group whose members are considered administrators in WireGuard Portal.   For example:   
    CN=WireGuardAdmins,OU=Some-OU,DC=YOURDOMAIN,DC=LOCAL\n
    •  
"},{"location":"documentation/configuration/overview/#sync_interval","title":"sync_interval","text":"
     
  • Default: (empty)
    •  
  • Description: How frequently (in duration, e.g. 30m) to synchronize users from LDAP. Empty or 0 disables sync. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.   Only users that match the sync_filter are synchronized, if disable_missing is true, users not found in LDAP are disabled.
    •  
"},{"location":"documentation/configuration/overview/#sync_filter","title":"sync_filter","text":"
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to select which users get synchronized into WireGuard Portal.   For example:   
    (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n
    •  
"},{"location":"documentation/configuration/overview/#sync_log_user_info","title":"sync_log_user_info","text":"
     
  • Default: false
    •  
  • Description: If true, logs LDAP user data at the trace level during synchronization.
    •  
"},{"location":"documentation/configuration/overview/#disable_missing","title":"disable_missing","text":"
     
  • Default: false
    •  
  • Description: If true, any user not found in LDAP (during sync) is disabled in WireGuard Portal.
    •  
"},{"location":"documentation/configuration/overview/#auto_re_enable","title":"auto_re_enable","text":"
     
  • Default: false
    •  
  • Description: If true, users that where disabled because they were missing (see disable_missing) will be re-enabled once they are found again.
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled_2","title":"registration_enabled","text":"
     
  • Default: false
    •  
  • Description: If true, new user accounts are created in WireGuard Portal upon first login.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info_2","title":"log_user_info","text":"
     
  • Default: false
    •  
  • Description: If true, logs LDAP user data at the trace level upon login.
    •  
"},{"location":"documentation/configuration/overview/#webauthn-passkeys","title":"WebAuthn (Passkeys)","text":"
The webauthn section contains configuration options for WebAuthn authentication (passkeys).
"},{"location":"documentation/configuration/overview/#enabled","title":"enabled","text":"
     
  • Default: true
    •  
  • Environment Variable: WG_PORTAL_AUTH_WEBAUTHN_ENABLED
    •  
  • Description: If true, Passkey authentication is enabled. If false, WebAuthn is disabled.   Users are encouraged to use Passkeys for secure authentication instead of passwords.    If a passkey is registered, the password login is still available as a fallback. Ensure that the password is strong and secure.
    •  
"},{"location":"documentation/configuration/overview/#web","title":"Web","text":"
The web section contains configuration options for the web server, including the listening address, session management, and CSRF protection. It is important to specify a valid external_url for the web server, especially if you are using a reverse proxy.  Without a valid external_url, the login process may fail due to CSRF protection.
"},{"location":"documentation/configuration/overview/#listening_address_1","title":"listening_address","text":"
     
  • Default: :8888
    •  
  • Environment Variable: WG_PORTAL_WEB_LISTENING_ADDRESS
    •  
  • Description: The listening address and port for the web server (e.g., :8888 to bind on all interfaces or 127.0.0.1:8888 to bind only on the loopback interface).   Ensure that access to WireGuard Portal is protected against unauthorized access, especially if binding to all interfaces.
    •  
"},{"location":"documentation/configuration/overview/#external_url","title":"external_url","text":"
     
  • Default: http://localhost:8888
    •  
  • Environment Variable: WG_PORTAL_WEB_EXTERNAL_URL
    •  
  • Description: The URL where a client can access WireGuard Portal. This URL is used for generating links in emails and for performing OAUTH redirects.   The external URL must not contain a path component or trailing slash. If you want to serve WireGuard Portal on a subpath, use the base_path setting.   Important: If you are using a reverse proxy, set this to the external URL of the reverse proxy, otherwise login will fail. If you access the portal via IP address, set this to the IP address of the server.
    •  
"},{"location":"documentation/configuration/overview/#base_path","title":"base_path","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_WEB_BASE_PATH
    •  
  • Description: The base path for the web server (e.g., /wgportal).    By default (meaning an empty value), the portal will be served from the root path /.
    •  
"},{"location":"documentation/configuration/overview/#site_company_name","title":"site_company_name","text":"
     
  • Default: WireGuard Portal
    •  
  • Environment Variable: WG_PORTAL_WEB_SITE_COMPANY_NAME
    •  
  • Description: The company name that is shown at the bottom of the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#site_title","title":"site_title","text":"
     
  • Default: WireGuard Portal
    •  
  • Environment Variable: WG_PORTAL_WEB_SITE_TITLE
    •  
  • Description: The title that is shown in the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#session_identifier","title":"session_identifier","text":"
     
  • Default: wgPortalSession
    •  
  • Environment Variable: WG_PORTAL_WEB_SESSION_IDENTIFIER
    •  
  • Description: The session identifier for the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#session_secret","title":"session_secret","text":"
     
  • Default: very_secret
    •  
  • Environment Variable: WG_PORTAL_WEB_SESSION_SECRET
    •  
  • Description: The session secret for the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#csrf_secret","title":"csrf_secret","text":"
     
  • Default: extremely_secret
    •  
  • Environment Variable: WG_PORTAL_WEB_CSRF_SECRET
    •  
  • Description: The CSRF secret.
    •  
"},{"location":"documentation/configuration/overview/#request_logging","title":"request_logging","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_WEB_REQUEST_LOGGING
    •  
  • Description: Log all HTTP requests.
    •  
"},{"location":"documentation/configuration/overview/#expose_host_info","title":"expose_host_info","text":"
     
  • Default: false
    •  
  • Environment Variable: WG_PORTAL_WEB_EXPOSE_HOST_INFO
    •  
  • Description: Expose the hostname and version of the WireGuard Portal server in an HTTP header. This is useful for debugging but may expose sensitive information.
    •  
"},{"location":"documentation/configuration/overview/#cert_file","title":"cert_file","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_WEB_CERT_FILE
    •  
  • Description: (Optional) Path to the TLS certificate file.
    •  
"},{"location":"documentation/configuration/overview/#key_file","title":"key_file","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_WEB_KEY_FILE
    •  
  • Description: (Optional) Path to the TLS certificate key file.
    •  
"},{"location":"documentation/configuration/overview/#frontend_filepath","title":"frontend_filepath","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_WEB_FRONTEND_FILEPATH
    •  
  • Description: Optional base directory from which the web frontend is served. Check out the building documentation for more information on how to compile the frontend assets.
    •  
  • If the directory contains at least one file (recursively), these files are served at /app, overriding the embedded frontend assets.
    •  
  • If the directory is empty or does not exist on startup, the embedded frontend is copied into this directory automatically and then served.
    •  
  • If left empty, the embedded frontend is served and no files are written to disk.
    •  
"},{"location":"documentation/configuration/overview/#webhook","title":"Webhook","text":"
The webhook section allows you to configure a webhook that is called on certain events in WireGuard Portal. Further details can be found in the usage documentation.
"},{"location":"documentation/configuration/overview/#url_1","title":"url","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_WEBHOOK_URL
    •  
  • Description: The POST endpoint to which the webhook is sent. The URL must be reachable from the WireGuard Portal server. If the URL is empty, the webhook is disabled.
    •  
"},{"location":"documentation/configuration/overview/#authentication","title":"authentication","text":"
     
  • Default: (empty)
    •  
  • Environment Variable: WG_PORTAL_WEBHOOK_AUTHENTICATION
    •  
  • Description: The Authorization header for the webhook endpoint. The value is send as-is in the header. For example: Bearer <token>.
    •  
"},{"location":"documentation/configuration/overview/#timeout","title":"timeout","text":"
     
  • Default: 10s
    •  
  • Environment Variable: WG_PORTAL_WEBHOOK_TIMEOUT
    •  
  • Description: The timeout for the webhook request. If the request takes longer than this, it is aborted.
    •  
"},{"location":"documentation/getting-started/binaries/","title":"Binaries","text":"
Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
"},{"location":"documentation/getting-started/binaries/#download","title":"Download","text":"
Make sure that you download the correct binary for your architecture. The available binaries are:
 
     
  • wg-portal_linux_amd64 - Linux x86_64
    •  
  • wg-portal_linux_arm64 - Linux ARM 64-bit
    •  
  • wg-portal_linux_arm_v7 - Linux ARM 32-bit
    •  
"},{"location":"documentation/getting-started/binaries/#released-versions","title":"Released versions","text":"
To download a specific version, replace ${WG_PORTAL_VERSION} with the desired version (or set an environment variable).  All official release versions can be found on the GitHub Releases Page.
 
With curl:
 
curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 \n
 
With wget:
 
wget -O wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64\n
 
with gh cli:
 
gh release download ${WG_PORTAL_VERSION} --repo h44z/wg-portal --output wg-portal --pattern '*amd64'\n
 
The downloaded file will be named wg-portal and can be moved to a directory of your choice, see Install for more information.
"},{"location":"documentation/getting-started/binaries/#unreleased-versions-master-branch-builds","title":"Unreleased versions (master branch builds)","text":"
Unreleased versions can be fetched directly from the artifacts section of the GitHub Workflow.
"},{"location":"documentation/getting-started/binaries/#install","title":"Install","text":"
The following command can be used to install the downloaded binary (wg-portal) to /opt/wg-portal/wg-portal. It ensures that the binary is executable.
 
sudo mkdir -p /opt/wg-portal\nsudo install wg-portal /opt/wg-portal/\n
 
To handle tasks such as restarting the service or configuring automatic startup, it is recommended to use a process manager like systemd.  Refer to Systemd Service Setup for instructions.
"},{"location":"documentation/getting-started/binaries/#systemd-service-setup","title":"Systemd Service Setup","text":"
Note: To run WireGuard Portal as systemd service, you need to download the binary for your architecture beforehand.
 
The following examples assume that you downloaded the binary to /opt/wg-portal/wg-portal.  The configuration file is expected to be located at /opt/wg-portal/config.yml.
 
To run WireGuard Portal as a systemd service, you can create a service unit file. The easiest way to do this is by using systemctl edit:
 
sudo systemctl edit --force --full wg-portal.service\n
 
Paste the following content into the editor and adjust the variables to your needs:
 
[Unit]\nDescription=WireGuard Portal\nConditionPathExists=/opt/wg-portal/wg-portal\nAfter=network.target\n\n[Service]\nType=simple\nUser=root\nGroup=root\nAmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW\n\nRestart=on-failure\nRestartSec=10\n\nWorkingDirectory=/opt/wg-portal\nEnvironment=WG_PORTAL_CONFIG=/opt/wg-portal/config.yml\nExecStart=/opt/wg-portal/wg-portal\n\n[Install]\nWantedBy=multi-user.target\n
 
Alternatively, you can create or modify the file manually in /etc/systemd/system/wg-portal.service.  For systemd to pick up the changes, you need to reload the daemon:
 
sudo systemctl daemon-reload\n
 
After creating the service file, you can enable and start the service:
 
sudo systemctl enable --now wg-portal.service\n
 
To check status and log output, use: sudo systemctl status wg-portal.service or sudo journalctl -u wg-portal.service.
"},{"location":"documentation/getting-started/docker/","title":"Docker","text":""},{"location":"documentation/getting-started/docker/#image-usage","title":"Image Usage","text":"
The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
 
This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
 
The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
 
A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
 
---\nservices:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    # Use host network mode for WireGuard and the UI. Ensure that access to the UI is properly secured.\n    network_mode: \"host\"\n    volumes:\n      # left side is the host path, right side is the container path\n      - /etc/wireguard:/etc/wireguard\n      - ./data:/app/data\n      - ./config:/app/config\n
 
By default, the webserver for the UI is listening on port 8888 on all available interfaces.
 
Volumes for /app/data and /app/config should be used ensure data persistence across container restarts.
"},{"location":"documentation/getting-started/docker/#wireguard-interface-handling","title":"WireGuard Interface Handling","text":"
WireGuard Portal supports managing WireGuard interfaces through three distinct deployment methods, providing flexibility based on your system architecture and operational preferences:
 
     
  •  
    Directly on the host system:     WireGuard Portal can control WireGuard interfaces natively on the host, without using containers.     This setup is ideal for environments where direct access to system networking is preferred.    To use this method, you need to set the network mode to host in your docker-compose.yml file.    
    services:\n  wg-portal:\n    ...\n    network_mode: \"host\"\n    ...\n
     
     If host networking is used, the WireGuard Portal UI will be accessible on all the host's IP addresses if the listening address is set to :8888 in the configuration file.    To avoid this, you can bind the listening address to a specific IP address, for example, the loopback address (127.0.0.1:8888). It is also possible to deploy firewall rules to restrict access to the WireGuard Portal UI.
     
    •  
  •  
    Within the WireGuard Portal Docker container:     WireGuard interfaces can be managed directly from within the WireGuard Portal container itself.    This is the recommended approach when running WireGuard Portal via Docker, as it encapsulates all functionality in a single, portable container without requiring a separate WireGuard host or image.    
    services:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\" \n      # Web UI port\n      - \"8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      # host path : container path\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n
     
    •  
  •  
    Via a separate Docker container:     WireGuard Portal can interface with and control WireGuard running in another Docker container, such as the linuxserver/wireguard image.    This method is useful in setups that already use linuxserver/wireguard or where you want to isolate the VPN backend from the portal frontend.    For this, you need to set the network mode to service:wireguard in your docker-compose.yml file, wireguard is the service name of your WireGuard container.    
    services:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    network_mode: \"service:wireguard\" # So we ensure to stay on the same network as the wireguard container.\n    volumes:\n      # host path : container path\n      - ./wg/etc:/etc/wireguard\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n\n  wireguard:\n    image: lscr.io/linuxserver/wireguard:latest\n    container_name: wireguard\n    restart: unless-stopped\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      - \"51820:51820/udp\" # WireGuard port, needs to match the port in wg-portal interface config\n      - \"8888:8888/tcp\" # Noticed that the port of the web UI is exposed in the wireguard container.\n    volumes:\n      - ./wg/etc:/config/wg_confs # We share the configuration (wgx.conf) between wg-portal and wireguard\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n
        As the linuxserver/wireguard image uses wg-quick to manage the interfaces, you need to have at least the following configuration set for WireGuard Portal:    
    core:\n  # The WireGuard container uses wg-quick to manage the WireGuard interfaces - this conflicts with WireGuard Portal during startup.\n  # To avoid this, we need to set the restore_state option to false so that wg-quick can create the interfaces.\n  restore_state: false\n  # Usually, there are no existing interfaces in the WireGuard container, so we can set this to false.\n  import_existing: false\nadvanced:\n  # WireGuard Portal needs to export the WireGuard configuration as wg-quick config files so that the WireGuard container can use them.\n  config_storage_path: /etc/wireguard/\n
     
    •  
"},{"location":"documentation/getting-started/docker/#image-versioning","title":"Image Versioning","text":"
All images are hosted on Docker Hub at https://hub.docker.com/r/wgportal/wg-portal or in the GitHub Container Registry.
 
Version 2 is the current stable release. Version 1 has moved to legacy status and is no longer recommended.
 
There are three types of tags in the repository:
"},{"location":"documentation/getting-started/docker/#semantic-versioned-tags","title":"Semantic versioned tags","text":"
For example, 2.0.0-rc.1 or v2.0.0-rc.1.
 
These are official releases of WireGuard Portal. For production deployments of WireGuard Portal, we strongly recommend using one of these versioned tags instead of the latest or canary tags.
 
There are different types of these tags:
 
     
  • Major version tags: v2 or 2. These tags always refer to the latest image for WireGuard Portal version 2.
    •  
  • Minor version tags: v2.x or 2.0. These tags always refer to the latest image for WireGuard Portal version 2.x.
    •  
  • Specific version tags (patch version): v2.0.0 or 2.0.0. These tags denote a very specific release. They correspond to the GitHub tags that we make, and you can see the release notes for them here: https://github.com/h44z/wg-portal/releases. Once these tags for a specific version show up in the Docker repository, they will never change. 
    •  
"},{"location":"documentation/getting-started/docker/#the-latest-tag","title":"The latest tag","text":"
The lastest tag is the latest stable release of WireGuard Portal. For version 2, this is the same as the v2 tag.
"},{"location":"documentation/getting-started/docker/#the-master-tag","title":"The master tag","text":"
This is the most recent build to the main branch! It changes a lot and is very unstable.
 
We recommend that you don't use it except for development purposes or to test the latest features.
"},{"location":"documentation/getting-started/docker/#configuration","title":"Configuration","text":"
You can configure WireGuard Portal using a YAML configuration file. The filepath of the YAML configuration file defaults to /app/config/config.yaml. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG.
 
By default, WireGuard Portal uses an SQLite database. The database is stored in /app/data/sqlite.db.
 
You should mount those directories as a volume:
 
     
  • /app/data
    •  
  • /app/config
    •  
 
A detailed description of the configuration options can be found here.
 
If you want to access configuration files in wg-quick format, you can mount the /etc/wireguard directory inside the container to a location of your choice. Also enable the config_storage_path option in the configuration file: 
advanced:\n  config_storage_path: /etc/wireguard\n
"},{"location":"documentation/getting-started/helm/","title":"Helm","text":""},{"location":"documentation/getting-started/helm/#installing-the-chart","title":"Installing the Chart","text":"
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal\n
 
This command deploy wg-portal on the Kubernetes cluster in the default configuration. The Values section lists the parameters that can be configured during installation.
"},{"location":"documentation/getting-started/helm/#values","title":"Values","text":"Key Type Default Description nameOverride string \"\" Partially override resource names (adds suffix) fullnameOverride string \"\" Fully override resource names extraDeploy list [] Array of extra objects to deploy with the release config.advanced tpl/object {} Advanced configuration options. config.auth tpl/object {} Auth configuration options. config.core tpl/object {} Core configuration options. If external admins in auth are defined and there are no admin_user and admin_password defined here, the default admin account will be disabled. config.database tpl/object {} Database configuration options config.mail tpl/object {} Mail configuration options config.statistics tpl/object {} Statistics configuration options config.web tpl/object {} Web configuration options. listening_address will be set automatically from service.web.port. external_url is required to enable ingress and certificate resources. revisionHistoryLimit string 10 The number of old ReplicaSets to retain to allow rollback. workloadType string \"Deployment\" Workload type - Deployment or StatefulSet strategy object {\"type\":\"RollingUpdate\"} Update strategy for the workload Valid values are:  RollingUpdate or Recreate for Deployment,  RollingUpdate or OnDelete for StatefulSet image.repository string \"ghcr.io/h44z/wg-portal\" Image repository image.pullPolicy string \"IfNotPresent\" Image pull policy image.tag string \"\" Overrides the image tag whose default is the chart appVersion imagePullSecrets list [] Image pull secrets podAnnotations tpl/object {} Extra annotations to add to the pod podLabels object {} Extra labels to add to the pod podSecurityContext object {} Pod Security Context securityContext.capabilities.add list [\"NET_ADMIN\"] Add capabilities to the container initContainers tpl/list [] Pod init containers sidecarContainers tpl/list [] Pod sidecar containers dnsPolicy string \"ClusterFirst\" Set DNS policy for the pod. Valid values are ClusterFirstWithHostNet, ClusterFirst, Default or None. restartPolicy string \"Always\" Restart policy for all containers within the pod. Valid values are Always, OnFailure or Never. hostNetwork string false. Use the host's network namespace. resources object {} Resources requests and limits command list [] Overwrite pod command args list [] Additional pod arguments env tpl/list [] Additional environment variables envFrom tpl/list [] Additional environment variables from a secret or configMap livenessProbe object {} Liveness probe configuration readinessProbe object {} Readiness probe configuration startupProbe object {} Startup probe configuration volumes tpl/list [] Additional volumes volumeMounts tpl/list [] Additional volumeMounts nodeSelector object {\"kubernetes.io/os\":\"linux\"} Node Selector configuration tolerations list [] Tolerations configuration affinity object {} Affinity configuration service.mixed.enabled bool false Whether to create a single service for the web and wireguard interfaces service.mixed.type string \"LoadBalancer\" Service type service.web.annotations object {} Annotations for the web service service.web.type string \"ClusterIP\" Web service type service.web.port int 8888 Web service port Used for the web interface listener service.web.appProtocol string \"http\" Web service appProtocol. Will be auto set to https if certificate is enabled. service.wireguard.annotations object {} Annotations for the WireGuard service service.wireguard.type string \"LoadBalancer\" Wireguard service type service.wireguard.ports list [51820] Wireguard service ports. Exposes the WireGuard ports for created interfaces. Lowerest port is selected as start port for the first interface. Increment next port by 1 for each additional interface. service.metrics.port int 8787 ingress.enabled bool false Specifies whether an ingress resource should be created ingress.className string \"\" Ingress class name ingress.annotations object {} Ingress annotations ingress.tls bool false Ingress TLS configuration. Enable certificate resource or add ingress annotation to create required secret certificate.enabled bool false Specifies whether a certificate resource should be created. If enabled, certificate will be used for the web. certificate.issuer.name string \"\" Certificate issuer name certificate.issuer.kind string \"\" Certificate issuer kind (ClusterIssuer or Issuer) certificate.issuer.group string \"cert-manager.io\" Certificate issuer group certificate.duration string \"\" Optional. Documentation certificate.renewBefore string \"\" Optional. Documentation certificate.commonName string \"\" Optional. Documentation certificate.emailAddresses list [] Optional. Documentation certificate.ipAddresses list [] Optional. Documentation certificate.keystores object {} Optional. Documentation certificate.privateKey object {} Optional. Documentation certificate.secretTemplate object {} Optional. Documentation certificate.subject object {} Optional. Documentation certificate.uris list [] Optional. Documentation certificate.usages list [] Optional. Documentation persistence.enabled bool false Specifies whether an persistent volume should be created persistence.annotations object {} Persistent Volume Claim annotations persistence.storageClass string \"\" Persistent Volume storage class. If undefined (the default) cluster's default provisioner will be used. persistence.accessMode string \"ReadWriteOnce\" Persistent Volume Access Mode persistence.size string \"1Gi\" Persistent Volume size persistence.volumeName string \"\" Persistent Volume Name (optional) serviceAccount.create bool true Specifies whether a service account should be created serviceAccount.annotations object {} Service account annotations serviceAccount.automount bool false Automatically mount a ServiceAccount's API credentials serviceAccount.name string \"\" The name of the service account to use. If not set and create is true, a name is generated using the fullname template monitoring.enabled bool false Enable Prometheus monitoring. monitoring.apiVersion string \"monitoring.coreos.com/v1\" API version of the Prometheus resource. Use azmonitoring.coreos.com/v1 for Azure Managed Prometheus. monitoring.kind string \"PodMonitor\" Kind of the Prometheus resource. Could be PodMonitor or ServiceMonitor. monitoring.labels object {} Resource labels. monitoring.annotations object {} Resource annotations. monitoring.interval string 1m Interval at which metrics should be scraped. If not specified config.statistics.data_collection_interval interval is used. monitoring.metricRelabelings list [] Relabelings to samples before ingestion. monitoring.relabelings list [] Relabelings to samples before scraping. monitoring.scrapeTimeout string \"\" Timeout after which the scrape is ended If not specified, the Prometheus global scrape interval is used. monitoring.jobLabel string \"\" The label to use to retrieve the job name from. monitoring.podTargetLabels object {} Transfers labels on the Kubernetes Pod onto the target. monitoring.dashboard.enabled bool false Enable Grafana dashboard. monitoring.dashboard.annotations object {} Annotations for the dashboard ConfigMap. monitoring.dashboard.labels object {} Additional labels for the dashboard ConfigMap. monitoring.dashboard.namespace string \"\" Dashboard ConfigMap namespace Overrides the namespace for the dashboard ConfigMap."},{"location":"documentation/getting-started/reverse-proxy/","title":"Reverse Proxy (HTTPS)","text":""},{"location":"documentation/getting-started/reverse-proxy/#reverse-proxy-for-https","title":"Reverse Proxy for HTTPS","text":"
For production deployments, always serve the WireGuard Portal over HTTPS. You have two options to secure your connection:
"},{"location":"documentation/getting-started/reverse-proxy/#reverse-proxy","title":"Reverse Proxy","text":"
Let a front\u2010end proxy handle HTTPS for you. This also frees you from managing certificates manually and is therefore the preferred option. You can use Nginx, Traefik, Caddy or any other proxy. 
 
Below is an example using a Docker Compose stack with Traefik.  It exposes the WireGuard Portal on https://wg.domain.com and redirects initial HTTP traffic to HTTPS.
 
services:\n  reverse-proxy:\n    image: traefik:v3.3\n    restart: unless-stopped\n    command:\n      #- '--log.level=DEBUG'\n      - '--providers.docker.endpoint=unix:///var/run/docker.sock'\n      - '--providers.docker.exposedbydefault=false'\n      - '--entrypoints.web.address=:80'\n      - '--entrypoints.websecure.address=:443'\n      - '--entrypoints.websecure.http3'\n      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge=true'\n      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge.entrypoint=web'\n      - '--certificatesresolvers.letsencryptresolver.acme.email=your.email@domain.com'\n      - '--certificatesresolvers.letsencryptresolver.acme.storage=/letsencrypt/acme.json'\n      #- '--certificatesresolvers.letsencryptresolver.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory'  # just for testing\n    ports:\n      - 80:80 # for HTTP\n      - 443:443/tcp  # for HTTPS\n      - 443:443/udp  # for HTTP/3\n    volumes:\n      - acme-certs:/letsencrypt\n      - /var/run/docker.sock:/var/run/docker.sock:ro\n    labels:\n      - 'traefik.enable=true'\n      # HTTP Catchall for redirecting HTTP -> HTTPS\n      - 'traefik.http.routers.dashboard-catchall.rule=Host(`wg.domain.com`) && PathPrefix(`/`)'\n      - 'traefik.http.routers.dashboard-catchall.entrypoints=web'\n      - 'traefik.http.routers.dashboard-catchall.middlewares=redirect-to-https'\n      - 'traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https'\n\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\"\n      # Web UI port (only available on localhost, Traefik will handle the HTTPS)\n      - \"127.0.0.1:8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      # host path : container path\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n    labels:\n      - 'traefik.enable=true'\n      - 'traefik.http.routers.wgportal.rule=Host(`wg.domain.com`)'\n      - 'traefik.http.routers.wgportal.entrypoints=websecure'\n      - 'traefik.http.routers.wgportal.tls.certresolver=letsencryptresolver'\n      - 'traefik.http.routers.wgportal.service=wgportal'\n      - 'traefik.http.services.wgportal.loadbalancer.server.port=8888'\n\nvolumes:\n  acme-certs:\n
 
The WireGuard Portal configuration must be updated accordingly so that the correct external URL is set for the web interface:
 
web:\n  external_url: https://wg.domain.com\n
 
If you want to serve the web interface on a different base-path, you can also set the web.base_path option:
 
web:\n  external_url: https://wg.domain.com\n  base_path: /subpath\n
 
The WireGuard Portal will then be available at https://wg.domain.com/subpath.
"},{"location":"documentation/getting-started/reverse-proxy/#built-in-tls","title":"Built-in TLS","text":"
If you prefer to let WireGuard Portal handle TLS itself, you can use the built-in TLS support. In your config.yaml, under the web section, point to your certificate and key files:
 
web:\n  cert_file: /path/to/your/fullchain.pem\n  key_file:  /path/to/your/privkey.pem\n
 
The web server will then use these files to serve HTTPS traffic directly instead of HTTP.
"},{"location":"documentation/getting-started/sources/","title":"Sources","text":"
To build the application from source files, use the Makefile provided in the repository.
"},{"location":"documentation/getting-started/sources/#requirements","title":"Requirements","text":"
     
  • Git
    •  
  • Make
    •  
  • Go: >=1.24.0
    •  
  • Node.js with npm: node>=18, npm>=9
    •  
"},{"location":"documentation/getting-started/sources/#build","title":"Build","text":"
# Get source code\ngit clone https://github.com/h44z/wg-portal -b ${WG_PORTAL_VERSION:-master} --depth 1\ncd wg-portal\n# Build the frontend\nmake frontend\n# Build the backend\nmake build\n
"},{"location":"documentation/getting-started/sources/#install","title":"Install","text":"
Compiled binary will be available in ./dist directory. 
 
For installation instructions, check the Binaries section.
"},{"location":"documentation/monitoring/prometheus/","title":"Monitoring","text":"
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
"},{"location":"documentation/monitoring/prometheus/#exposed-metrics","title":"Exposed Metrics","text":"Metric Type Description wireguard_interface_received_bytes_total gauge Bytes received through the interface. wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. wireguard_peer_received_bytes_total gauge Bytes received from the peer. wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. wireguard_peer_up gauge Peer connection state (boolean: 1/0)."},{"location":"documentation/monitoring/prometheus/#prometheus-config","title":"Prometheus Config","text":"
Add the following scrape job to your Prometheus config file:
 
# prometheus.yaml\nscrape_configs:\n  - job_name: wg-portal\n    scrape_interval: 60s\n    static_configs:\n      - targets:\n          - localhost:8787 # Change localhost to IP Address or hostname with WG-Portal\n
"},{"location":"documentation/monitoring/prometheus/#grafana-dashboard","title":"Grafana Dashboard","text":"
You may import dashboard.json into your Grafana instance.
 
"},{"location":"documentation/rest-api/api-doc/","title":"REST API","text":""},{"location":"documentation/upgrade/v1/","title":"Upgrade","text":"
Major upgrades between different versions may require special procedures, which are described in the following sections.
"},{"location":"documentation/upgrade/v1/#upgrade-from-v1-to-v2","title":"Upgrade from v1 to v2","text":"
 Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yaml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db\n
 
You can also specify the database type using the parameter -migrateFromType.  Supported database types: mysql, mssql, postgres or sqlite.
 
For example:
 
./wg-portal-amd64 -migrateFromType=mysql -migrateFrom='user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local'\n
 
The upgrade will transform the old, existing database and store the values in the new database specified in the config.yaml configuration file. Ensure that the new database does not contain any data!
 
If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
 
services:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    # ... other settings\n    restart: no\n    command: [\"-migrateFrom=/app/data/old_wg_portal.db\"]\n
"},{"location":"documentation/usage/backends/","title":"Backends","text":"
WireGuard Portal can manage WireGuard interfaces and peers on different backends.  Each backend represents a system where interfaces actually live.  You can register multiple backends and choose which one to use per interface.  A global default backend determines where newly created interfaces go (unless you explicitly choose another in the UI).
 
Supported backends: - Local (default): Manages interfaces on the host running WireGuard Portal (Linux WireGuard via wgctrl). Use this when the portal should directly configure wg devices on the same server. - MikroTik RouterOS (beta): Manages interfaces and peers on MikroTik devices via the RouterOS REST API. Use this to control WG interfaces on RouterOS v7+. - pfSense (alpha): Manages interfaces and peers on pfSense firewalls via the pfSense REST API.
 
How backend selection works: - The default backend is configured at backend.default (local or the id of a defined MikroTik backend).    New interfaces created in the UI will use this backend by default. - Each interface stores its backend. You can select a different backend when creating a new interface.
"},{"location":"documentation/usage/backends/#configuring-mikrotik-backends-routeros-v7","title":"Configuring MikroTik backends (RouterOS v7+)","text":"
 The MikroTik backend is currently marked beta. While basic functionality is implemented, some advanced features are not yet implemented or contain bugs. Please test carefully before using in production.
 
The MikroTik backend uses the REST API under a base URL ending with /rest.  You can register one or more MikroTik devices as backends for a single WireGuard Portal instance.
"},{"location":"documentation/usage/backends/#prerequisites-on-mikrotik","title":"Prerequisites on MikroTik:","text":"
     
  • RouterOS v7 with WireGuard support.
    •  
  • REST API enabled and reachable over HTTP(S). A typical base URL is https://:8729/rest or https:///rest depending on your service setup. 
  • A dedicated RouterOS user with the following group permissions:
    •  
  • api (for logging in via REST API)
    •  
  • rest-api (for logging in via REST API)
    •  
  • read (to read interface and peer data)
    •  
  • write (to create/update interfaces and peers)
    •  
  • test (to perform ping checks)
    •  
  • sensitive (to read private keys)
    •  
  • TLS certificate on the device is recommended. If you use a self-signed certificate during testing, set api_verify_tls: false in wg-portal (not recommended for production).
    •  
    Example WireGuard Portal configuration (config/config.yaml):
     
    backend:\n  # default backend decides where new interfaces are created\n  default: mikrotik-prod\n\n  mikrotik:\n    - id: mikrotik-prod              # unique id, not \"local\"\n      display_name: RouterOS RB5009  # optional nice name\n      api_url: https://10.10.10.10/rest\n      api_user: wgportal\n      api_password: a-super-secret-password\n      api_verify_tls: true         # set to false only if using self-signed during testing\n      api_timeout: 30s             # maximum request duration\n      concurrency: 5               # limit parallel REST calls to device\n      debug: false                 # verbose logging for this backend\n
    "},{"location":"documentation/usage/backends/#known-limitations","title":"Known limitations:","text":"
       
    • The MikroTik backend is still in beta. Some features may not work as expected.
      •  
    • Not all WireGuard Portal features are supported yet (e.g., no support for interface hooks)
      •  
    "},{"location":"documentation/usage/backends/#configuring-pfsense-backends","title":"Configuring pfSense backends","text":"
     The pfSense backend is currently alpha. Only basic interface and peer CRUD are supported. Traffic statistics (rx/tx, last handshake) are not exposed by the pfSense REST API and will show as empty.
     
    The pfSense backend talks to the pfSense REST API (pfSense Plus / CE with the REST API package installed). Point the backend at the appliance hostname without appending /api/v2 \u2014 the portal appends /api/v2 automatically.
    "},{"location":"documentation/usage/backends/#prerequisites-on-pfsense","title":"Prerequisites on pfSense:","text":"
       
    • pfSense with the REST API package enabled (System -> API) and WireGuard configured.
      •  
    • An API key with permissions for WireGuard endpoints. If you use a read-only key, set core.restore_state: false in config.yml to avoid write attempts at startup.
      •  
    • HTTPS recommended; set api_verify_tls: false only for lab/self-signed setups.
      •  
     
    Example WireGuard Portal configuration:
     
    backend:\n  # default backend decides where new interfaces are created\n  default: pfsense1\n\n  pfsense:\n    - id: pfsense1                 # unique id, not \"local\"\n      display_name: Main pfSense   # optional nice name\n      api_url: https://pfsense.example.com  # no trailing /api/v2\n      api_key: your-api-key\n      api_verify_tls: true\n      api_timeout: 30s\n      concurrency: 5\n      debug: false\n
    "},{"location":"documentation/usage/backends/#known-limitations_1","title":"Known limitations:","text":"
       
    • Alpha quality: behavior and API coverage may change.
      •  
    • Statistics (rx/tx bytes, last handshake) are not available from the pfSense REST API today.
      •  
    "},{"location":"documentation/usage/general/","title":"General","text":"
    This documentation section describes the general usage of WireGuard Portal.  If you are looking for specific setup instructions, please refer to the Getting Started and Configuration sections,  for example, using a Docker deployment.
    "},{"location":"documentation/usage/general/#basic-concepts","title":"Basic Concepts","text":"
    WireGuard Portal is a web-based configuration portal for WireGuard server management. It allows managing multiple WireGuard interfaces and users from a single web UI. WireGuard Interfaces can be categorized into three types:
     
       
    • Server: A WireGuard server interface that to which multiple peers can connect. In this mode, it is possible to specify default settings for all peers, such as the IP address range, DNS servers, and MTU size.
      •  
    • Client: A WireGuard client interface that can be used to connect to a WireGuard server. Usually, such an interface has exactly one peer.
      •  
    • Unknown: This is the default type for imported interfaces. It is encouraged to change the type to either Server or Client after importing the interface. 
      •  
    "},{"location":"documentation/usage/general/#accessing-the-web-ui","title":"Accessing the Web UI","text":"
    The web UI should be accessed via the URL specified in the external_url property of the configuration file. By default, WireGuard Portal listens on port 8888 for HTTP connections. Check the Security section for more information on securing the web UI.
     
    So the default URL to access the web UI is:
     
    http://localhost:8888\n
     
    A freshly set-up WireGuard Portal instance will have a default admin user with the username admin@wgportal.local and the password wgportal-default.  You can and should override the default credentials in the configuration file. Make sure to change the default password immediately after the first login!
    "},{"location":"documentation/usage/general/#basic-ui-description","title":"Basic UI Description","text":"
    As seen in the screenshot above, the web UI is divided into several sections which are accessible via the navigation bar on the top of the screen.
     
       
    1. Home: The landing page of WireGuard Portal. It provides a staring point for the user to access the different sections of the web UI. It also provides quick links to WireGuard Client downloads or official documentation.
      2.  
    2. Interfaces: This section allows you to manage the WireGuard interfaces. You can add, edit, or delete interfaces, as well as view their status and statistics. Peers for each interface can be managed here as well.
      3.  
    3. Users: This section allows you to manage the users of WireGuard Portal. You can add, edit, or delete users, as well as view their status and statistics.
      4.  
    4. Key Generator: This section allows you to generate WireGuard keys locally on your browser. The generated keys are never sent to the server. This is useful if you want to generate keys for a new peer without having to store the private keys in the database.
      5.  
    5. Profile / Settings: This section allows you to access your own profile page, settings, and audit logs. 
      6.  
    "},{"location":"documentation/usage/general/#interface-view","title":"Interface View","text":"
    The interface view provides an overview of the WireGuard interfaces and peers configured in WireGuard Portal.
     
    The most important elements are:
     
       
    1. Interface Selector: This dropdown allows you to select the WireGuard interface you want to manage.     All further actions will be performed on the selected interface.
      2.  
    2. Create new Interface: This button allows you to create a new WireGuard interface.
      3.  
    3. Interface Overview: This section provides an overview of the selected WireGuard interface. It shows the interface type, number of peers, and other important information.
      4.  
    4. List of Peers: This section provides a list of all peers associated with the selected WireGuard interface. You can view, add, edit, or delete peers from this list.
      5.  
    5. Add new Peer: This button allows you to add a new peer to the selected WireGuard interface.
      6.  
    6. Add multiple Peers: This button allows you to add multiple peers to the selected WireGuard interface.     This is useful if you want to add a large number of peers at once.
      7.  
    "},{"location":"documentation/usage/ldap/","title":"LDAP","text":"
    WireGuard Portal lets you hook up any LDAP server such as Active Directory or OpenLDAP for both authentication and user sync.  You can even register multiple LDAP servers side-by-side. When someone logs in via LDAP, their specific provider is remembered,  so there's no risk of cross-provider conflicts. Details on the log-in process can be found in the Security documentation.
     
    If you enable LDAP synchronization, all users within the LDAP directory will be created automatically in the WireGuard Portal database if they do not exist. If a user is disabled or deleted in LDAP, the user will be disabled in WireGuard Portal as well.  The synchronization process can be fine-tuned by multiple parameters, which are described below.
    "},{"location":"documentation/usage/ldap/#ldap-synchronization","title":"LDAP Synchronization","text":"
    WireGuard Portal can automatically synchronize users from LDAP to the database.  To enable this feature, set the sync_interval property in the LDAP provider configuration to a value greater than \"0\". The value is a string representing a duration, such as \"15m\" for 15 minutes or \"1h\" for 1 hour (check the exact format definition for details). The synchronization process will run in the background and synchronize users from LDAP to the database at the specified interval. Also make sure that the sync_filter property is a well-formed LDAP filter, or synchronization will fail.
    "},{"location":"documentation/usage/ldap/#limiting-synchronization-to-specific-users","title":"Limiting Synchronization to Specific Users","text":"
    Use the sync_filter property in your LDAP provider block to restrict which users get synchronized.  It accepts any valid LDAP search filter, only entries matching that filter will be pulled into the portal's database. 
     
    For example, to import only users with a mail attribute: 
    auth:\n  ldap:\n    - id: ldap\n      # ... other settings\n      sync_filter: (mail=*)\n
    "},{"location":"documentation/usage/ldap/#disable-missing-users","title":"Disable Missing Users","text":"
    If you set the disable_missing property to true, any user that is not found in LDAP during synchronization will be disabled in WireGuard Portal. All peers associated with that user will also be disabled.
     
    If you want a user and its peers to be automatically re-enabled once they are found in LDAP again, set the auto_re_enable property to true. This will only re-enable the user if they where disabled by the synchronization process. Manually disabled users will not be re-enabled.
    "},{"location":"documentation/usage/mail-templates/","title":"Mail Templates","text":"
    WireGuard Portal sends emails when you share a configuration with a user.  By default, the application uses embedded templates. You can fully customize these emails by pointing the Portal  to a folder containing your own templates. If the folder is empty on startup, the default embedded templates  are written there to get you started.
    "},{"location":"documentation/usage/mail-templates/#configuration","title":"Configuration","text":"
    To enable custom templates, set the mail.templates_path option in the application configuration file  or the WG_PORTAL_MAIL_TEMPLATES_PATH environment variable to a valid folder path.
     
    For example:
     
    mail:\n  # ... other mail options ...\n  # Path where custom email templates (.gotpl and .gohtml) are stored.\n  # If the directory is empty on startup, the default embedded templates\n  # will be written there so you can modify them.\n  # Leave empty to use embedded templates only.\n  templates_path: \"/opt/wg-portal/mail-templates\"\n
    "},{"location":"documentation/usage/mail-templates/#template-files-and-names","title":"Template files and names","text":"
    The system expects the following template names. Place files with these names in your templates_path to override the defaults. You do not need to override all templates, only the ones you want to customize should be present.
     
       
    • Text templates (.gotpl):
      •  
    • mail_with_link.gotpl
      •  
    • mail_with_attachment.gotpl
      •  
    • HTML templates (.gohtml):
      •  
    • mail_with_link.gohtml
      •  
    • mail_with_attachment.gohtml
      •  
     
    Both text and HTML templates are standard Go  templates and receive the following data fields, depending on the email type:
     
       
    • Common fields:
      •  
    • PortalUrl (string) - external URL of the Portal
      •  
    • PortalName (string) - site title/company name
      •  
    • User (*domain.User) - the recipient user (may be partially populated when sending to a peer email)
      •  
    • Link email (mail_with_link.*):
      •  
    • Link (string) - the download link
      •  
    • Attachment email (mail_with_attachment.*):
      •  
    • ConfigFileName (string) - filename of the attached WireGuard config
      •  
    • QrcodePngName (string) - CID content-id of the embedded QR code image
      •  
     
    Tip: You can inspect the embedded templates in the repository under internal/app/mail/tpl_files/ for reference.  When the directory at templates_path is empty, these files are copied to your folder so you can edit them in place.
    "},{"location":"documentation/usage/security/","title":"Security","text":"
    This section describes the security features available to administrators for hardening WireGuard Portal and protecting its data.
    "},{"location":"documentation/usage/security/#authentication","title":"Authentication","text":"
    WireGuard Portal supports multiple authentication methods, including:
     
       
    • Local user accounts
      •  
    • LDAP authentication
      •  
    • OAuth and OIDC authentication
      •  
    • Passkey authentication (WebAuthn)
      •  
     
    Users can have two roles which limit their permissions in WireGuard Portal:
     
       
    • User: Can manage their own account and peers.
      •  
    • Admin: Can manage all users and peers, including the ability to manage WireGuard interfaces.
      •  
    "},{"location":"documentation/usage/security/#password-security","title":"Password Security","text":"
    WireGuard Portal supports username and password authentication for both local and LDAP-backed accounts. Local users are stored in the database, while LDAP users are authenticated against an external LDAP server.
     
    On initial startup, WireGuard Portal automatically creates a local admin account with the password wgportal-default.
     
     This password must be changed immediately after the first login.
     
    The minimum password length for all local users can be configured in the auth  section of the configuration file. The default value is 16 characters, see min_password_length. The minimum password length is also enforced for the default admin user.
    "},{"location":"documentation/usage/security/#passkey-webauthn-authentication","title":"Passkey (WebAuthn) Authentication","text":"
    Besides the standard authentication mechanisms, WireGuard Portal supports Passkey authentication. This feature is enabled by default and can be configured in the webauthn section of the configuration file.
     
    Users can register multiple Passkeys to their account. These Passkeys can be used to log in to the web UI as long as the user is not locked.
     
     Passkey authentication does not disable password authentication. The password can still be used to log in (e.g., as a fallback).
     
    To register a Passkey, open the settings page (1) in the web UI and click on the \"Register Passkey\" (2) button.
     
    "},{"location":"documentation/usage/security/#oauth-and-oidc-authentication","title":"OAuth and OIDC Authentication","text":"
    WireGuard Portal supports OAuth and OIDC authentication. You can use any OAuth or OIDC provider that supports the authorization code flow,  such as Google, GitHub, or Keycloak.
     
    For OAuth or OIDC to work, you need to configure the external_url property in the web section of the configuration file. If you are planning to expose the portal to the internet, make sure that the external_url is configured to use HTTPS.
     
    To add OIDC or OAuth authentication to WireGuard Portal, create a Client-ID and Client-Secret in your OAuth provider and  configure a new authentication provider in the auth section of the configuration file. Make sure that each configured provider has a unique provider_name property set. Samples can be seen here.
    "},{"location":"documentation/usage/security/#limiting-login-to-specific-domains","title":"Limiting Login to Specific Domains","text":"
    You can limit the login to specific domains by setting the allowed_domains property for OAuth or OIDC providers. This property is a comma-separated list of domains that are allowed to log in. The user's email address is checked against this list. For example, if you want to allow only users with an email address ending in outlook.com to log in, set the property as follows:
     
    auth:\n  oidc:\n    - provider_name: \"oidc1\"\n      # ... other settings\n      allowed_domains:\n        - \"outlook.com\"\n
    "},{"location":"documentation/usage/security/#limit-login-to-existing-users","title":"Limit Login to Existing Users","text":"
    You can limit the login to existing users only by setting the registration_enabled property to false for OAuth or OIDC providers. If registration is enabled, new users will be created in the database when they log in for the first time.
    "},{"location":"documentation/usage/security/#admin-mapping","title":"Admin Mapping","text":"
    You can map users to admin roles based on their attributes in the OAuth or OIDC provider. To do this, set the admin_mapping property for the provider. Administrative access can either be mapped by a specific attribute or by group membership.
     
    Attribute specific mapping can be achieved by setting the admin_value_regex and the is_admin property. The admin_value_regex property is a regular expression that is matched against the value of the is_admin attribute. The user is granted admin access if the regex matches the attribute value.
     
    Example: 
    auth:\n  oidc:\n    - provider_name: \"oidc1\"\n      # ... other settings\n      field_map:\n        is_admin: \"wg_admin_prop\"\n      admin_mapping:\n        admin_value_regex: \"^true$\"\n
     The example above will grant admin access to users with the wg_admin_prop attribute set to true.
     
    Group membership mapping can be achieved by setting the admin_group_regex and user_groups property. The admin_group_regex property is a regular expression that is matched against the group names of the user. The user is granted admin access if the regex matches any of the group names.
     
    Example: 
    auth:\n  oidc:\n    - provider_name: \"oidc1\"\n      # ... other settings\n      field_map:\n        user_groups: \"groups\"\n      admin_mapping:\n        admin_group_regex: \"^the-admin-group$\"\n
     The example above will grant admin access to users who are members of the the-admin-group group.
    "},{"location":"documentation/usage/security/#ldap-authentication","title":"LDAP Authentication","text":"
    WireGuard Portal supports LDAP authentication. You can use any LDAP server that supports the LDAP protocol, such as Active Directory or OpenLDAP. Multiple LDAP servers can be configured in the auth section of the configuration file.  WireGuard Portal remembers the authentication provider of the user and therefore avoids conflicts between multiple LDAP providers.
     
    To configure LDAP authentication, create a new ldap authentication provider in the auth section of the configuration file.
    "},{"location":"documentation/usage/security/#limiting-login-to-specific-users","title":"Limiting Login to Specific Users","text":"
    You can limit the login to specific users by setting the login_filter property for LDAP provider. This filter uses the LDAP search filter syntax. The username can be inserted into the query by placing the {{login_identifier}} placeholder in the filter. This placeholder will then be replaced with the username entered by the user during login.
     
    For example, if you want to allow only users with the objectClass attribute set to organizationalPerson to log in, set the property as follows:
     
    auth:\n  ldap:\n    - provider_name: \"ldap1\"\n      # ... other settings\n      login_filter: \"(&(objectClass=organizationalPerson)(uid={{login_identifier}}))\"\n
     
    The login_filter should always be designed to return at most one user.
    "},{"location":"documentation/usage/security/#limit-login-to-existing-users_1","title":"Limit Login to Existing Users","text":"
    You can limit the login to existing users only by setting the registration_enabled property to false for LDAP providers. If registration is enabled, new users will be created in the database when they log in for the first time.
    "},{"location":"documentation/usage/security/#admin-mapping_1","title":"Admin Mapping","text":"
    You can map users to admin roles based on their group membership in the LDAP server. To do this, set the admin_group and memberof property for the provider. The admin_group property defines the distinguished name of the group that is allowed to log in as admin.  All groups that are listed in the memberof attribute of the user will be checked against this group. If one of the groups matches, the user is granted admin access.
    "},{"location":"documentation/usage/security/#ui-and-api-access","title":"UI and API Access","text":"
    WireGuard Portal provides a web UI and a REST API for user interaction. It is important to secure these interfaces to prevent unauthorized access and data breaches.
    "},{"location":"documentation/usage/security/#https","title":"HTTPS","text":"
    It is recommended to use HTTPS for all communication with the portal to prevent eavesdropping. 
     
    Event though, WireGuard Portal supports HTTPS out of the box, it is recommended to use a reverse proxy like Nginx or Traefik to handle SSL termination and other security features. A detailed explanation is available in the Reverse Proxy section.
    "},{"location":"documentation/usage/webhooks/","title":"Webhooks","text":"
    Webhooks allow WireGuard Portal to notify external services about events such as user creation, device changes, or configuration updates. This enables integration with other systems and automation workflows.
     
    When webhooks are configured and a specified event occurs, WireGuard Portal sends an HTTP POST request to the configured webhook URL.  The payload contains event-specific data in JSON format.
    "},{"location":"documentation/usage/webhooks/#configuration","title":"Configuration","text":"
    All available configuration options for webhooks can be found in the configuration overview.
     
    A basic webhook configuration looks like this:
     
    webhook:\n  url: https://your-service.example.com/webhook\n
    "},{"location":"documentation/usage/webhooks/#security","title":"Security","text":"
    Webhooks can be secured by using a shared secret. This secret is included in the Authorization header of the webhook request, allowing your service to verify the authenticity of the request. You can set the shared secret in the webhook configuration:
     
    webhook:\n  url: https://your-service.example.com/webhook\n  secret: \"Basic dXNlcm5hbWU6cGFzc3dvcmQ=\"\n
     
    You should also make sure that your webhook endpoint is secured with HTTPS to prevent eavesdropping and tampering.
    "},{"location":"documentation/usage/webhooks/#available-events","title":"Available Events","text":"
    WireGuard Portal supports various events that can trigger webhooks. The following events are available:
     
       
    • create: Triggered when a new entity is created.
      •  
    • update: Triggered when an existing entity is updated.
      •  
    • delete: Triggered when an entity is deleted.
      •  
    • connect: Triggered when a user connects to the VPN.
      •  
    • disconnect: Triggered when a user disconnects from the VPN.
      •  
     
    The following entity models are supported for webhook events:
     
       
    • user: WireGuard Portal users support creation, update, or deletion events.
      •  
    • peer: Peers support creation, update, or deletion events. Via the peer_metric entity, you can also receive connection status updates.
      •  
    • peer_metric: Peer metrics support connection status updates, such as when a peer connects or disconnects.
      •  
    • interface: WireGuard interfaces support creation, update, or deletion events.
      •  
    "},{"location":"documentation/usage/webhooks/#payload-structure","title":"Payload Structure","text":"
    All webhook events send a JSON payload containing relevant data. The structure of the payload depends on the event type and entity involved. A common shell structure for webhook payloads is as follows:
     
    {\n  \"event\": \"create\", // The event type, e.g. \"create\", \"update\", \"delete\", \"connect\", \"disconnect\"\n  \"entity\": \"user\",  // The entity type, e.g. \"user\", \"peer\", \"peer_metric\", \"interface\"\n  \"identifier\": \"the-user-identifier\", // Unique identifier of the entity, e.g. user ID or peer ID\n  \"payload\": {\n    // The payload of the event, e.g. a Peer model.\n    // Detailed model descriptions are provided below.\n  }\n}\n
    "},{"location":"documentation/usage/webhooks/#payload-models","title":"Payload Models","text":"
    All payload models are encoded as JSON objects. Fields with empty values might be omitted in the payload.
    "},{"location":"documentation/usage/webhooks/#user-payload-entity-user","title":"User Payload (entity: user)","text":"JSON Field Type Description CreatedBy string Creator identifier UpdatedBy string Last updater identifier CreatedAt time.Time Time of creation UpdatedAt time.Time Time of last update Identifier string Unique user identifier Email string User email Source string Authentication source ProviderName string Name of auth provider IsAdmin bool Whether user has admin privileges Firstname string User's first name (optional) Lastname string User's last name (optional) Phone string Contact phone number (optional) Department string User's department (optional) Notes string Additional notes (optional) Disabled *time.Time When user was disabled DisabledReason string Reason for deactivation Locked *time.Time When user account was locked LockedReason string Reason for being locked"},{"location":"documentation/usage/webhooks/#peer-payload-entity-peer","title":"Peer Payload (entity: peer)","text":"JSON Field Type Description CreatedBy string Creator identifier UpdatedBy string Last updater identifier CreatedAt time.Time Creation timestamp UpdatedAt time.Time Last update timestamp Endpoint string Peer endpoint address EndpointPublicKey string Public key of peer endpoint AllowedIPsStr string Allowed IPs ExtraAllowedIPsStr string Extra allowed IPs PresharedKey string Pre-shared key for encryption PersistentKeepalive int Keepalive interval in seconds DisplayName string Display name of the peer Identifier string Unique identifier UserIdentifier string Associated user ID (optional) InterfaceIdentifier string Interface this peer is attached to Disabled *time.Time When the peer was disabled DisabledReason string Reason for being disabled ExpiresAt *time.Time Expiration date Notes string Notes for this peer AutomaticallyCreated bool Whether peer was auto-generated PrivateKey string Peer private key PublicKey string Peer public key InterfaceType string Type of the peer interface Addresses []string IP addresses CheckAliveAddress string Address used for alive checks DnsStr string DNS servers DnsSearchStr string DNS search domains Mtu int MTU (Maximum Transmission Unit) FirewallMark uint32 Firewall mark (optional) RoutingTable string Custom routing table (optional) PreUp string Command before bringing up interface PostUp string Command after bringing up interface PreDown string Command before bringing down interface PostDown string Command after bringing down interface"},{"location":"documentation/usage/webhooks/#interface-payload-entity-interface","title":"Interface Payload (entity: interface)","text":"JSON Field Type Description CreatedBy string Creator identifier UpdatedBy string Last updater identifier CreatedAt time.Time Creation timestamp UpdatedAt time.Time Last update timestamp Identifier string Unique identifier PrivateKey string Private key for the interface PublicKey string Public key for the interface ListenPort int Listening port Addresses []string IP addresses DnsStr string DNS servers DnsSearchStr string DNS search domains Mtu int MTU (Maximum Transmission Unit) FirewallMark uint32 Firewall mark RoutingTable string Custom routing table PreUp string Command before bringing up interface PostUp string Command after bringing up interface PreDown string Command before bringing down interface PostDown string Command after bringing down interface SaveConfig bool Whether to save config to file DisplayName string Human-readable name Type string Type of interface DriverType string Driver used Disabled *time.Time When the interface was disabled DisabledReason string Reason for being disabled PeerDefNetworkStr string Default peer network configuration PeerDefDnsStr string Default peer DNS servers PeerDefDnsSearchStr string Default peer DNS search domains PeerDefEndpoint string Default peer endpoint PeerDefAllowedIPsStr string Default peer allowed IPs PeerDefMtu int Default peer MTU PeerDefPersistentKeepalive int Default keepalive value PeerDefFirewallMark uint32 Default firewall mark for peers PeerDefRoutingTable string Default routing table for peers PeerDefPreUp string Default peer pre-up command PeerDefPostUp string Default peer post-up command PeerDefPreDown string Default peer pre-down command PeerDefPostDown string Default peer post-down command"},{"location":"documentation/usage/webhooks/#peer-metrics-payload-entity-peer_metric","title":"Peer Metrics Payload (entity: peer_metric)","text":"JSON Field Type Description Status PeerStatus Current status of the peer Peer Peer Peer  data 
    PeerStatus sub-structure:
     JSON Field Type Description UpdatedAt time.Time Time of last status update IsConnected bool Is peer currently connected IsPingable bool Can peer be pinged LastPing *time.Time Time of last successful ping BytesReceived uint64 Bytes received from peer BytesTransmitted uint64 Bytes sent to peer Endpoint string Last known endpoint LastHandshake *time.Time Last successful handshake LastSessionStart *time.Time Time the last session began"},{"location":"documentation/usage/webhooks/#example-payloads","title":"Example Payloads","text":"
    The following payload is an example of a webhook event when a peer connects to the VPN:
     
    {\n  \"event\": \"connect\",\n  \"entity\": \"peer_metric\",\n  \"identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n  \"payload\": {\n    \"Status\": {\n      \"UpdatedAt\": \"2025-06-27T22:20:08.734900034+02:00\",\n      \"IsConnected\": true,\n      \"IsPingable\": false,\n      \"BytesReceived\": 212,\n      \"BytesTransmitted\": 2884,\n      \"Endpoint\": \"10.55.66.77:58756\",\n      \"LastHandshake\": \"2025-06-27T22:19:46.580842776+02:00\",\n      \"LastSessionStart\": \"2025-06-27T22:19:46.580842776+02:00\"\n    },\n    \"Peer\": {\n      \"CreatedBy\": \"admin@wgportal.local\",\n      \"UpdatedBy\": \"admin@wgportal.local\",\n      \"CreatedAt\": \"2025-06-26T21:43:49.251839574+02:00\",\n      \"UpdatedAt\": \"2025-06-27T22:18:39.67763985+02:00\",\n      \"Endpoint\": \"10.55.66.1:51820\",\n      \"EndpointPublicKey\": \"eiVibpi3C2PUPcx2kwA5s09OgHx7AEaKMd33k0LQ5mM=\",\n      \"AllowedIPsStr\": \"10.11.12.0/24,fdfd:d3ad:c0de:1234::/64\",\n      \"ExtraAllowedIPsStr\": \"\",\n      \"PresharedKey\": \"p9DDeLUSLOdQcjS8ZsBAiqUzwDIUvTyzavRZFuzhvyE=\",\n      \"PersistentKeepalive\": 16,\n      \"DisplayName\": \"Peer Fb5TaziA\",\n      \"Identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n      \"UserIdentifier\": \"admin@wgportal.local\",\n      \"InterfaceIdentifier\": \"wgTesting\",\n      \"AutomaticallyCreated\": false,\n      \"PrivateKey\": \"QBFNBe+7J49ergH0ze2TGUJMFrL/2bOL50Z2cgluYW8=\",\n      \"PublicKey\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n      \"InterfaceType\": \"client\",\n      \"Addresses\": [\n        \"10.11.12.10/32\",\n        \"fdfd:d3ad:c0de:1234::a/128\"\n      ],\n      \"CheckAliveAddress\": \"\",\n      \"DnsStr\": \"\",\n      \"DnsSearchStr\": \"\",\n      \"Mtu\": 1420\n    }\n  }\n}\n
     
    Here is another example of a webhook event when a peer is updated:
     
    {\n  \"event\": \"update\",\n  \"entity\": \"peer\",\n  \"identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n  \"payload\": {\n    \"CreatedBy\": \"admin@wgportal.local\",\n    \"UpdatedBy\": \"admin@wgportal.local\",\n    \"CreatedAt\": \"2025-06-26T21:43:49.251839574+02:00\",\n    \"UpdatedAt\": \"2025-06-27T22:18:39.67763985+02:00\",\n    \"Endpoint\": \"10.55.66.1:51820\",\n    \"EndpointPublicKey\": \"eiVibpi3C2PUPcx2kwA5s09OgHx7AEaKMd33k0LQ5mM=\",\n    \"AllowedIPsStr\": \"10.11.12.0/24,fdfd:d3ad:c0de:1234::/64\",\n    \"ExtraAllowedIPsStr\": \"\",\n    \"PresharedKey\": \"p9DDeLUSLOdQcjS8ZsBAiqUzwDIUvTyzavRZFuzhvyE=\",\n    \"PersistentKeepalive\": 16,\n    \"DisplayName\": \"Peer Fb5TaziA\",\n    \"Identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n    \"UserIdentifier\": \"admin@wgportal.local\",\n    \"InterfaceIdentifier\": \"wgTesting\",\n    \"AutomaticallyCreated\": false,\n    \"PrivateKey\": \"QBFNBe+7J49ergH0ze2TGUJMFrL/2bOL50Z2cgluYW8=\",\n    \"PublicKey\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n    \"InterfaceType\": \"client\",\n    \"Addresses\": [\n      \"10.11.12.10/32\",\n      \"fdfd:d3ad:c0de:1234::a/128\"\n    ],\n    \"CheckAliveAddress\": \"\",\n    \"DnsStr\": \"\",\n    \"DnsSearchStr\": \"\",\n    \"Mtu\": 1420\n  }\n}\n
    "}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"],"fields":{"title":{"boost":1000.0},"text":{"boost":1.0},"tags":{"boost":1000000.0}}},"docs":[{"location":"documentation/overview/","title":"Overview","text":"
    WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
     
    The configuration portal supports using a database (SQLite, MySQL, MsSQL, or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
    "},{"location":"documentation/overview/#features","title":"Features","text":"
       
    • Self-hosted - the whole application is a single binary
      •  
    • Responsive multi-language web UI with dark-mode written in Vue.js
      •  
    • Automatically selects IP from the network pool assigned to the client
      •  
    • QR-Code for convenient mobile client configuration
      •  
    • Sends email to the client with QR-code and client config
      •  
    • Enable / Disable clients seamlessly
      •  
    • Generation of wg-quick configuration file (wgX.conf) if required
      •  
    • User authentication (database, OAuth, or LDAP), Passkey support
      •  
    • IPv6 ready
      •  
    • Docker ready
      •  
    • Can be used with existing WireGuard setups
      •  
    • Support for multiple WireGuard interfaces
      •  
    • Supports multiple WireGuard backends (wgctrl, MikroTik, or pfSense)
      •  
    • Peer Expiry Feature
      •  
    • Handles route and DNS settings like wg-quick does
      •  
    • Exposes Prometheus metrics for monitoring and alerting
      •  
    • REST API for management and client deployment
      •  
    • Webhook for custom actions on peer, interface, or user updates
      •  
    "},{"location":"documentation/configuration/examples/","title":"Examples","text":"
    Below are some sample YAML configurations demonstrating how to override some default values.
    "},{"location":"documentation/configuration/examples/#basic","title":"Basic","text":"
    core:\n  admin_user: test@example.com\n  admin_password: password\n  admin_api_token: super-s3cr3t-api-token-or-a-UUID\n  import_existing: false\n  create_default_peer: true\n  self_provisioning_allowed: true\n\nbackend:\n  # default backend decides where new interfaces are created\n  default: mikrotik\n\n  # A prefix for resolvconf. Usually it is \"tun.\". If you are using systemd, the prefix should be empty.\n  local_resolvconf_prefix: \"tun.\"\n\n  mikrotik:\n    - id: mikrotik                   # unique id, not \"local\"\n      display_name: RouterOS RB5009  # optional nice name\n      api_url: https://10.10.10.10/rest\n      api_user: wgportal\n      api_password: a-super-secret-password\n      api_verify_tls: false        # set to false only if using self-signed during testing\n      api_timeout: 30s             # maximum request duration\n      concurrency: 5               # limit parallel REST calls to device\n      debug: false                 # verbose logging for this backend\n      ignored_interfaces:          # ignore these interfaces during import\n      - wgTest1\n      - wgTest2\n\nweb:\n  site_title: My WireGuard Server\n  site_company_name: My Company\n  listening_address: :8080\n  external_url: https://my.external-domain.com\n  csrf_secret: super-s3cr3t-csrf\n  session_secret: super-s3cr3t-session\n  request_logging: true\n\nadvanced:\n  log_level: trace\n  log_pretty: true\n  log_json: false\n  config_storage_path: /etc/wireguard\n  expiry_check_interval: 5m\n\ndatabase:\n  debug: true\n  type: sqlite\n  dsn: data/sqlite.db\n  encryption_passphrase: change-this-s3cr3t-encryption-passphrase\n\nauth:\n  webauthn:\n    enabled: true\n
    "},{"location":"documentation/configuration/examples/#ldap-authentication-and-synchronization","title":"LDAP Authentication and Synchronization","text":"
    # ... (basic configuration)\n\nauth:\n  ldap:\n    # a sample LDAP provider with user sync enabled\n    - provider_name: ldap\n      url: ldap://srv-ad1.company.local:389\n      bind_user: ldap_wireguard@company.local\n      bind_pass: super-s3cr3t-ldap\n      base_dn: DC=COMPANY,DC=LOCAL\n      login_filter: (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n      sync_interval: 15m\n      sync_filter: (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n      disable_missing: true\n      field_map:\n        user_identifier: sAMAccountName\n        email: mail\n        firstname: givenName\n        lastname: sn\n        phone: telephoneNumber\n        department: department\n        memberof: memberOf\n      admin_group: CN=WireGuardAdmins,OU=Some-OU,DC=COMPANY,DC=LOCAL\n      registration_enabled: true\n      log_user_info: true\n
    "},{"location":"documentation/configuration/examples/#openid-connect-oidc-authentication","title":"OpenID Connect (OIDC) Authentication","text":"
    # ... (basic configuration)\n\nauth:\n  oidc:\n    # A sample Entra ID provider with environment variable substitution.\n    # Only users with an @outlook.com email address are allowed to register or login.\n    - provider_name: azure\n      display_name: Login with</br>Entra ID\n      registration_enabled: true\n      base_url: \"https://login.microsoftonline.com/${AZURE_TENANT_ID}/v2.0\"\n      client_id: \"${AZURE_CLIENT_ID}\"\n      client_secret: \"${AZURE_CLIENT_SECRET}\"\n      allowed_domains:\n        - \"outlook.com\"\n      extra_scopes:\n        - profile\n        - email\n\n    # a sample provider where users with the attribute `wg_admin` set to `true` are considered as admins\n    - provider_name: google\n      display_name: Login with</br>Google\n      base_url: https://accounts.google.com\n      client_id: the-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        is_admin: wg_admin\n      admin_mapping:\n        admin_value_regex: ^true$\n      registration_enabled: true\n      log_user_info: true\n\n    # a sample provider where users in the group `the-admin-group` are considered as admins\n    - provider_name: google2\n      display_name: Login with</br>Google2\n      base_url: https://accounts.google.com\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        user_groups: groups\n      admin_mapping:\n        admin_group_regex: ^the-admin-group$\n      registration_enabled: true\n      log_user_info: true\n
    "},{"location":"documentation/configuration/examples/#plain-oauth2-authentication","title":"Plain OAuth2 Authentication","text":"
    # ... (basic configuration)\n\nauth:\n  oauth:\n    # a sample provider where users with the attribute `this-attribute-must-be-true` set to `true` or `True`\n    # are considered as admins\n    - provider_name: google3\n      display_name: Login with</br>Google3\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: name\n        is_admin: this-attribute-must-be-true\n      admin_mapping:\n        admin_value_regex: ^(True|true)$\n      registration_enabled: true\n\n    # a sample provider where either users with the attribute `this-attribute-must-be-true` set to `true` or \n    # users in the group `admin-group-name` are considered as admins\n    - provider_name: google4\n      display_name: Login with</br>Google4\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n        - i-want-some-groups\n      field_map:\n        email: email\n        firstname: name\n        user_identifier: sub\n        is_admin: this-attribute-must-be-true\n        user_groups: groups\n      admin_mapping:\n        admin_value_regex: ^true$\n        admin_group_regex: ^admin-group-name$\n      registration_enabled: true\n      log_user_info: true\n
     
    For more information, check out the usage documentation (e.g. General Configuration or Backends Configuration).
    "},{"location":"documentation/configuration/overview/","title":"Overview","text":"
    This page provides an overview of all available configuration options for WireGuard Portal.
     
    You can supply these configurations in a YAML file when starting the Portal. The path of the configuration file defaults to config/config.yaml (or config/config.yml) in the working directory of the executable. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal. Also, environment variable substitution in the config file is supported. Refer to the syntax.
     
    Configuration examples are available on the Examples page.
     Default configuration 
    core:\n  admin_user: admin@wgportal.local\n  admin_password: wgportal-default\n  admin_api_token: \"\"\n  disable_admin_user: false\n  editable_keys: true\n  create_default_peer: false\n  create_default_peer_on_creation: false\n  re_enable_peer_after_user_enable: true\n  delete_peer_after_user_deleted: false\n  self_provisioning_allowed: false\n  import_existing: true\n  restore_state: true\n\nbackend:\n  default: local\n  local_resolvconf_prefix: tun.\n\nadvanced:\n  log_level: info\n  log_pretty: false\n  log_json: false\n  start_listen_port: 51820\n  start_cidr_v4: 10.11.12.0/24\n  start_cidr_v6: fdfd:d3ad:c0de:1234::0/64\n  use_ip_v6: true\n  config_storage_path: \"\"\n  expiry_check_interval: 15m\n  rule_prio_offset: 20000\n  route_table_offset: 20000\n  api_admin_only: true\n  limit_additional_user_peers: 0\n\ndatabase:\n  debug: false\n  slow_query_threshold: \"0\"\n  type: sqlite\n  dsn: data/sqlite.db\n  encryption_passphrase: \"\"\n\nstatistics:\n  use_ping_checks: true\n  ping_check_workers: 10\n  ping_unprivileged: false\n  ping_check_interval: 1m\n  data_collection_interval: 1m\n  collect_interface_data: true\n  collect_peer_data: true\n  collect_audit_data: true\n  listening_address: :8787\n\nmail:\n  host: 127.0.0.1\n  port: 25\n  encryption: none\n  cert_validation: true\n  username: \"\"\n  password: \"\"\n  auth_type: plain\n  from: Wireguard Portal <noreply@wireguard.local>\n  link_only: false\n  allow_peer_email: false\n  templates_path: \"\"\n\nauth:\n  oidc: []\n  oauth: []\n  ldap: []\n  webauthn:\n    enabled: true\n  min_password_length: 16\n  hide_login_form: false\n\nweb:\n  listening_address: :8888\n  external_url: http://localhost:8888\n  base_path: \"\"\n  site_company_name: WireGuard Portal\n  site_title: WireGuard Portal\n  session_identifier: wgPortalSession\n  session_secret: very_secret\n  csrf_secret: extremely_secret\n  request_logging: false\n  expose_host_info: false\n  cert_file: \"\"\n  key_File: \"\"\n  frontend_filepath: \"\"\n\nwebhook:\n  url: \"\"\n  authentication: \"\"\n  timeout: 10s\n
     
    Below you will find sections like core, backend, advanced, database, statistics, mail, auth, web and webhook. Each section describes the individual configuration keys, their default values, and a brief explanation of their purpose.
    "},{"location":"documentation/configuration/overview/#core","title":"Core","text":"
    These are the primary configuration options that control fundamental WireGuard Portal behavior. More advanced options are found in the subsequent Advanced section.
    "},{"location":"documentation/configuration/overview/#admin_user","title":"admin_user","text":"
       
    • Default: admin@wgportal.local
      •  
    • Environment Variable: WG_PORTAL_CORE_ADMIN_USER
      •  
    • Description: The administrator user. This user will be created as a default admin if it does not yet exist.
      •  
    "},{"location":"documentation/configuration/overview/#admin_password","title":"admin_password","text":"
       
    • Default: wgportal-default
      •  
    • Environment Variable: WG_PORTAL_CORE_ADMIN_PASSWORD
      •  
    • Description: The administrator password. The default password should be changed immediately!
      •  
    • Important: The password should be strong and secure. The minimum password length is specified in auth.min_password_length. By default, it is 16 characters.
      •  
    "},{"location":"documentation/configuration/overview/#disable_admin_user","title":"disable_admin_user","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_CORE_DISABLE_ADMIN_USER
      •  
    • Description: If true, no admin user is created. This is useful if you plan to manage users exclusively through external authentication providers such as LDAP or OAuth.
      •  
    "},{"location":"documentation/configuration/overview/#admin_api_token","title":"admin_api_token","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_CORE_ADMIN_API_TOKEN
      •  
    • Description: An API token for the admin user. If a token is provided, the REST API can be accessed using this token. If empty, the API is initially disabled for the admin user.
      •  
    "},{"location":"documentation/configuration/overview/#editable_keys","title":"editable_keys","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_CORE_EDITABLE_KEYS
      •  
    • Description: Allow editing of WireGuard key-pairs directly in the UI.
      •  
    "},{"location":"documentation/configuration/overview/#create_default_peer","title":"create_default_peer","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_CORE_CREATE_DEFAULT_PEER
      •  
    • Description: If a user logs in for the first time with no existing peers, automatically create a new WireGuard peer for all server interfaces where the \"Create default peer\" flag is set.
      •  
    • Important: This option is only effective for interfaces where the \"Create default peer\" flag is set (via the UI).
      •  
    "},{"location":"documentation/configuration/overview/#create_default_peer_on_creation","title":"create_default_peer_on_creation","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_CORE_CREATE_DEFAULT_PEER_ON_CREATION
      •  
    • Description: If an LDAP user is created (e.g., through LDAP sync) and has no peers, automatically create a new WireGuard peer for all server interfaces where the \"Create default peer\" flag is set.
      •  
    • Important: This option requires create_default_peer to be enabled.
      •  
    "},{"location":"documentation/configuration/overview/#re_enable_peer_after_user_enable","title":"re_enable_peer_after_user_enable","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_CORE_RE_ENABLE_PEER_AFTER_USER_ENABLE
      •  
    • Description: Re-enable all peers that were previously disabled if the associated user is re-enabled.
      •  
    "},{"location":"documentation/configuration/overview/#delete_peer_after_user_deleted","title":"delete_peer_after_user_deleted","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_CORE_DELETE_PEER_AFTER_USER_DELETED
      •  
    • Description: If a user is deleted, remove all linked peers. Otherwise, peers remain but are disabled.
      •  
    "},{"location":"documentation/configuration/overview/#self_provisioning_allowed","title":"self_provisioning_allowed","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_CORE_SELF_PROVISIONING_ALLOWED
      •  
    • Description: Allow registered (non-admin) users to self-provision peers from their profile page.
      •  
    "},{"location":"documentation/configuration/overview/#import_existing","title":"import_existing","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_CORE_IMPORT_EXISTING
      •  
    • Description: On startup, import existing WireGuard interfaces and peers into WireGuard Portal.
      •  
    "},{"location":"documentation/configuration/overview/#restore_state","title":"restore_state","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_CORE_RESTORE_STATE
      •  
    • Description: Restore the WireGuard interface states (up/down) that existed before WireGuard Portal started.
      •  
    "},{"location":"documentation/configuration/overview/#backend","title":"Backend","text":"
    Configuration options for the WireGuard backend, which manages the WireGuard interfaces and peers. The current MikroTik backend is in BETA and may not support all features.
    "},{"location":"documentation/configuration/overview/#default","title":"default","text":"
       
    • Default: local
      •  
    • Description: The default backend to use for managing WireGuard interfaces.    Valid options are: local, or other backend id's configured in the mikrotik section.
      •  
    "},{"location":"documentation/configuration/overview/#local_resolvconf_prefix","title":"local_resolvconf_prefix","text":"
       
    • Default: tun.
      •  
    • Environment Variable: WG_PORTAL_BACKEND_LOCAL_RESOLVCONF_PREFIX
      •  
    • Description: Interface name prefix for WireGuard interfaces on the local system which is used to configure DNS servers with resolvconf.    It depends on the resolvconf implementation you are using, most use a prefix of tun., but some have an empty prefix (e.g., systemd).
      •  
    "},{"location":"documentation/configuration/overview/#ignored_local_interfaces","title":"ignored_local_interfaces","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_BACKEND_IGNORED_LOCAL_INTERFACES   (comma-separated values)
      •  
    • Description: A list of interface names to exclude when enumerating local interfaces.   This is useful if you want to prevent certain interfaces from being imported from the local system.
      •  
    "},{"location":"documentation/configuration/overview/#mikrotik","title":"Mikrotik","text":"
    The mikrotik array contains a list of MikroTik backend definitions. Each entry describes how to connect to a MikroTik RouterOS instance that hosts WireGuard interfaces.
     
    Below are the properties for each entry inside backend.mikrotik:
    "},{"location":"documentation/configuration/overview/#id","title":"id","text":"
       
    • Default: (empty)
      •  
    • Description: A unique identifier for this backend.    This value can be referenced by backend.default to use this backend as default.   The identifier must be unique across all backends and must not use the reserved keyword local.
      •  
    "},{"location":"documentation/configuration/overview/#display_name","title":"display_name","text":"
       
    • Default: (empty)
      •  
    • Description: A human-friendly display name for this backend. If omitted, the id will be used as the display name.
      •  
    "},{"location":"documentation/configuration/overview/#api_url","title":"api_url","text":"
       
    • Default: (empty)
      •  
    • Description: Base URL of the MikroTik REST API, including scheme and path, e.g., https://10.10.10.10:8729/rest.
      •  
    "},{"location":"documentation/configuration/overview/#api_user","title":"api_user","text":"
       
    • Default: (empty)
      •  
    • Description: Username for authenticating against the MikroTik API.   Ensure that the user has sufficient permissions to manage WireGuard interfaces and peers.
      •  
    "},{"location":"documentation/configuration/overview/#api_password","title":"api_password","text":"
       
    • Default: (empty)
      •  
    • Description: Password for the specified API user.
      •  
    "},{"location":"documentation/configuration/overview/#api_verify_tls","title":"api_verify_tls","text":"
       
    • Default: false
      •  
    • Description: Whether to verify the TLS certificate of the MikroTik API endpoint. Set to false to allow self-signed certificates (not recommended for production).
      •  
    "},{"location":"documentation/configuration/overview/#api_timeout","title":"api_timeout","text":"
       
    • Default: 30s
      •  
    • Description: Timeout for API requests to the MikroTik device. Uses Go duration format (e.g., 10s, 1m). If omitted, a default of 30 seconds is used.
      •  
    "},{"location":"documentation/configuration/overview/#concurrency","title":"concurrency","text":"
       
    • Default: 5
      •  
    • Description: Maximum number of concurrent API requests the backend will issue when enumerating interfaces and their details. If 0 or negative, a sane default of 5 is used.
      •  
    "},{"location":"documentation/configuration/overview/#ignored_interfaces","title":"ignored_interfaces","text":"
       
    • Default: (empty)
      •  
    • Description: A list of interface names to exclude during interface enumeration.   This is useful if you want to prevent specific interfaces from being imported from the MikroTik device.
      •  
    "},{"location":"documentation/configuration/overview/#debug","title":"debug","text":"
       
    • Default: false
      •  
    • Description: Enable verbose debug logging for the MikroTik backend.
      •  
     
    For more details on configuring the MikroTik backend, see the Backends documentation.
    "},{"location":"documentation/configuration/overview/#advanced","title":"Advanced","text":"
    Additional or more specialized configuration options for logging and interface creation details.
    "},{"location":"documentation/configuration/overview/#log_level","title":"log_level","text":"
       
    • Default: info
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_LOG_LEVEL
      •  
    • Description: The log level used by the application. Valid options are: trace, debug, info, warn, error.
      •  
    "},{"location":"documentation/configuration/overview/#log_pretty","title":"log_pretty","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_LOG_PRETTY
      •  
    • Description: If true, log messages are colorized and formatted for readability (pretty-print).
      •  
    "},{"location":"documentation/configuration/overview/#log_json","title":"log_json","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_LOG_JSON
      •  
    • Description: If true, log messages are structured in JSON format.
      •  
    "},{"location":"documentation/configuration/overview/#start_listen_port","title":"start_listen_port","text":"
       
    • Default: 51820
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_START_LISTEN_PORT
      •  
    • Description: The first port to use when automatically creating new WireGuard interfaces.
      •  
    "},{"location":"documentation/configuration/overview/#start_cidr_v4","title":"start_cidr_v4","text":"
       
    • Default: 10.11.12.0/24
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_START_CIDR_V4
      •  
    • Description: The initial IPv4 subnet to use when automatically creating new WireGuard interfaces.
      •  
    "},{"location":"documentation/configuration/overview/#start_cidr_v6","title":"start_cidr_v6","text":"
       
    • Default: fdfd:d3ad:c0de:1234::0/64
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_START_CIDR_V6
      •  
    • Description: The initial IPv6 subnet to use when automatically creating new WireGuard interfaces.
      •  
    "},{"location":"documentation/configuration/overview/#use_ip_v6","title":"use_ip_v6","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_USE_IP_V6
      •  
    • Description: Enable or disable IPv6 support.
      •  
    "},{"location":"documentation/configuration/overview/#config_storage_path","title":"config_storage_path","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_CONFIG_STORAGE_PATH
      •  
    • Description: Path to a directory where wg-quick style configuration files will be stored (if you need local filesystem configs).
      •  
    "},{"location":"documentation/configuration/overview/#expiry_check_interval","title":"expiry_check_interval","text":"
       
    • Default: 15m
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_EXPIRY_CHECK_INTERVAL
      •  
    • Description: Interval after which existing peers are checked if they are expired. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
      •  
    "},{"location":"documentation/configuration/overview/#rule_prio_offset","title":"rule_prio_offset","text":"
       
    • Default: 20000
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_RULE_PRIO_OFFSET
      •  
    • Description: Offset for IP route rule priorities when configuring routing.
      •  
    "},{"location":"documentation/configuration/overview/#route_table_offset","title":"route_table_offset","text":"
       
    • Default: 20000
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_ROUTE_TABLE_OFFSET
      •  
    • Description: Offset for IP route table IDs when configuring routing.
      •  
    "},{"location":"documentation/configuration/overview/#api_admin_only","title":"api_admin_only","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_API_ADMIN_ONLY
      •  
    • Description: If true, the public REST API is accessible only to admin users. The API docs live at /api/v1/doc.html.
      •  
    "},{"location":"documentation/configuration/overview/#limit_additional_user_peers","title":"limit_additional_user_peers","text":"
       
    • Default: 0
      •  
    • Environment Variable: WG_PORTAL_ADVANCED_LIMIT_ADDITIONAL_USER_PEERS
      •  
    • Description: Limit additional peers a normal user can create. 0 means unlimited.
      •  
    "},{"location":"documentation/configuration/overview/#database","title":"Database","text":"
    Configuration for the underlying database used by WireGuard Portal.  Supported databases include SQLite, MySQL, Microsoft SQL Server, and Postgres.
     
    If sensitive values (like private keys) should be stored in an encrypted format, set the encryption_passphrase option.
    "},{"location":"documentation/configuration/overview/#debug_1","title":"debug","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_DATABASE_DEBUG
      •  
    • Description: If true, logs all database statements (verbose).
      •  
    "},{"location":"documentation/configuration/overview/#slow_query_threshold","title":"slow_query_threshold","text":"
       
    • Default: \"0\"
      •  
    • Environment Variable: WG_PORTAL_DATABASE_SLOW_QUERY_THRESHOLD
      •  
    • Description: A time threshold (e.g., 100ms) above which queries are considered slow and logged as warnings. If zero, slow query logging is disabled. Format uses s, ms for seconds, milliseconds, see time.ParseDuration. The value must be a string.
      •  
    "},{"location":"documentation/configuration/overview/#type","title":"type","text":"
       
    • Default: sqlite
      •  
    • Environment Variable: WG_PORTAL_DATABASE_TYPE
      •  
    • Description: The database type. Valid options: sqlite, mssql, mysql, postgres.
      •  
    "},{"location":"documentation/configuration/overview/#dsn","title":"dsn","text":"
       
    • Default: data/sqlite.db
      •  
    • Environment Variable: WG_PORTAL_DATABASE_DSN
      •  
    • Description: The Data Source Name (DSN) for connecting to the database.   For example:   
      user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local\n
      •  
    "},{"location":"documentation/configuration/overview/#encryption_passphrase","title":"encryption_passphrase","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_DATABASE_ENCRYPTION_PASSPHRASE
      •  
    • Description: Passphrase for encrypting sensitive values such as private keys in the database. Encryption is only applied if this passphrase is set.   Important: Once you enable encryption by setting this passphrase, you cannot disable it or change it afterward.    New or updated records will be encrypted; existing data remains in plaintext until it\u2019s next modified.
      •  
    "},{"location":"documentation/configuration/overview/#statistics","title":"Statistics","text":"
    Controls how WireGuard Portal collects and reports usage statistics, including ping checks and Prometheus metrics.
    "},{"location":"documentation/configuration/overview/#use_ping_checks","title":"use_ping_checks","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_USE_PING_CHECKS
      •  
    • Description: Enable periodic ping checks to verify that peers remain responsive.
      •  
    "},{"location":"documentation/configuration/overview/#ping_check_workers","title":"ping_check_workers","text":"
       
    • Default: 10
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_PING_CHECK_WORKERS
      •  
    • Description: Number of parallel worker processes for ping checks.
      •  
    "},{"location":"documentation/configuration/overview/#ping_unprivileged","title":"ping_unprivileged","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_PING_UNPRIVILEGED
      •  
    • Description: If false, ping checks run without root privileges. This is currently considered BETA.
      •  
    "},{"location":"documentation/configuration/overview/#ping_check_interval","title":"ping_check_interval","text":"
       
    • Default: 1m
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_PING_CHECK_INTERVAL
      •  
    • Description: Interval between consecutive ping checks for all peers. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
      •  
    "},{"location":"documentation/configuration/overview/#data_collection_interval","title":"data_collection_interval","text":"
       
    • Default: 1m
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_DATA_COLLECTION_INTERVAL
      •  
    • Description: Interval between data collection cycles (bytes sent/received, handshake times, etc.). Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
      •  
    "},{"location":"documentation/configuration/overview/#collect_interface_data","title":"collect_interface_data","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_COLLECT_INTERFACE_DATA
      •  
    • Description: If true, collects interface-level data (bytes in/out) for monitoring and statistics.
      •  
    "},{"location":"documentation/configuration/overview/#collect_peer_data","title":"collect_peer_data","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_COLLECT_PEER_DATA
      •  
    • Description: If true, collects peer-level data (bytes, last handshake, endpoint, etc.).
      •  
    "},{"location":"documentation/configuration/overview/#collect_audit_data","title":"collect_audit_data","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_COLLECT_AUDIT_DATA
      •  
    • Description: If true, logs certain portal events (such as user logins) to the database.
      •  
    "},{"location":"documentation/configuration/overview/#listening_address","title":"listening_address","text":"
       
    • Default: :8787
      •  
    • Environment Variable: WG_PORTAL_STATISTICS_LISTENING_ADDRESS
      •  
    • Description: Address and port for the integrated Prometheus metric server (e.g., :8787 or 127.0.0.1:8787).
      •  
    "},{"location":"documentation/configuration/overview/#mail","title":"Mail","text":"
    Options for configuring email notifications or sending peer configurations via email.  By default, emails will only be sent to peers that have a valid user record linked.  To send emails to all peers that have a valid email-address as user-identifier, set allow_peer_email to true.
    "},{"location":"documentation/configuration/overview/#host","title":"host","text":"
       
    • Default: 127.0.0.1
      •  
    • Environment Variable: WG_PORTAL_MAIL_HOST
      •  
    • Description: Hostname or IP of the SMTP server.
      •  
    "},{"location":"documentation/configuration/overview/#port","title":"port","text":"
       
    • Default: 25
      •  
    • Environment Variable: WG_PORTAL_MAIL_PORT
      •  
    • Description: Port number for the SMTP server.
      •  
    "},{"location":"documentation/configuration/overview/#encryption","title":"encryption","text":"
       
    • Default: none
      •  
    • Environment Variable: WG_PORTAL_MAIL_ENCRYPTION
      •  
    • Description: SMTP encryption type. Valid values: none, tls, starttls.
      •  
    "},{"location":"documentation/configuration/overview/#cert_validation","title":"cert_validation","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_MAIL_CERT_VALIDATION
      •  
    • Description: If true, validate the SMTP server certificate (relevant if encryption = tls).
      •  
    "},{"location":"documentation/configuration/overview/#username","title":"username","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_MAIL_USERNAME
      •  
    • Description: Optional SMTP username for authentication.
      •  
    "},{"location":"documentation/configuration/overview/#password","title":"password","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_MAIL_PASSWORD
      •  
    • Description: Optional SMTP password for authentication.
      •  
    "},{"location":"documentation/configuration/overview/#auth_type","title":"auth_type","text":"
       
    • Default: plain
      •  
    • Environment Variable: WG_PORTAL_MAIL_AUTH_TYPE
      •  
    • Description: SMTP authentication type. Valid values: plain, login, crammd5.
      •  
    "},{"location":"documentation/configuration/overview/#from","title":"from","text":"
       
    • Default: Wireguard Portal <noreply@wireguard.local>
      •  
    • Environment Variable: WG_PORTAL_MAIL_FROM
      •  
    • Description: The default \"From\" address when sending emails.
      •  
    "},{"location":"documentation/configuration/overview/#link_only","title":"link_only","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_MAIL_LINK_ONLY
      •  
    • Description: If true, emails only contain a link to WireGuard Portal, rather than attaching the full configuration.
      •  
    "},{"location":"documentation/configuration/overview/#allow_peer_email","title":"allow_peer_email","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_MAIL_ALLOW_PEER_EMAIL
      •  
    • Description: If true, and a peer has no valid user record linked, but the user-identifier of the peer is a valid email address, emails will be sent to that email address.   If false, and the peer has no valid user record linked, emails will not be sent.   If a peer has linked a valid user, the email address is always taken from the user record.
      •  
    "},{"location":"documentation/configuration/overview/#templates_path","title":"templates_path","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_MAIL_TEMPLATES_PATH
      •  
    • Description: Path to the email template files that override embedded templates. Check usage documentation for an example.`
      •  
    "},{"location":"documentation/configuration/overview/#auth","title":"Auth","text":"
    WireGuard Portal supports multiple authentication strategies, including OpenID Connect (oidc), OAuth (oauth), Passkeys (webauthn) and LDAP (ldap). Each can have multiple providers configured. Below are the relevant keys.
     
    Some core authentication options are shared across all providers, while others are specific to each provider type.
    "},{"location":"documentation/configuration/overview/#min_password_length","title":"min_password_length","text":"
       
    • Default: 16
      •  
    • Environment Variable: WG_PORTAL_AUTH_MIN_PASSWORD_LENGTH
      •  
    • Description: Minimum password length for local authentication. This is not enforced for LDAP authentication.   The default admin password strength is also enforced by this setting.
      •  
    • Important: The password should be strong and secure. It is recommended to use a password with at least 16 characters, including uppercase and lowercase letters, numbers, and special characters.
      •  
    "},{"location":"documentation/configuration/overview/#hide_login_form","title":"hide_login_form","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_AUTH_HIDE_LOGIN_FORM
      •  
    • Description: If true, the login form is hidden and only the OIDC, OAuth, LDAP, or WebAuthn providers are shown. This is useful if you want to enforce a specific authentication method.   If no social login providers are configured, the login form is always shown, regardless of this setting.
      •  
    • Important: You can still access the login form by adding the ?all query parameter to the login URL (e.g. https://wg.portal/#/login?all). 
      •  
    "},{"location":"documentation/configuration/overview/#oidc","title":"OIDC","text":"
    The oidc array contains a list of OpenID Connect providers.  Below are the properties for each OIDC provider entry inside auth.oidc:
    "},{"location":"documentation/configuration/overview/#provider_name","title":"provider_name","text":"
       
    • Default: (empty)
      •  
    • Description: A unique name for this provider. Must not conflict with other providers.
      •  
    "},{"location":"documentation/configuration/overview/#display_name_1","title":"display_name","text":"
       
    • Default: (empty)
      •  
    • Description: A user-friendly name shown on the login page (e.g., \"Login with Google\").
      •  
    "},{"location":"documentation/configuration/overview/#base_url","title":"base_url","text":"
       
    • Default: (empty)
      •  
    • Description: The OIDC provider\u2019s base URL (e.g., https://accounts.google.com).
      •  
    "},{"location":"documentation/configuration/overview/#client_id","title":"client_id","text":"
       
    • Default: (empty)
      •  
    • Description: The OAuth client ID from the OIDC provider.
      •  
    "},{"location":"documentation/configuration/overview/#client_secret","title":"client_secret","text":"
       
    • Default: (empty)
      •  
    • Description: The OAuth client secret from the OIDC provider.
      •  
    "},{"location":"documentation/configuration/overview/#extra_scopes","title":"extra_scopes","text":"
       
    • Default: (empty)
      •  
    • Description: A list of additional OIDC scopes (e.g., profile, email).
      •  
    "},{"location":"documentation/configuration/overview/#allowed_domains","title":"allowed_domains","text":"
       
    • Default: (empty)
      •  
    • Description: A list of allowlisted domains. Only users with email addresses in these domains can log in or register. This is useful for restricting access to specific organizations or groups.
      •  
    "},{"location":"documentation/configuration/overview/#field_map","title":"field_map","text":"
       
    • Default: (empty)
      •  
    • Description: Maps OIDC claims to WireGuard Portal user fields. 
      •  
    •  
      Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
       Field Typical OIDC Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
      •  
    "},{"location":"documentation/configuration/overview/#admin_mapping","title":"admin_mapping","text":"
       
    • Default: (empty)
      •  
    • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
         
      • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
        •  
      • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
        •  
       
      •  
    "},{"location":"documentation/configuration/overview/#registration_enabled","title":"registration_enabled","text":"
       
    • Default: false
      •  
    • Description: If true, a new user will be created in WireGuard Portal if not already present.
      •  
    "},{"location":"documentation/configuration/overview/#log_user_info","title":"log_user_info","text":"
       
    • Default: false
      •  
    • Description: If true, OIDC user data is logged at the trace level upon login (for debugging).
      •  
    "},{"location":"documentation/configuration/overview/#log_sensitive_info","title":"log_sensitive_info","text":"
       
    • Default: false
      •  
    • Description: If true, sensitive OIDC user data, such as tokens and raw responses, will be logged at the trace level upon login (for debugging).
      •  
    • Important: Keep this setting disabled in production environments! Remove logs once you finished debugging authentication issues.
      •  
    "},{"location":"documentation/configuration/overview/#oauth","title":"OAuth","text":"
    The oauth array contains a list of plain OAuth2 providers. Below are the properties for each OAuth provider entry inside auth.oauth:
    "},{"location":"documentation/configuration/overview/#provider_name_1","title":"provider_name","text":"
       
    • Default: (empty)
      •  
    • Description: A unique name for this provider. Must not conflict with other providers.
      •  
    "},{"location":"documentation/configuration/overview/#display_name_2","title":"display_name","text":"
       
    • Default: (empty)
      •  
    • Description: A user-friendly name shown on the login page.
      •  
    "},{"location":"documentation/configuration/overview/#client_id_1","title":"client_id","text":"
       
    • Default: (empty)
      •  
    • Description: The OAuth client ID for the provider.
      •  
    "},{"location":"documentation/configuration/overview/#client_secret_1","title":"client_secret","text":"
       
    • Default: (empty)
      •  
    • Description: The OAuth client secret for the provider.
      •  
    "},{"location":"documentation/configuration/overview/#auth_url","title":"auth_url","text":"
       
    • Default: (empty)
      •  
    • Description: URL of the authentication endpoint.
      •  
    "},{"location":"documentation/configuration/overview/#token_url","title":"token_url","text":"
       
    • Default: (empty)
      •  
    • Description: URL of the token endpoint.
      •  
    "},{"location":"documentation/configuration/overview/#user_info_url","title":"user_info_url","text":"
       
    • Default: (empty)
      •  
    • Description: URL of the user information endpoint.
      •  
    "},{"location":"documentation/configuration/overview/#scopes","title":"scopes","text":"
       
    • Default: (empty)
      •  
    • Description: A list of OAuth scopes.
      •  
    "},{"location":"documentation/configuration/overview/#allowed_domains_1","title":"allowed_domains","text":"
       
    • Default: (empty)
      •  
    • Description: A list of allowlisted domains. Only users with email addresses in these domains can log in or register. This is useful for restricting access to specific organizations or groups.
      •  
    "},{"location":"documentation/configuration/overview/#field_map_1","title":"field_map","text":"
       
    • Default: (empty)
      •  
    • Description: Maps OAuth attributes to WireGuard Portal fields.
      •  
    •  
      Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
       Field Typical Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
      •  
    "},{"location":"documentation/configuration/overview/#admin_mapping_1","title":"admin_mapping","text":"
       
    • Default: (empty)
      •  
    • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
      •  
    • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
      •  
    • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
      •  
    "},{"location":"documentation/configuration/overview/#registration_enabled_1","title":"registration_enabled","text":"
       
    • Default: false
      •  
    • Description: If true, new users are created automatically on successful login.
      •  
    "},{"location":"documentation/configuration/overview/#log_user_info_1","title":"log_user_info","text":"
       
    • Default: false
      •  
    • Description: If true, logs user info at the trace level upon login.
      •  
    "},{"location":"documentation/configuration/overview/#log_sensitive_info_1","title":"log_sensitive_info","text":"
       
    • Default: false
      •  
    • Description: If true, sensitive OIDC user data, such as tokens and raw responses, will be logged at the trace level upon login (for debugging).
      •  
    • Important: Keep this setting disabled in production environments! Remove logs once you finished debugging authentication issues.
      •  
    "},{"location":"documentation/configuration/overview/#ldap","title":"LDAP","text":"
    The ldap array contains a list of LDAP authentication providers. Below are the properties for each LDAP provider entry inside auth.ldap:
    "},{"location":"documentation/configuration/overview/#provider_name_2","title":"provider_name","text":"
       
    • Default: (empty)
      •  
    • Description: A unique name for this provider. Must not conflict with other providers.
      •  
    "},{"location":"documentation/configuration/overview/#url","title":"url","text":"
       
    • Default: (empty)
      •  
    • Description: The LDAP server URL (e.g., ldap://srv-ad01.company.local:389).
      •  
    "},{"location":"documentation/configuration/overview/#start_tls","title":"start_tls","text":"
       
    • Default: false
      •  
    • Description: If true, use STARTTLS to secure the LDAP connection.
      •  
    "},{"location":"documentation/configuration/overview/#cert_validation_1","title":"cert_validation","text":"
       
    • Default: false
      •  
    • Description: If true, validate the LDAP server\u2019s TLS certificate.
      •  
    "},{"location":"documentation/configuration/overview/#tls_certificate_path","title":"tls_certificate_path","text":"
       
    • Default: (empty)
      •  
    • Description: Path to a TLS certificate if needed for LDAP connections.
      •  
    "},{"location":"documentation/configuration/overview/#tls_key_path","title":"tls_key_path","text":"
       
    • Default: (empty)
      •  
    • Description: Path to the corresponding TLS certificate key.
      •  
    "},{"location":"documentation/configuration/overview/#base_dn","title":"base_dn","text":"
       
    • Default: (empty)
      •  
    • Description: The base DN for user searches (e.g., DC=COMPANY,DC=LOCAL).
      •  
    "},{"location":"documentation/configuration/overview/#bind_user","title":"bind_user","text":"
       
    • Default: (empty)
      •  
    • Description: The bind user for LDAP (e.g., company\\\\ldap_wireguard or ldap_wireguard@company.local).
      •  
    "},{"location":"documentation/configuration/overview/#bind_pass","title":"bind_pass","text":"
       
    • Default: (empty)
      •  
    • Description: The bind password for LDAP authentication.
      •  
    "},{"location":"documentation/configuration/overview/#field_map_2","title":"field_map","text":"
       
    • Default: (empty)
      •  
    •  
      Description: Maps LDAP attributes to WireGuard Portal fields.
       
         
      • Available fields: user_identifier, email, firstname, lastname, phone, department, memberof.
        •  
       WireGuard Portal Field Typical LDAP Attribute Short Description user_identifier sAMAccountName / uid Uniquely identifies the user within the LDAP directory. email mail / userPrincipalName Stores the user's primary email address. firstname givenName Contains the user's first (given) name. lastname sn Contains the user's last (surname) name. phone telephoneNumber / mobile Holds the user's phone or mobile number. department departmentNumber / ou Specifies the department or organizational unit of the user. memberof memberOf Lists the groups and roles to which the user belongs. 
      •  
    "},{"location":"documentation/configuration/overview/#login_filter","title":"login_filter","text":"
       
    • Default: (empty)
      •  
    • Description: An LDAP filter to restrict which users can log in. Use {{login_identifier}} to insert the username.   For example:   
      (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n
      •  
    • Important: The login_filter must always be a valid LDAP filter. It should at most return one user.    If the filter returns multiple or no users, the login will fail.
      •  
    "},{"location":"documentation/configuration/overview/#admin_group","title":"admin_group","text":"
       
    • Default: (empty)
      •  
    • Description: A specific LDAP group whose members are considered administrators in WireGuard Portal.   For example:   
      CN=WireGuardAdmins,OU=Some-OU,DC=YOURDOMAIN,DC=LOCAL\n
      •  
    "},{"location":"documentation/configuration/overview/#sync_interval","title":"sync_interval","text":"
       
    • Default: (empty)
      •  
    • Description: How frequently (in duration, e.g. 30m) to synchronize users from LDAP. Empty or 0 disables sync. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.   Only users that match the sync_filter are synchronized, if disable_missing is true, users not found in LDAP are disabled.
      •  
    "},{"location":"documentation/configuration/overview/#sync_filter","title":"sync_filter","text":"
       
    • Default: (empty)
      •  
    • Description: An LDAP filter to select which users get synchronized into WireGuard Portal.   For example:   
      (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n
      •  
    "},{"location":"documentation/configuration/overview/#sync_log_user_info","title":"sync_log_user_info","text":"
       
    • Default: false
      •  
    • Description: If true, logs LDAP user data at the trace level during synchronization.
      •  
    "},{"location":"documentation/configuration/overview/#disable_missing","title":"disable_missing","text":"
       
    • Default: false
      •  
    • Description: If true, any user not found in LDAP (during sync) is disabled in WireGuard Portal.
      •  
    "},{"location":"documentation/configuration/overview/#auto_re_enable","title":"auto_re_enable","text":"
       
    • Default: false
      •  
    • Description: If true, users that where disabled because they were missing (see disable_missing) will be re-enabled once they are found again.
      •  
    "},{"location":"documentation/configuration/overview/#registration_enabled_2","title":"registration_enabled","text":"
       
    • Default: false
      •  
    • Description: If true, new user accounts are created in WireGuard Portal upon first login.
      •  
    "},{"location":"documentation/configuration/overview/#log_user_info_2","title":"log_user_info","text":"
       
    • Default: false
      •  
    • Description: If true, logs LDAP user data at the trace level upon login.
      •  
    "},{"location":"documentation/configuration/overview/#webauthn-passkeys","title":"WebAuthn (Passkeys)","text":"
    The webauthn section contains configuration options for WebAuthn authentication (passkeys).
    "},{"location":"documentation/configuration/overview/#enabled","title":"enabled","text":"
       
    • Default: true
      •  
    • Environment Variable: WG_PORTAL_AUTH_WEBAUTHN_ENABLED
      •  
    • Description: If true, Passkey authentication is enabled. If false, WebAuthn is disabled.   Users are encouraged to use Passkeys for secure authentication instead of passwords.    If a passkey is registered, the password login is still available as a fallback. Ensure that the password is strong and secure.
      •  
    "},{"location":"documentation/configuration/overview/#web","title":"Web","text":"
    The web section contains configuration options for the web server, including the listening address, session management, and CSRF protection. It is important to specify a valid external_url for the web server, especially if you are using a reverse proxy.  Without a valid external_url, the login process may fail due to CSRF protection.
    "},{"location":"documentation/configuration/overview/#listening_address_1","title":"listening_address","text":"
       
    • Default: :8888
      •  
    • Environment Variable: WG_PORTAL_WEB_LISTENING_ADDRESS
      •  
    • Description: The listening address and port for the web server (e.g., :8888 to bind on all interfaces or 127.0.0.1:8888 to bind only on the loopback interface).   Ensure that access to WireGuard Portal is protected against unauthorized access, especially if binding to all interfaces.
      •  
    "},{"location":"documentation/configuration/overview/#external_url","title":"external_url","text":"
       
    • Default: http://localhost:8888
      •  
    • Environment Variable: WG_PORTAL_WEB_EXTERNAL_URL
      •  
    • Description: The URL where a client can access WireGuard Portal. This URL is used for generating links in emails and for performing OAUTH redirects.   The external URL must not contain a path component or trailing slash. If you want to serve WireGuard Portal on a subpath, use the base_path setting.   Important: If you are using a reverse proxy, set this to the external URL of the reverse proxy, otherwise login will fail. If you access the portal via IP address, set this to the IP address of the server.
      •  
    "},{"location":"documentation/configuration/overview/#base_path","title":"base_path","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_WEB_BASE_PATH
      •  
    • Description: The base path for the web server (e.g., /wgportal).    By default (meaning an empty value), the portal will be served from the root path /.
      •  
    "},{"location":"documentation/configuration/overview/#site_company_name","title":"site_company_name","text":"
       
    • Default: WireGuard Portal
      •  
    • Environment Variable: WG_PORTAL_WEB_SITE_COMPANY_NAME
      •  
    • Description: The company name that is shown at the bottom of the web frontend.
      •  
    "},{"location":"documentation/configuration/overview/#site_title","title":"site_title","text":"
       
    • Default: WireGuard Portal
      •  
    • Environment Variable: WG_PORTAL_WEB_SITE_TITLE
      •  
    • Description: The title that is shown in the web frontend.
      •  
    "},{"location":"documentation/configuration/overview/#session_identifier","title":"session_identifier","text":"
       
    • Default: wgPortalSession
      •  
    • Environment Variable: WG_PORTAL_WEB_SESSION_IDENTIFIER
      •  
    • Description: The session identifier for the web frontend.
      •  
    "},{"location":"documentation/configuration/overview/#session_secret","title":"session_secret","text":"
       
    • Default: very_secret
      •  
    • Environment Variable: WG_PORTAL_WEB_SESSION_SECRET
      •  
    • Description: The session secret for the web frontend.
      •  
    "},{"location":"documentation/configuration/overview/#csrf_secret","title":"csrf_secret","text":"
       
    • Default: extremely_secret
      •  
    • Environment Variable: WG_PORTAL_WEB_CSRF_SECRET
      •  
    • Description: The CSRF secret.
      •  
    "},{"location":"documentation/configuration/overview/#request_logging","title":"request_logging","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_WEB_REQUEST_LOGGING
      •  
    • Description: Log all HTTP requests.
      •  
    "},{"location":"documentation/configuration/overview/#expose_host_info","title":"expose_host_info","text":"
       
    • Default: false
      •  
    • Environment Variable: WG_PORTAL_WEB_EXPOSE_HOST_INFO
      •  
    • Description: Expose the hostname and version of the WireGuard Portal server in an HTTP header. This is useful for debugging but may expose sensitive information.
      •  
    "},{"location":"documentation/configuration/overview/#cert_file","title":"cert_file","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_WEB_CERT_FILE
      •  
    • Description: (Optional) Path to the TLS certificate file.
      •  
    "},{"location":"documentation/configuration/overview/#key_file","title":"key_file","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_WEB_KEY_FILE
      •  
    • Description: (Optional) Path to the TLS certificate key file.
      •  
    "},{"location":"documentation/configuration/overview/#frontend_filepath","title":"frontend_filepath","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_WEB_FRONTEND_FILEPATH
      •  
    • Description: Optional base directory from which the web frontend is served. Check out the building documentation for more information on how to compile the frontend assets.
      •  
    • If the directory contains at least one file (recursively), these files are served at /app, overriding the embedded frontend assets.
      •  
    • If the directory is empty or does not exist on startup, the embedded frontend is copied into this directory automatically and then served.
      •  
    • If left empty, the embedded frontend is served and no files are written to disk.
      •  
    "},{"location":"documentation/configuration/overview/#webhook","title":"Webhook","text":"
    The webhook section allows you to configure a webhook that is called on certain events in WireGuard Portal. Further details can be found in the usage documentation.
    "},{"location":"documentation/configuration/overview/#url_1","title":"url","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_WEBHOOK_URL
      •  
    • Description: The POST endpoint to which the webhook is sent. The URL must be reachable from the WireGuard Portal server. If the URL is empty, the webhook is disabled.
      •  
    "},{"location":"documentation/configuration/overview/#authentication","title":"authentication","text":"
       
    • Default: (empty)
      •  
    • Environment Variable: WG_PORTAL_WEBHOOK_AUTHENTICATION
      •  
    • Description: The Authorization header for the webhook endpoint. The value is send as-is in the header. For example: Bearer <token>.
      •  
    "},{"location":"documentation/configuration/overview/#timeout","title":"timeout","text":"
       
    • Default: 10s
      •  
    • Environment Variable: WG_PORTAL_WEBHOOK_TIMEOUT
      •  
    • Description: The timeout for the webhook request. If the request takes longer than this, it is aborted.
      •  
    "},{"location":"documentation/getting-started/binaries/","title":"Binaries","text":"
    Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
    "},{"location":"documentation/getting-started/binaries/#download","title":"Download","text":"
    Make sure that you download the correct binary for your architecture. The available binaries are:
     
       
    • wg-portal_linux_amd64 - Linux x86_64
      •  
    • wg-portal_linux_arm64 - Linux ARM 64-bit
      •  
    • wg-portal_linux_arm_v7 - Linux ARM 32-bit
      •  
    "},{"location":"documentation/getting-started/binaries/#released-versions","title":"Released versions","text":"
    To download a specific version, replace ${WG_PORTAL_VERSION} with the desired version (or set an environment variable).  All official release versions can be found on the GitHub Releases Page.
     
    With curl:
     
    curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 \n
     
    With wget:
     
    wget -O wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64\n
     
    with gh cli:
     
    gh release download ${WG_PORTAL_VERSION} --repo h44z/wg-portal --output wg-portal --pattern '*amd64'\n
     
    The downloaded file will be named wg-portal and can be moved to a directory of your choice, see Install for more information.
    "},{"location":"documentation/getting-started/binaries/#unreleased-versions-master-branch-builds","title":"Unreleased versions (master branch builds)","text":"
    Unreleased versions can be fetched directly from the artifacts section of the GitHub Workflow.
    "},{"location":"documentation/getting-started/binaries/#install","title":"Install","text":"
    The following command can be used to install the downloaded binary (wg-portal) to /opt/wg-portal/wg-portal. It ensures that the binary is executable.
     
    sudo mkdir -p /opt/wg-portal\nsudo install wg-portal /opt/wg-portal/\n
     
    To handle tasks such as restarting the service or configuring automatic startup, it is recommended to use a process manager like systemd.  Refer to Systemd Service Setup for instructions.
    "},{"location":"documentation/getting-started/binaries/#systemd-service-setup","title":"Systemd Service Setup","text":"
    Note: To run WireGuard Portal as systemd service, you need to download the binary for your architecture beforehand.
     
    The following examples assume that you downloaded the binary to /opt/wg-portal/wg-portal.  The configuration file is expected to be located at /opt/wg-portal/config.yml.
     
    To run WireGuard Portal as a systemd service, you can create a service unit file. The easiest way to do this is by using systemctl edit:
     
    sudo systemctl edit --force --full wg-portal.service\n
     
    Paste the following content into the editor and adjust the variables to your needs:
     
    [Unit]\nDescription=WireGuard Portal\nConditionPathExists=/opt/wg-portal/wg-portal\nAfter=network.target\n\n[Service]\nType=simple\nUser=root\nGroup=root\nAmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW\n\nRestart=on-failure\nRestartSec=10\n\nWorkingDirectory=/opt/wg-portal\nEnvironment=WG_PORTAL_CONFIG=/opt/wg-portal/config.yml\nExecStart=/opt/wg-portal/wg-portal\n\n[Install]\nWantedBy=multi-user.target\n
     
    Alternatively, you can create or modify the file manually in /etc/systemd/system/wg-portal.service.  For systemd to pick up the changes, you need to reload the daemon:
     
    sudo systemctl daemon-reload\n
     
    After creating the service file, you can enable and start the service:
     
    sudo systemctl enable --now wg-portal.service\n
     
    To check status and log output, use: sudo systemctl status wg-portal.service or sudo journalctl -u wg-portal.service.
    "},{"location":"documentation/getting-started/docker/","title":"Docker","text":""},{"location":"documentation/getting-started/docker/#image-usage","title":"Image Usage","text":"
    The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
     
    This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
     
    The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
     
    A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
     
    ---\nservices:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    # Use host network mode for WireGuard and the UI. Ensure that access to the UI is properly secured.\n    network_mode: \"host\"\n    volumes:\n      # left side is the host path, right side is the container path\n      - /etc/wireguard:/etc/wireguard\n      - ./data:/app/data\n      - ./config:/app/config\n
     
    By default, the webserver for the UI is listening on port 8888 on all available interfaces.
     
    Volumes for /app/data and /app/config should be used ensure data persistence across container restarts.
    "},{"location":"documentation/getting-started/docker/#wireguard-interface-handling","title":"WireGuard Interface Handling","text":"
    WireGuard Portal supports managing WireGuard interfaces through three distinct deployment methods, providing flexibility based on your system architecture and operational preferences:
     
       
    •  
      Directly on the host system:     WireGuard Portal can control WireGuard interfaces natively on the host, without using containers.     This setup is ideal for environments where direct access to system networking is preferred.    To use this method, you need to set the network mode to host in your docker-compose.yml file.    
      services:\n  wg-portal:\n    ...\n    network_mode: \"host\"\n    ...\n
       
       If host networking is used, the WireGuard Portal UI will be accessible on all the host's IP addresses if the listening address is set to :8888 in the configuration file.    To avoid this, you can bind the listening address to a specific IP address, for example, the loopback address (127.0.0.1:8888). It is also possible to deploy firewall rules to restrict access to the WireGuard Portal UI.
       
      •  
    •  
      Within the WireGuard Portal Docker container:     WireGuard interfaces can be managed directly from within the WireGuard Portal container itself.    This is the recommended approach when running WireGuard Portal via Docker, as it encapsulates all functionality in a single, portable container without requiring a separate WireGuard host or image.    
      services:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\" \n      # Web UI port\n      - \"8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      # host path : container path\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n
       
      •  
    •  
      Via a separate Docker container:     WireGuard Portal can interface with and control WireGuard running in another Docker container, such as the linuxserver/wireguard image.    This method is useful in setups that already use linuxserver/wireguard or where you want to isolate the VPN backend from the portal frontend.    For this, you need to set the network mode to service:wireguard in your docker-compose.yml file, wireguard is the service name of your WireGuard container.    
      services:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    network_mode: \"service:wireguard\" # So we ensure to stay on the same network as the wireguard container.\n    volumes:\n      # host path : container path\n      - ./wg/etc:/etc/wireguard\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n\n  wireguard:\n    image: lscr.io/linuxserver/wireguard:latest\n    container_name: wireguard\n    restart: unless-stopped\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      - \"51820:51820/udp\" # WireGuard port, needs to match the port in wg-portal interface config\n      - \"8888:8888/tcp\" # Noticed that the port of the web UI is exposed in the wireguard container.\n    volumes:\n      - ./wg/etc:/config/wg_confs # We share the configuration (wgx.conf) between wg-portal and wireguard\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n
          As the linuxserver/wireguard image uses wg-quick to manage the interfaces, you need to have at least the following configuration set for WireGuard Portal:    
      core:\n  # The WireGuard container uses wg-quick to manage the WireGuard interfaces - this conflicts with WireGuard Portal during startup.\n  # To avoid this, we need to set the restore_state option to false so that wg-quick can create the interfaces.\n  restore_state: false\n  # Usually, there are no existing interfaces in the WireGuard container, so we can set this to false.\n  import_existing: false\nadvanced:\n  # WireGuard Portal needs to export the WireGuard configuration as wg-quick config files so that the WireGuard container can use them.\n  config_storage_path: /etc/wireguard/\n
       
      •  
    "},{"location":"documentation/getting-started/docker/#image-versioning","title":"Image Versioning","text":"
    All images are hosted on Docker Hub at https://hub.docker.com/r/wgportal/wg-portal or in the GitHub Container Registry.
     
    Version 2 is the current stable release. Version 1 has moved to legacy status and is no longer recommended.
     
    There are three types of tags in the repository:
    "},{"location":"documentation/getting-started/docker/#semantic-versioned-tags","title":"Semantic versioned tags","text":"
    For example, 2.0.0-rc.1 or v2.0.0-rc.1.
     
    These are official releases of WireGuard Portal. For production deployments of WireGuard Portal, we strongly recommend using one of these versioned tags instead of the latest or canary tags.
     
    There are different types of these tags:
     
       
    • Major version tags: v2 or 2. These tags always refer to the latest image for WireGuard Portal version 2.
      •  
    • Minor version tags: v2.x or 2.0. These tags always refer to the latest image for WireGuard Portal version 2.x.
      •  
    • Specific version tags (patch version): v2.0.0 or 2.0.0. These tags denote a very specific release. They correspond to the GitHub tags that we make, and you can see the release notes for them here: https://github.com/h44z/wg-portal/releases. Once these tags for a specific version show up in the Docker repository, they will never change. 
      •  
    "},{"location":"documentation/getting-started/docker/#the-latest-tag","title":"The latest tag","text":"
    The lastest tag is the latest stable release of WireGuard Portal. For version 2, this is the same as the v2 tag.
    "},{"location":"documentation/getting-started/docker/#the-master-tag","title":"The master tag","text":"
    This is the most recent build to the main branch! It changes a lot and is very unstable.
     
    We recommend that you don't use it except for development purposes or to test the latest features.
    "},{"location":"documentation/getting-started/docker/#configuration","title":"Configuration","text":"
    You can configure WireGuard Portal using a YAML configuration file. The filepath of the YAML configuration file defaults to /app/config/config.yaml. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG.
     
    By default, WireGuard Portal uses an SQLite database. The database is stored in /app/data/sqlite.db.
     
    You should mount those directories as a volume:
     
       
    • /app/data
      •  
    • /app/config
      •  
     
    A detailed description of the configuration options can be found here.
     
    If you want to access configuration files in wg-quick format, you can mount the /etc/wireguard directory inside the container to a location of your choice. Also enable the config_storage_path option in the configuration file: 
    advanced:\n  config_storage_path: /etc/wireguard\n
    "},{"location":"documentation/getting-started/helm/","title":"Helm","text":""},{"location":"documentation/getting-started/helm/#installing-the-chart","title":"Installing the Chart","text":"
    To install the chart with the release name wg-portal:
     
    helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal\n
     
    This command deploy wg-portal on the Kubernetes cluster in the default configuration. The Values section lists the parameters that can be configured during installation.
    "},{"location":"documentation/getting-started/helm/#values","title":"Values","text":"Key Type Default Description nameOverride string \"\" Partially override resource names (adds suffix) fullnameOverride string \"\" Fully override resource names extraDeploy list [] Array of extra objects to deploy with the release config.advanced tpl/object {} Advanced configuration options. config.auth tpl/object {} Auth configuration options. config.core tpl/object {} Core configuration options. If external admins in auth are defined and there are no admin_user and admin_password defined here, the default admin account will be disabled. config.database tpl/object {} Database configuration options config.mail tpl/object {} Mail configuration options config.statistics tpl/object {} Statistics configuration options config.web tpl/object {} Web configuration options. listening_address will be set automatically from service.web.port. external_url is required to enable ingress and certificate resources. revisionHistoryLimit string 10 The number of old ReplicaSets to retain to allow rollback. workloadType string \"Deployment\" Workload type - Deployment or StatefulSet strategy object {\"type\":\"RollingUpdate\"} Update strategy for the workload Valid values are:  RollingUpdate or Recreate for Deployment,  RollingUpdate or OnDelete for StatefulSet image.repository string \"ghcr.io/h44z/wg-portal\" Image repository image.pullPolicy string \"IfNotPresent\" Image pull policy image.tag string \"\" Overrides the image tag whose default is the chart appVersion imagePullSecrets list [] Image pull secrets podAnnotations tpl/object {} Extra annotations to add to the pod podLabels object {} Extra labels to add to the pod podSecurityContext object {} Pod Security Context securityContext.capabilities.add list [\"NET_ADMIN\"] Add capabilities to the container initContainers tpl/list [] Pod init containers sidecarContainers tpl/list [] Pod sidecar containers dnsPolicy string \"ClusterFirst\" Set DNS policy for the pod. Valid values are ClusterFirstWithHostNet, ClusterFirst, Default or None. restartPolicy string \"Always\" Restart policy for all containers within the pod. Valid values are Always, OnFailure or Never. hostNetwork string false. Use the host's network namespace. resources object {} Resources requests and limits command list [] Overwrite pod command args list [] Additional pod arguments env tpl/list [] Additional environment variables envFrom tpl/list [] Additional environment variables from a secret or configMap livenessProbe object {} Liveness probe configuration readinessProbe object {} Readiness probe configuration startupProbe object {} Startup probe configuration volumes tpl/list [] Additional volumes volumeMounts tpl/list [] Additional volumeMounts nodeSelector object {\"kubernetes.io/os\":\"linux\"} Node Selector configuration tolerations list [] Tolerations configuration affinity object {} Affinity configuration service.mixed.enabled bool false Whether to create a single service for the web and wireguard interfaces service.mixed.type string \"LoadBalancer\" Service type service.web.annotations object {} Annotations for the web service service.web.type string \"ClusterIP\" Web service type service.web.port int 8888 Web service port Used for the web interface listener service.web.appProtocol string \"http\" Web service appProtocol. Will be auto set to https if certificate is enabled. service.wireguard.annotations object {} Annotations for the WireGuard service service.wireguard.type string \"LoadBalancer\" Wireguard service type service.wireguard.ports list [51820] Wireguard service ports. Exposes the WireGuard ports for created interfaces. Lowerest port is selected as start port for the first interface. Increment next port by 1 for each additional interface. service.metrics.port int 8787 ingress.enabled bool false Specifies whether an ingress resource should be created ingress.className string \"\" Ingress class name ingress.annotations object {} Ingress annotations ingress.tls bool false Ingress TLS configuration. Enable certificate resource or add ingress annotation to create required secret certificate.enabled bool false Specifies whether a certificate resource should be created. If enabled, certificate will be used for the web. certificate.issuer.name string \"\" Certificate issuer name certificate.issuer.kind string \"\" Certificate issuer kind (ClusterIssuer or Issuer) certificate.issuer.group string \"cert-manager.io\" Certificate issuer group certificate.duration string \"\" Optional. Documentation certificate.renewBefore string \"\" Optional. Documentation certificate.commonName string \"\" Optional. Documentation certificate.emailAddresses list [] Optional. Documentation certificate.ipAddresses list [] Optional. Documentation certificate.keystores object {} Optional. Documentation certificate.privateKey object {} Optional. Documentation certificate.secretTemplate object {} Optional. Documentation certificate.subject object {} Optional. Documentation certificate.uris list [] Optional. Documentation certificate.usages list [] Optional. Documentation persistence.enabled bool false Specifies whether an persistent volume should be created persistence.annotations object {} Persistent Volume Claim annotations persistence.storageClass string \"\" Persistent Volume storage class. If undefined (the default) cluster's default provisioner will be used. persistence.accessMode string \"ReadWriteOnce\" Persistent Volume Access Mode persistence.size string \"1Gi\" Persistent Volume size persistence.volumeName string \"\" Persistent Volume Name (optional) serviceAccount.create bool true Specifies whether a service account should be created serviceAccount.annotations object {} Service account annotations serviceAccount.automount bool false Automatically mount a ServiceAccount's API credentials serviceAccount.name string \"\" The name of the service account to use. If not set and create is true, a name is generated using the fullname template monitoring.enabled bool false Enable Prometheus monitoring. monitoring.apiVersion string \"monitoring.coreos.com/v1\" API version of the Prometheus resource. Use azmonitoring.coreos.com/v1 for Azure Managed Prometheus. monitoring.kind string \"PodMonitor\" Kind of the Prometheus resource. Could be PodMonitor or ServiceMonitor. monitoring.labels object {} Resource labels. monitoring.annotations object {} Resource annotations. monitoring.interval string 1m Interval at which metrics should be scraped. If not specified config.statistics.data_collection_interval interval is used. monitoring.metricRelabelings list [] Relabelings to samples before ingestion. monitoring.relabelings list [] Relabelings to samples before scraping. monitoring.scrapeTimeout string \"\" Timeout after which the scrape is ended If not specified, the Prometheus global scrape interval is used. monitoring.jobLabel string \"\" The label to use to retrieve the job name from. monitoring.podTargetLabels object {} Transfers labels on the Kubernetes Pod onto the target. monitoring.dashboard.enabled bool false Enable Grafana dashboard. monitoring.dashboard.annotations object {} Annotations for the dashboard ConfigMap. monitoring.dashboard.labels object {} Additional labels for the dashboard ConfigMap. monitoring.dashboard.namespace string \"\" Dashboard ConfigMap namespace Overrides the namespace for the dashboard ConfigMap."},{"location":"documentation/getting-started/reverse-proxy/","title":"Reverse Proxy (HTTPS)","text":""},{"location":"documentation/getting-started/reverse-proxy/#reverse-proxy-for-https","title":"Reverse Proxy for HTTPS","text":"
    For production deployments, always serve the WireGuard Portal over HTTPS. You have two options to secure your connection:
    "},{"location":"documentation/getting-started/reverse-proxy/#reverse-proxy","title":"Reverse Proxy","text":"
    Let a front\u2010end proxy handle HTTPS for you. This also frees you from managing certificates manually and is therefore the preferred option. You can use Nginx, Traefik, Caddy or any other proxy. 
     
    Below is an example using a Docker Compose stack with Traefik.  It exposes the WireGuard Portal on https://wg.domain.com and redirects initial HTTP traffic to HTTPS.
     
    services:\n  reverse-proxy:\n    image: traefik:v3.3\n    restart: unless-stopped\n    command:\n      #- '--log.level=DEBUG'\n      - '--providers.docker.endpoint=unix:///var/run/docker.sock'\n      - '--providers.docker.exposedbydefault=false'\n      - '--entrypoints.web.address=:80'\n      - '--entrypoints.websecure.address=:443'\n      - '--entrypoints.websecure.http3'\n      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge=true'\n      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge.entrypoint=web'\n      - '--certificatesresolvers.letsencryptresolver.acme.email=your.email@domain.com'\n      - '--certificatesresolvers.letsencryptresolver.acme.storage=/letsencrypt/acme.json'\n      #- '--certificatesresolvers.letsencryptresolver.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory'  # just for testing\n    ports:\n      - 80:80 # for HTTP\n      - 443:443/tcp  # for HTTPS\n      - 443:443/udp  # for HTTP/3\n    volumes:\n      - acme-certs:/letsencrypt\n      - /var/run/docker.sock:/var/run/docker.sock:ro\n    labels:\n      - 'traefik.enable=true'\n      # HTTP Catchall for redirecting HTTP -> HTTPS\n      - 'traefik.http.routers.dashboard-catchall.rule=Host(`wg.domain.com`) && PathPrefix(`/`)'\n      - 'traefik.http.routers.dashboard-catchall.entrypoints=web'\n      - 'traefik.http.routers.dashboard-catchall.middlewares=redirect-to-https'\n      - 'traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https'\n\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\"\n      # Web UI port (only available on localhost, Traefik will handle the HTTPS)\n      - \"127.0.0.1:8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      # host path : container path\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n    labels:\n      - 'traefik.enable=true'\n      - 'traefik.http.routers.wgportal.rule=Host(`wg.domain.com`)'\n      - 'traefik.http.routers.wgportal.entrypoints=websecure'\n      - 'traefik.http.routers.wgportal.tls.certresolver=letsencryptresolver'\n      - 'traefik.http.routers.wgportal.service=wgportal'\n      - 'traefik.http.services.wgportal.loadbalancer.server.port=8888'\n\nvolumes:\n  acme-certs:\n
     
    The WireGuard Portal configuration must be updated accordingly so that the correct external URL is set for the web interface:
     
    web:\n  external_url: https://wg.domain.com\n
     
    If you want to serve the web interface on a different base-path, you can also set the web.base_path option:
     
    web:\n  external_url: https://wg.domain.com\n  base_path: /subpath\n
     
    The WireGuard Portal will then be available at https://wg.domain.com/subpath.
    "},{"location":"documentation/getting-started/reverse-proxy/#built-in-tls","title":"Built-in TLS","text":"
    If you prefer to let WireGuard Portal handle TLS itself, you can use the built-in TLS support. In your config.yaml, under the web section, point to your certificate and key files:
     
    web:\n  cert_file: /path/to/your/fullchain.pem\n  key_file:  /path/to/your/privkey.pem\n
     
    The web server will then use these files to serve HTTPS traffic directly instead of HTTP.
    "},{"location":"documentation/getting-started/sources/","title":"Sources","text":"
    To build the application from source files, use the Makefile provided in the repository.
    "},{"location":"documentation/getting-started/sources/#requirements","title":"Requirements","text":"
       
    • Git
      •  
    • Make
      •  
    • Go: >=1.24.0
      •  
    • Node.js with npm: node>=18, npm>=9
      •  
    "},{"location":"documentation/getting-started/sources/#build","title":"Build","text":"
    # Get source code\ngit clone https://github.com/h44z/wg-portal -b ${WG_PORTAL_VERSION:-master} --depth 1\ncd wg-portal\n# Build the frontend\nmake frontend\n# Build the backend\nmake build\n
    "},{"location":"documentation/getting-started/sources/#install","title":"Install","text":"
    Compiled binary will be available in ./dist directory. 
     
    For installation instructions, check the Binaries section.
    "},{"location":"documentation/monitoring/prometheus/","title":"Monitoring","text":"
    By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
    "},{"location":"documentation/monitoring/prometheus/#exposed-metrics","title":"Exposed Metrics","text":"Metric Type Description wireguard_interface_received_bytes_total gauge Bytes received through the interface. wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. wireguard_peer_received_bytes_total gauge Bytes received from the peer. wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. wireguard_peer_up gauge Peer connection state (boolean: 1/0)."},{"location":"documentation/monitoring/prometheus/#prometheus-config","title":"Prometheus Config","text":"
    Add the following scrape job to your Prometheus config file:
     
    # prometheus.yaml\nscrape_configs:\n  - job_name: wg-portal\n    scrape_interval: 60s\n    static_configs:\n      - targets:\n          - localhost:8787 # Change localhost to IP Address or hostname with WG-Portal\n
    "},{"location":"documentation/monitoring/prometheus/#grafana-dashboard","title":"Grafana Dashboard","text":"
    You may import dashboard.json into your Grafana instance.
     
    "},{"location":"documentation/rest-api/api-doc/","title":"REST API","text":""},{"location":"documentation/upgrade/v1/","title":"Upgrade","text":"
    Major upgrades between different versions may require special procedures, which are described in the following sections.
    "},{"location":"documentation/upgrade/v1/#upgrade-from-v1-to-v2","title":"Upgrade from v1 to v2","text":"
     Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
     
    To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yaml) for WireGuard Portal must be updated and valid before starting the upgrade.
     
    To upgrade from a previous SQLite database, start wg-portal like:
     
    ./wg-portal-amd64 -migrateFrom=old_wg_portal.db\n
     
    You can also specify the database type using the parameter -migrateFromType.  Supported database types: mysql, mssql, postgres or sqlite.
     
    For example:
     
    ./wg-portal-amd64 -migrateFromType=mysql -migrateFrom='user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local'\n
     
    The upgrade will transform the old, existing database and store the values in the new database specified in the config.yaml configuration file. Ensure that the new database does not contain any data!
     
    If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
     
    services:\n  wg-portal:\n    image: wgportal/wg-portal:v2\n    # ... other settings\n    restart: no\n    command: [\"-migrateFrom=/app/data/old_wg_portal.db\"]\n
    "},{"location":"documentation/usage/authentication/","title":"Authentication","text":"
    WireGuard Portal supports multiple authentication mechanisms to manage user access. This includes
     
       
    • Local user accounts
      •  
    • LDAP authentication
      •  
    • OAuth2 and OIDC authentication
      •  
    • Passkey authentication (WebAuthn)
      •  
     
    Users can have two roles which limit their permissions in WireGuard Portal:
     
       
    • User: Can manage their own account and peers.
      •  
    • Admin: Can manage all users and peers, including the ability to manage WireGuard interfaces.
      •  
     
    In general, each user is identified by a unique identifier. If the same user identifier exists across multiple authentication sources, WireGuard Portal automatically merges those accounts into a single user record. When a user is associated with multiple authentication sources, their information in WireGuard Portal is updated based on the most recently logged-in source. For more details, see User Synchronization documentation.
    "},{"location":"documentation/usage/authentication/#password-authentication","title":"Password Authentication","text":"
    WireGuard Portal supports username and password authentication for both local and LDAP-backed accounts. Local users are stored in the database, while LDAP users are authenticated against an external LDAP server.
     
    On initial startup, WireGuard Portal automatically creates a local admin account with the password wgportal-default.
     
     This password must be changed immediately after the first login.
     
    The minimum password length for all local users can be configured in the auth section of the configuration file. The default value is 16 characters, see min_password_length. The minimum password length is also enforced for the default admin user.
    "},{"location":"documentation/usage/authentication/#passkey-webauthn-authentication","title":"Passkey (WebAuthn) Authentication","text":"
    Besides the standard authentication mechanisms, WireGuard Portal supports Passkey authentication. This feature is enabled by default and can be configured in the webauthn section of the configuration file.
     
    Users can register multiple Passkeys to their account. These Passkeys can be used to log in to the web UI as long as the user is not locked.
     
     Passkey authentication does not disable password authentication. The password can still be used to log in (e.g., as a fallback).
     
    To register a Passkey, open the settings page (1) in the web UI and click on the \"Register Passkey\" (2) button.
     
    "},{"location":"documentation/usage/authentication/#oauth2-and-oidc-authentication","title":"OAuth2 and OIDC Authentication","text":"
    WireGuard Portal supports OAuth2 and OIDC authentication. You can use any OAuth2 or OIDC provider that supports the authorization code flow, such as Google, GitHub, or Keycloak.
     
    For OAuth2 or OIDC to work, you need to configure the external_url property in the web section of the configuration file. If you are planning to expose the portal to the internet, make sure that the external_url is configured to use HTTPS.
     
    To add OIDC or OAuth2 authentication to WireGuard Portal, create a Client-ID and Client-Secret in your OAuth2 provider and configure a new authentication provider in the auth section of the configuration file. Make sure that each configured provider has a unique provider_name property set. Samples can be seen here.
    "},{"location":"documentation/usage/authentication/#limiting-login-to-specific-domains","title":"Limiting Login to Specific Domains","text":"
    You can limit the login to specific domains by setting the allowed_domains property for OAuth2 or OIDC providers. This property is a comma-separated list of domains that are allowed to log in. The user's email address is checked against this list. For example, if you want to allow only users with an email address ending in outlook.com to log in, set the property as follows:
     
    auth:\n  oidc:\n    - provider_name: \"oidc1\"\n      # ... other settings\n      allowed_domains:\n        - \"outlook.com\"\n
    "},{"location":"documentation/usage/authentication/#limit-login-to-existing-users","title":"Limit Login to Existing Users","text":"
    You can limit the login to existing users only by setting the registration_enabled property to false for OAuth2 or OIDC providers. If registration is enabled, new users will be created in the database when they log in for the first time.
    "},{"location":"documentation/usage/authentication/#admin-mapping","title":"Admin Mapping","text":"
    You can map users to admin roles based on their attributes in the OAuth2 or OIDC provider. To do this, set the admin_mapping property for the provider. Administrative access can either be mapped by a specific attribute or by group membership.
     
    Attribute specific mapping can be achieved by setting the admin_value_regex and the is_admin property. The admin_value_regex property is a regular expression that is matched against the value of the is_admin attribute. The user is granted admin access if the regex matches the attribute value.
     
    Example: 
    auth:\n  oidc:\n    - provider_name: \"oidc1\"\n      # ... other settings\n      field_map:\n        is_admin: \"wg_admin_prop\"\n      admin_mapping:\n        admin_value_regex: \"^true$\"\n
     The example above will grant admin access to users with the wg_admin_prop attribute set to true.
     
    Group membership mapping can be achieved by setting the admin_group_regex and user_groups property. The admin_group_regex property is a regular expression that is matched against the group names of the user. The user is granted admin access if the regex matches any of the group names.
     
    Example: 
    auth:\n  oidc:\n    - provider_name: \"oidc1\"\n      # ... other settings\n      field_map:\n        user_groups: \"groups\"\n      admin_mapping:\n        admin_group_regex: \"^the-admin-group$\"\n
     The example above will grant admin access to users who are members of the the-admin-group group.
    "},{"location":"documentation/usage/authentication/#ldap-authentication","title":"LDAP Authentication","text":"
    WireGuard Portal supports LDAP authentication. You can use any LDAP server that supports the LDAP protocol, such as Active Directory or OpenLDAP. Multiple LDAP servers can be configured in the auth section of the configuration file. WireGuard Portal remembers the authentication provider of the user and therefore avoids conflicts between multiple LDAP providers.
     
    To configure LDAP authentication, create a new ldap authentication provider in the auth section of the configuration file.
    "},{"location":"documentation/usage/authentication/#limiting-login-to-specific-users","title":"Limiting Login to Specific Users","text":"
    You can limit the login to specific users by setting the login_filter property for LDAP provider. This filter uses the LDAP search filter syntax. The username can be inserted into the query by placing the {{login_identifier}} placeholder in the filter. This placeholder will then be replaced with the username entered by the user during login.
     
    For example, if you want to allow only users with the objectClass attribute set to organizationalPerson to log in, set the property as follows:
     
    auth:\n  ldap:\n    - provider_name: \"ldap1\"\n      # ... other settings\n      login_filter: \"(&(objectClass=organizationalPerson)(uid={{login_identifier}}))\"\n
     
    The login_filter should always be designed to return at most one user.
    "},{"location":"documentation/usage/authentication/#limit-login-to-existing-users_1","title":"Limit Login to Existing Users","text":"
    You can limit the login to existing users only by setting the registration_enabled property to false for LDAP providers. If registration is enabled, new users will be created in the database when they log in for the first time.
    "},{"location":"documentation/usage/authentication/#admin-mapping_1","title":"Admin Mapping","text":"
    You can map users to admin roles based on their group membership in the LDAP server. To do this, set the admin_group and memberof property for the provider. The admin_group property defines the distinguished name of the group that is allowed to log in as admin. All groups that are listed in the memberof attribute of the user will be checked against this group. If one of the groups matches, the user is granted admin access.
    "},{"location":"documentation/usage/authentication/#user-synchronization","title":"User Synchronization","text":""},{"location":"documentation/usage/backends/","title":"Backends","text":"
    WireGuard Portal can manage WireGuard interfaces and peers on different backends.  Each backend represents a system where interfaces actually live.  You can register multiple backends and choose which one to use per interface.  A global default backend determines where newly created interfaces go (unless you explicitly choose another in the UI).
     
    Supported backends: - Local (default): Manages interfaces on the host running WireGuard Portal (Linux WireGuard via wgctrl). Use this when the portal should directly configure wg devices on the same server. - MikroTik RouterOS (beta): Manages interfaces and peers on MikroTik devices via the RouterOS REST API. Use this to control WG interfaces on RouterOS v7+. - pfSense (alpha): Manages interfaces and peers on pfSense firewalls via the pfSense REST API.
     
    How backend selection works: - The default backend is configured at backend.default (local or the id of a defined MikroTik backend).    New interfaces created in the UI will use this backend by default. - Each interface stores its backend. You can select a different backend when creating a new interface.
    "},{"location":"documentation/usage/backends/#configuring-mikrotik-backends-routeros-v7","title":"Configuring MikroTik backends (RouterOS v7+)","text":"
     The MikroTik backend is currently marked beta. While basic functionality is implemented, some advanced features are not yet implemented or contain bugs. Please test carefully before using in production.
     
    The MikroTik backend uses the REST API under a base URL ending with /rest.  You can register one or more MikroTik devices as backends for a single WireGuard Portal instance.
    "},{"location":"documentation/usage/backends/#prerequisites-on-mikrotik","title":"Prerequisites on MikroTik:","text":"
       
    • RouterOS v7 with WireGuard support.
      •  
    • REST API enabled and reachable over HTTP(S). A typical base URL is https://:8729/rest or https:///rest depending on your service setup. 
    • A dedicated RouterOS user with the following group permissions:
      •  
    • api (for logging in via REST API)
      •  
    • rest-api (for logging in via REST API)
      •  
    • read (to read interface and peer data)
      •  
    • write (to create/update interfaces and peers)
      •  
    • test (to perform ping checks)
      •  
    • sensitive (to read private keys)
      •  
    • TLS certificate on the device is recommended. If you use a self-signed certificate during testing, set api_verify_tls: false in wg-portal (not recommended for production).
      •  
      Example WireGuard Portal configuration (config/config.yaml):
       
      backend:\n  # default backend decides where new interfaces are created\n  default: mikrotik-prod\n\n  mikrotik:\n    - id: mikrotik-prod              # unique id, not \"local\"\n      display_name: RouterOS RB5009  # optional nice name\n      api_url: https://10.10.10.10/rest\n      api_user: wgportal\n      api_password: a-super-secret-password\n      api_verify_tls: true         # set to false only if using self-signed during testing\n      api_timeout: 30s             # maximum request duration\n      concurrency: 5               # limit parallel REST calls to device\n      debug: false                 # verbose logging for this backend\n
      "},{"location":"documentation/usage/backends/#known-limitations","title":"Known limitations:","text":"
         
      • The MikroTik backend is still in beta. Some features may not work as expected.
        •  
      • Not all WireGuard Portal features are supported yet (e.g., no support for interface hooks)
        •  
      "},{"location":"documentation/usage/backends/#configuring-pfsense-backends","title":"Configuring pfSense backends","text":"
       The pfSense backend is currently alpha. Only basic interface and peer CRUD are supported. Traffic statistics (rx/tx, last handshake) are not exposed by the pfSense REST API and will show as empty.
       
      The pfSense backend talks to the pfSense REST API (pfSense Plus / CE with the REST API package installed). Point the backend at the appliance hostname without appending /api/v2 \u2014 the portal appends /api/v2 automatically.
      "},{"location":"documentation/usage/backends/#prerequisites-on-pfsense","title":"Prerequisites on pfSense:","text":"
         
      • pfSense with the REST API package enabled (System -> API) and WireGuard configured.
        •  
      • An API key with permissions for WireGuard endpoints. If you use a read-only key, set core.restore_state: false in config.yml to avoid write attempts at startup.
        •  
      • HTTPS recommended; set api_verify_tls: false only for lab/self-signed setups.
        •  
       
      Example WireGuard Portal configuration:
       
      backend:\n  # default backend decides where new interfaces are created\n  default: pfsense1\n\n  pfsense:\n    - id: pfsense1                 # unique id, not \"local\"\n      display_name: Main pfSense   # optional nice name\n      api_url: https://pfsense.example.com  # no trailing /api/v2\n      api_key: your-api-key\n      api_verify_tls: true\n      api_timeout: 30s\n      concurrency: 5\n      debug: false\n
      "},{"location":"documentation/usage/backends/#known-limitations_1","title":"Known limitations:","text":"
         
      • Alpha quality: behavior and API coverage may change.
        •  
      • Statistics (rx/tx bytes, last handshake) are not available from the pfSense REST API today.
        •  
      "},{"location":"documentation/usage/general/","title":"General","text":"
      This documentation section describes the general usage of WireGuard Portal.  If you are looking for specific setup instructions, please refer to the Getting Started and Configuration sections,  for example, using a Docker deployment.
      "},{"location":"documentation/usage/general/#basic-concepts","title":"Basic Concepts","text":"
      WireGuard Portal is a web-based configuration portal for WireGuard server management. It allows managing multiple WireGuard interfaces and users from a single web UI. WireGuard Interfaces can be categorized into three types:
       
         
      • Server: A WireGuard server interface that to which multiple peers can connect. In this mode, it is possible to specify default settings for all peers, such as the IP address range, DNS servers, and MTU size.
        •  
      • Client: A WireGuard client interface that can be used to connect to a WireGuard server. Usually, such an interface has exactly one peer.
        •  
      • Unknown: This is the default type for imported interfaces. It is encouraged to change the type to either Server or Client after importing the interface. 
        •  
      "},{"location":"documentation/usage/general/#accessing-the-web-ui","title":"Accessing the Web UI","text":"
      The web UI should be accessed via the URL specified in the external_url property of the configuration file. By default, WireGuard Portal listens on port 8888 for HTTP connections. Check the Security or Authentication sections for more information on securing the web UI.
       
      So the default URL to access the web UI is:
       
      http://localhost:8888\n
       
      A freshly set-up WireGuard Portal instance will have a default admin user with the username admin@wgportal.local and the password wgportal-default.  You can and should override the default credentials in the configuration file. Make sure to change the default password immediately after the first login!
      "},{"location":"documentation/usage/general/#basic-ui-description","title":"Basic UI Description","text":"
      As seen in the screenshot above, the web UI is divided into several sections which are accessible via the navigation bar on the top of the screen.
       
         
      1. Home: The landing page of WireGuard Portal. It provides a staring point for the user to access the different sections of the web UI. It also provides quick links to WireGuard Client downloads or official documentation.
        2.  
      2. Interfaces: This section allows you to manage the WireGuard interfaces. You can add, edit, or delete interfaces, as well as view their status and statistics. Peers for each interface can be managed here as well.
        3.  
      3. Users: This section allows you to manage the users of WireGuard Portal. You can add, edit, or delete users, as well as view their status and statistics.
        4.  
      4. Key Generator: This section allows you to generate WireGuard keys locally on your browser. The generated keys are never sent to the server. This is useful if you want to generate keys for a new peer without having to store the private keys in the database.
        5.  
      5. Profile / Settings: This section allows you to access your own profile page, settings, and audit logs. 
        6.  
      "},{"location":"documentation/usage/general/#interface-view","title":"Interface View","text":"
      The interface view provides an overview of the WireGuard interfaces and peers configured in WireGuard Portal.
       
      The most important elements are:
       
         
      1. Interface Selector: This dropdown allows you to select the WireGuard interface you want to manage.     All further actions will be performed on the selected interface.
        2.  
      2. Create new Interface: This button allows you to create a new WireGuard interface.
        3.  
      3. Interface Overview: This section provides an overview of the selected WireGuard interface. It shows the interface type, number of peers, and other important information.
        4.  
      4. List of Peers: This section provides a list of all peers associated with the selected WireGuard interface. You can view, add, edit, or delete peers from this list.
        5.  
      5. Add new Peer: This button allows you to add a new peer to the selected WireGuard interface.
        6.  
      6. Add multiple Peers: This button allows you to add multiple peers to the selected WireGuard interface.     This is useful if you want to add a large number of peers at once.
        7.  
      "},{"location":"documentation/usage/mail-templates/","title":"Mail Templates","text":"
      WireGuard Portal sends emails when you share a configuration with a user.  By default, the application uses embedded templates. You can fully customize these emails by pointing the Portal  to a folder containing your own templates. If the folder is empty on startup, the default embedded templates  are written there to get you started.
      "},{"location":"documentation/usage/mail-templates/#configuration","title":"Configuration","text":"
      To enable custom templates, set the mail.templates_path option in the application configuration file  or the WG_PORTAL_MAIL_TEMPLATES_PATH environment variable to a valid folder path.
       
      For example:
       
      mail:\n  # ... other mail options ...\n  # Path where custom email templates (.gotpl and .gohtml) are stored.\n  # If the directory is empty on startup, the default embedded templates\n  # will be written there so you can modify them.\n  # Leave empty to use embedded templates only.\n  templates_path: \"/opt/wg-portal/mail-templates\"\n
      "},{"location":"documentation/usage/mail-templates/#template-files-and-names","title":"Template files and names","text":"
      The system expects the following template names. Place files with these names in your templates_path to override the defaults. You do not need to override all templates, only the ones you want to customize should be present.
       
         
      • Text templates (.gotpl):
        •  
      • mail_with_link.gotpl
        •  
      • mail_with_attachment.gotpl
        •  
      • HTML templates (.gohtml):
        •  
      • mail_with_link.gohtml
        •  
      • mail_with_attachment.gohtml
        •  
       
      Both text and HTML templates are standard Go  templates and receive the following data fields, depending on the email type:
       
         
      • Common fields:
        •  
      • PortalUrl (string) - external URL of the Portal
        •  
      • PortalName (string) - site title/company name
        •  
      • User (*domain.User) - the recipient user (may be partially populated when sending to a peer email)
        •  
      • Link email (mail_with_link.*):
        •  
      • Link (string) - the download link
        •  
      • Attachment email (mail_with_attachment.*):
        •  
      • ConfigFileName (string) - filename of the attached WireGuard config
        •  
      • QrcodePngName (string) - CID content-id of the embedded QR code image
        •  
       
      Tip: You can inspect the embedded templates in the repository under internal/app/mail/tpl_files/ for reference.  When the directory at templates_path is empty, these files are copied to your folder so you can edit them in place.
      "},{"location":"documentation/usage/security/","title":"Security","text":"
      This section describes the security features available to administrators for hardening WireGuard Portal and protecting its data.
      "},{"location":"documentation/usage/security/#database-encryption","title":"Database Encryption","text":"
      WireGuard Portal supports multiple database backends. To reduce the risk of data exposure, sensitive information stored in the database can be encrypted. To enable encryption, set the encryption_passphrase in the database configuration section.
       
       Important: Once encryption is enabled, it cannot be disabled, and the passphrase cannot be changed!  Only new or updated records will be encrypted; existing data remains in plaintext until it\u2019s next modified.
      "},{"location":"documentation/usage/security/#ui-and-api-access","title":"UI and API Access","text":"
      WireGuard Portal provides a web UI and a REST API for user interaction. It is important to secure these interfaces to prevent unauthorized access and data breaches.
      "},{"location":"documentation/usage/security/#https","title":"HTTPS","text":"
      It is recommended to use HTTPS for all communication with the portal to prevent eavesdropping. 
       
      Event though, WireGuard Portal supports HTTPS out of the box, it is recommended to use a reverse proxy like Nginx or Traefik to handle SSL termination and other security features. A detailed explanation is available in the Reverse Proxy section.
      "},{"location":"documentation/usage/security/#secure-authentication","title":"Secure Authentication","text":"
      To prevent unauthorized access, WireGuard Portal supports integrating with secure authentication providers such as LDAP, OAuth2, or Passkeys, see Authentication for more details. When possible, use centralized authentication and enforce multi-factor authentication (MFA) at the provider level for enhanced account security. For local accounts, administrators should enforce strong password requirements.
      "},{"location":"documentation/usage/user-sync/","title":"User Management","text":"
      For all external authentication providers (LDAP, OIDC, OAuth2), WireGuard Portal can automatically create a local user record upon the user's first successful login. This behavior is controlled by the registration_enabled setting in each authentication provider's configuration.
       
      User information from external authentication sources is merged into the corresponding local WireGuard Portal user record whenever the user logs in. Additionally, WireGuard Portal supports periodic synchronization of user data from an LDAP directory.
       
      To prevent overwriting local changes, WireGuard Portal allows you to set a per-user flag that disables synchronization of external attributes. When this flag is set, the user in WireGuard Portal will not be updated automatically during log-ins or LDAP synchronization.
      "},{"location":"documentation/usage/user-sync/#ldap-synchronization","title":"LDAP Synchronization","text":"
      WireGuard Portal lets you hook up any LDAP server such as Active Directory or OpenLDAP for both authentication and user sync. You can even register multiple LDAP servers side-by-side. Details on the log-in process can be found in the LDAP Authentication section.
       
      If you enable LDAP synchronization, all users within the LDAP directory will be created automatically in the WireGuard Portal database if they do not exist. If a user is disabled or deleted in LDAP, the user will be disabled in WireGuard Portal as well. The synchronization process can be fine-tuned by multiple parameters, which are described below.
      "},{"location":"documentation/usage/user-sync/#synchronization-parameters","title":"Synchronization Parameters","text":"
      To enable the LDAP sycnhronization this feature, set the sync_interval property in the LDAP provider configuration to a value greater than \"0\". The value is a string representing a duration, such as \"15m\" for 15 minutes or \"1h\" for 1 hour (check the exact format definition for details). The synchronization process will run in the background and synchronize users from LDAP to the database at the specified interval. Also make sure that the sync_filter property is a well-formed LDAP filter, or synchronization will fail.
      "},{"location":"documentation/usage/user-sync/#limiting-synchronization-to-specific-users","title":"Limiting Synchronization to Specific Users","text":"
      Use the sync_filter property in your LDAP provider block to restrict which users get synchronized. It accepts any valid LDAP search filter, only entries matching that filter will be pulled into the portal's database.
       
      For example, to import only users with a mail attribute: 
      auth:\n  ldap:\n    - id: ldap\n      # ... other settings\n      sync_filter: (mail=*)\n
      "},{"location":"documentation/usage/user-sync/#disable-missing-users","title":"Disable Missing Users","text":"
      If you set the disable_missing property to true, any user that is not found in LDAP during synchronization will be disabled in WireGuard Portal. All peers associated with that user will also be disabled.
       
      If you want a user and its peers to be automatically re-enabled once they are found in LDAP again, set the auto_re_enable property to true. This will only re-enable the user if they were disabled by the synchronization process. Manually disabled users will not be re-enabled.
      "},{"location":"documentation/usage/webhooks/","title":"Webhooks","text":"
      Webhooks allow WireGuard Portal to notify external services about events such as user creation, device changes, or configuration updates. This enables integration with other systems and automation workflows.
       
      When webhooks are configured and a specified event occurs, WireGuard Portal sends an HTTP POST request to the configured webhook URL.  The payload contains event-specific data in JSON format.
      "},{"location":"documentation/usage/webhooks/#configuration","title":"Configuration","text":"
      All available configuration options for webhooks can be found in the configuration overview.
       
      A basic webhook configuration looks like this:
       
      webhook:\n  url: https://your-service.example.com/webhook\n
      "},{"location":"documentation/usage/webhooks/#security","title":"Security","text":"
      Webhooks can be secured by using a shared secret. This secret is included in the Authorization header of the webhook request, allowing your service to verify the authenticity of the request. You can set the shared secret in the webhook configuration:
       
      webhook:\n  url: https://your-service.example.com/webhook\n  secret: \"Basic dXNlcm5hbWU6cGFzc3dvcmQ=\"\n
       
      You should also make sure that your webhook endpoint is secured with HTTPS to prevent eavesdropping and tampering.
      "},{"location":"documentation/usage/webhooks/#available-events","title":"Available Events","text":"
      WireGuard Portal supports various events that can trigger webhooks. The following events are available:
       
         
      • create: Triggered when a new entity is created.
        •  
      • update: Triggered when an existing entity is updated.
        •  
      • delete: Triggered when an entity is deleted.
        •  
      • connect: Triggered when a user connects to the VPN.
        •  
      • disconnect: Triggered when a user disconnects from the VPN.
        •  
       
      The following entity models are supported for webhook events:
       
         
      • user: WireGuard Portal users support creation, update, or deletion events.
        •  
      • peer: Peers support creation, update, or deletion events. Via the peer_metric entity, you can also receive connection status updates.
        •  
      • peer_metric: Peer metrics support connection status updates, such as when a peer connects or disconnects.
        •  
      • interface: WireGuard interfaces support creation, update, or deletion events.
        •  
      "},{"location":"documentation/usage/webhooks/#payload-structure","title":"Payload Structure","text":"
      All webhook events send a JSON payload containing relevant data. The structure of the payload depends on the event type and entity involved. A common shell structure for webhook payloads is as follows:
       
      {\n  \"event\": \"create\", // The event type, e.g. \"create\", \"update\", \"delete\", \"connect\", \"disconnect\"\n  \"entity\": \"user\",  // The entity type, e.g. \"user\", \"peer\", \"peer_metric\", \"interface\"\n  \"identifier\": \"the-user-identifier\", // Unique identifier of the entity, e.g. user ID or peer ID\n  \"payload\": {\n    // The payload of the event, e.g. a Peer model.\n    // Detailed model descriptions are provided below.\n  }\n}\n
      "},{"location":"documentation/usage/webhooks/#payload-models","title":"Payload Models","text":"
      All payload models are encoded as JSON objects. Fields with empty values might be omitted in the payload.
      "},{"location":"documentation/usage/webhooks/#user-payload-entity-user","title":"User Payload (entity: user)","text":"JSON Field Type Description CreatedBy string Creator identifier UpdatedBy string Last updater identifier CreatedAt time.Time Time of creation UpdatedAt time.Time Time of last update Identifier string Unique user identifier Email string User email AuthSources []AuthSource Authentication sources IsAdmin bool Whether user has admin privileges Firstname string User's first name (optional) Lastname string User's last name (optional) Phone string Contact phone number (optional) Department string User's department (optional) Notes string Additional notes (optional) Disabled *time.Time When user was disabled DisabledReason string Reason for deactivation Locked *time.Time When user account was locked LockedReason string Reason for being locked 
      AuthSource:
       JSON Field Type Description Source string The authentication source (e.g. LDAP, OAuth, or DB) ProviderName string The identifier of the authentication provider"},{"location":"documentation/usage/webhooks/#peer-payload-entity-peer","title":"Peer Payload (entity: peer)","text":"JSON Field Type Description CreatedBy string Creator identifier UpdatedBy string Last updater identifier CreatedAt time.Time Creation timestamp UpdatedAt time.Time Last update timestamp Endpoint string Peer endpoint address EndpointPublicKey string Public key of peer endpoint AllowedIPsStr string Allowed IPs ExtraAllowedIPsStr string Extra allowed IPs PresharedKey string Pre-shared key for encryption PersistentKeepalive int Keepalive interval in seconds DisplayName string Display name of the peer Identifier string Unique identifier UserIdentifier string Associated user ID (optional) InterfaceIdentifier string Interface this peer is attached to Disabled *time.Time When the peer was disabled DisabledReason string Reason for being disabled ExpiresAt *time.Time Expiration date Notes string Notes for this peer AutomaticallyCreated bool Whether peer was auto-generated PrivateKey string Peer private key PublicKey string Peer public key InterfaceType string Type of the peer interface Addresses []string IP addresses CheckAliveAddress string Address used for alive checks DnsStr string DNS servers DnsSearchStr string DNS search domains Mtu int MTU (Maximum Transmission Unit) FirewallMark uint32 Firewall mark (optional) RoutingTable string Custom routing table (optional) PreUp string Command before bringing up interface PostUp string Command after bringing up interface PreDown string Command before bringing down interface PostDown string Command after bringing down interface"},{"location":"documentation/usage/webhooks/#interface-payload-entity-interface","title":"Interface Payload (entity: interface)","text":"JSON Field Type Description CreatedBy string Creator identifier UpdatedBy string Last updater identifier CreatedAt time.Time Creation timestamp UpdatedAt time.Time Last update timestamp Identifier string Unique identifier PrivateKey string Private key for the interface PublicKey string Public key for the interface ListenPort int Listening port Addresses []string IP addresses DnsStr string DNS servers DnsSearchStr string DNS search domains Mtu int MTU (Maximum Transmission Unit) FirewallMark uint32 Firewall mark RoutingTable string Custom routing table PreUp string Command before bringing up interface PostUp string Command after bringing up interface PreDown string Command before bringing down interface PostDown string Command after bringing down interface SaveConfig bool Whether to save config to file DisplayName string Human-readable name Type string Type of interface DriverType string Driver used Disabled *time.Time When the interface was disabled DisabledReason string Reason for being disabled PeerDefNetworkStr string Default peer network configuration PeerDefDnsStr string Default peer DNS servers PeerDefDnsSearchStr string Default peer DNS search domains PeerDefEndpoint string Default peer endpoint PeerDefAllowedIPsStr string Default peer allowed IPs PeerDefMtu int Default peer MTU PeerDefPersistentKeepalive int Default keepalive value PeerDefFirewallMark uint32 Default firewall mark for peers PeerDefRoutingTable string Default routing table for peers PeerDefPreUp string Default peer pre-up command PeerDefPostUp string Default peer post-up command PeerDefPreDown string Default peer pre-down command PeerDefPostDown string Default peer post-down command"},{"location":"documentation/usage/webhooks/#peer-metrics-payload-entity-peer_metric","title":"Peer Metrics Payload (entity: peer_metric)","text":"JSON Field Type Description Status PeerStatus Current status of the peer Peer Peer Peer  data 
      PeerStatus sub-structure:
       JSON Field Type Description UpdatedAt time.Time Time of last status update IsConnected bool Is peer currently connected IsPingable bool Can peer be pinged LastPing *time.Time Time of last successful ping BytesReceived uint64 Bytes received from peer BytesTransmitted uint64 Bytes sent to peer Endpoint string Last known endpoint LastHandshake *time.Time Last successful handshake LastSessionStart *time.Time Time the last session began"},{"location":"documentation/usage/webhooks/#example-payloads","title":"Example Payloads","text":"
      The following payload is an example of a webhook event when a peer connects to the VPN:
       
      {\n  \"event\": \"connect\",\n  \"entity\": \"peer_metric\",\n  \"identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n  \"payload\": {\n    \"Status\": {\n      \"UpdatedAt\": \"2025-06-27T22:20:08.734900034+02:00\",\n      \"IsConnected\": true,\n      \"IsPingable\": false,\n      \"BytesReceived\": 212,\n      \"BytesTransmitted\": 2884,\n      \"Endpoint\": \"10.55.66.77:58756\",\n      \"LastHandshake\": \"2025-06-27T22:19:46.580842776+02:00\",\n      \"LastSessionStart\": \"2025-06-27T22:19:46.580842776+02:00\"\n    },\n    \"Peer\": {\n      \"CreatedBy\": \"admin@wgportal.local\",\n      \"UpdatedBy\": \"admin@wgportal.local\",\n      \"CreatedAt\": \"2025-06-26T21:43:49.251839574+02:00\",\n      \"UpdatedAt\": \"2025-06-27T22:18:39.67763985+02:00\",\n      \"Endpoint\": \"10.55.66.1:51820\",\n      \"EndpointPublicKey\": \"eiVibpi3C2PUPcx2kwA5s09OgHx7AEaKMd33k0LQ5mM=\",\n      \"AllowedIPsStr\": \"10.11.12.0/24,fdfd:d3ad:c0de:1234::/64\",\n      \"ExtraAllowedIPsStr\": \"\",\n      \"PresharedKey\": \"p9DDeLUSLOdQcjS8ZsBAiqUzwDIUvTyzavRZFuzhvyE=\",\n      \"PersistentKeepalive\": 16,\n      \"DisplayName\": \"Peer Fb5TaziA\",\n      \"Identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n      \"UserIdentifier\": \"admin@wgportal.local\",\n      \"InterfaceIdentifier\": \"wgTesting\",\n      \"AutomaticallyCreated\": false,\n      \"PrivateKey\": \"QBFNBe+7J49ergH0ze2TGUJMFrL/2bOL50Z2cgluYW8=\",\n      \"PublicKey\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n      \"InterfaceType\": \"client\",\n      \"Addresses\": [\n        \"10.11.12.10/32\",\n        \"fdfd:d3ad:c0de:1234::a/128\"\n      ],\n      \"CheckAliveAddress\": \"\",\n      \"DnsStr\": \"\",\n      \"DnsSearchStr\": \"\",\n      \"Mtu\": 1420\n    }\n  }\n}\n
       
      Here is another example of a webhook event when a peer is updated:
       
      {\n  \"event\": \"update\",\n  \"entity\": \"peer\",\n  \"identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n  \"payload\": {\n    \"CreatedBy\": \"admin@wgportal.local\",\n    \"UpdatedBy\": \"admin@wgportal.local\",\n    \"CreatedAt\": \"2025-06-26T21:43:49.251839574+02:00\",\n    \"UpdatedAt\": \"2025-06-27T22:18:39.67763985+02:00\",\n    \"Endpoint\": \"10.55.66.1:51820\",\n    \"EndpointPublicKey\": \"eiVibpi3C2PUPcx2kwA5s09OgHx7AEaKMd33k0LQ5mM=\",\n    \"AllowedIPsStr\": \"10.11.12.0/24,fdfd:d3ad:c0de:1234::/64\",\n    \"ExtraAllowedIPsStr\": \"\",\n    \"PresharedKey\": \"p9DDeLUSLOdQcjS8ZsBAiqUzwDIUvTyzavRZFuzhvyE=\",\n    \"PersistentKeepalive\": 16,\n    \"DisplayName\": \"Peer Fb5TaziA\",\n    \"Identifier\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n    \"UserIdentifier\": \"admin@wgportal.local\",\n    \"InterfaceIdentifier\": \"wgTesting\",\n    \"AutomaticallyCreated\": false,\n    \"PrivateKey\": \"QBFNBe+7J49ergH0ze2TGUJMFrL/2bOL50Z2cgluYW8=\",\n    \"PublicKey\": \"Fb5TaziAs1WrPBjC/MFbWsIelVXvi0hDKZ3YQM9wmU8=\",\n    \"InterfaceType\": \"client\",\n    \"Addresses\": [\n      \"10.11.12.10/32\",\n      \"fdfd:d3ad:c0de:1234::a/128\"\n    ],\n    \"CheckAliveAddress\": \"\",\n    \"DnsStr\": \"\",\n    \"DnsSearchStr\": \"\",\n    \"Mtu\": 1420\n  }\n}\n
      "}]}
\ No newline at end of file
diff --git a/master/sitemap.xml b/master/sitemap.xml
index 499fcd0..1d3c649 100644
--- a/master/sitemap.xml
+++ b/master/sitemap.xml
@@ -2,74 +2,78 @@
 
     
          https://wgportal.org/master/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/overview/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/configuration/examples/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/configuration/overview/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/getting-started/binaries/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/getting-started/docker/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/getting-started/helm/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/getting-started/reverse-proxy/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/getting-started/sources/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/monitoring/prometheus/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/rest-api/api-doc/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/upgrade/v1/
-         2026-01-19
+         2026-01-21
+    
+    
+         https://wgportal.org/master/documentation/usage/authentication/
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/usage/backends/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/usage/general/
-         2026-01-19
-    
-    
-         https://wgportal.org/master/documentation/usage/ldap/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/usage/mail-templates/
-         2026-01-19
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/usage/security/
-         2026-01-19
+         2026-01-21
+    
+    
+         https://wgportal.org/master/documentation/usage/user-sync/
+         2026-01-21
     
     
          https://wgportal.org/master/documentation/usage/webhooks/
-         2026-01-19
+         2026-01-21
     
 
\ No newline at end of file
diff --git a/master/sitemap.xml.gz b/master/sitemap.xml.gz
index 7a20a01e3fe2260e915c48830691ab086c0f7b06..79afe54965891c182614e919171c97cc973413fa 100644
GIT binary patch
literal 378
zcmV-=0fqh_iwFn+7jS6;|8r?{Wo=<_E_iKh0L_-oZo?o9$M1cLD0fQR!?aCpdfO9h
z4?u~Rpz#serfJ`PPE$=&Z_^G02?55~KmD-~`{O0}>I_IO#Y4SaZ|Vx7O|6UFq5gP(
zQ_uCWS?x1=0so&4T}gm
zi5h1IV@U>^;-~8}&MUZ>FnFNl5G_HY4w$7%6|q5vR-arn=*p_}$RxX8Wvls-s0SaG
z#Dg$BKA;9nm+O+iC}p%|t0|=DIH6E!ktYE6kc$E#5Gyk{EnUf0NtQfxXj;(cZBYs`
z9cYu~Y9c#38;kRtj66HBrSc>lL_p)qg9PKel3&T-4Z{M2A+Q-8U(1tZ0#tO3wmixR
Yr#_{xe_YRPke_Pv4Z!k(@YxCg01YIvWdHyG

literal 366
zcmV-!0g?V6iwFn+bZuz@|8r?{Wo=<_E_iKh0L_-oZi6rk$M1a##61LhnAVBX+n!*1
zfE2tCHD7W}Y2SXPt){8BX@?LgB5@r1r#}v)JzShE&Vb1Tzb~7rE(`E|7>w8Z^7G?e
zyq1S<(@tm;P{GbV?aPrUzDYUHbCnE%Q!!NmwM_lUlO!KTSy#KV+Z5cE0Qb?YwKnwK
z5+yBRbPPz!-a_zp0+g*>JbrIry9-0Nt+y|tZbY+Vmxt}1LH?xpYqBBqlLJqRSOghZ
zjkAF{Cqp0nm(dg6XK+z2T1e|5T7yO!h`35cB83ElJQ}aizcq)n6S@VO)hvt0hvm&JPv4tDJu{{BB7#@+yyV?WSOEyHGn)fSt*jz
zAdiZVxgSz~5)B?u+58}O;QxPi3a5+}d>4sU5v<_#B