From: Alan T. DeKok Date: Mon, 25 Sep 2023 13:29:01 +0000 (-0400) Subject: more notes on what doesn't work in v4 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=aa3bf60465cf76cc9b520c671138c7e7c3f7245d;p=thirdparty%2Ffreeradius-server.git more notes on what doesn't work in v4 --- diff --git a/doc/antora/modules/ROOT/pages/index.adoc b/doc/antora/modules/ROOT/pages/index.adoc index ed94bd11750..f7fb4b784d9 100644 --- a/doc/antora/modules/ROOT/pages/index.adoc +++ b/doc/antora/modules/ROOT/pages/index.adoc @@ -57,6 +57,34 @@ steps, each of which can be performed quickly. We hope that this extended documentation will address any lingering concerns about the quality of the FreeRADIUS documentation. +== Current Limitations of 4.0.0 + +As of the time of writing this documentation, the server has the +following limitations: + +* RADIUS/TLS (RadSec) is not implemented. +* TTLS, PEAP, TEAP, and EAP-FAST are not implemented. +* The "haproxy" and "reverse CoA' features are not implemented +* The Perl, Python, and Lua modules do not fully support the v4 "nested" attributes. +* We will likely remove the requirement to use `&` as a prefix for attribute names. This change will likely require you to change all of your configuration. + +Please be aware that v4 is in "alpha" right now. If it works, great. +If it doesn't work, then please return to using v3. + +[WARNING] +==== +Please do not open bug reports about those features being missing. +All such bug reports will be closed without comment. + +We do not recommend that operating systems or Linux distributions +create their own packages for 4.0.0-alpha. Our experience has been +that packaging "alpha" releases results in confused and upset users. +People _will_ install it due to the belief that "it's stable because +it is packaged". They will then run into issues, and will blame us. + +Such behavior is antisocial and is strongly discouraged. +==== + == Changes From Earlier Versions In previous releases, FreeRADIUS had the following limitations: