{"id":19028727,"url":"https://github.com/researchgate/freeradius","last_synced_at":"2026-06-18T12:32:30.838Z","repository":{"id":141869919,"uuid":"42879834","full_name":"researchgate/freeradius","owner":"researchgate","description":null,"archived":false,"fork":false,"pushed_at":"2023-04-07T07:57:13.000Z","size":54612,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":14,"default_branch":"researchgate","last_synced_at":"2025-02-21T19:45:20.250Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/researchgate.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-09-21T16:47:55.000Z","updated_at":"2018-12-20T14:46:13.000Z","dependencies_parsed_at":"2024-11-08T21:12:22.509Z","dependency_job_id":"a35e787a-e9ab-45b5-a2bd-c2c4b03f2f8c","html_url":"https://github.com/researchgate/freeradius","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/researchgate/freeradius","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchgate%2Ffreeradius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchgate%2Ffreeradius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchgate%2Ffreeradius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchgate%2Ffreeradius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/researchgate","download_url":"https://codeload.github.com/researchgate/freeradius/tar.gz/refs/heads/researchgate","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/researchgate%2Ffreeradius/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34491228,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T21:12:09.507Z","updated_at":"2026-06-18T12:32:30.813Z","avatar_url":"https://github.com/researchgate.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"The FreeRADIUS server\n=====================\n|BuildStatus|_\n\n1. INTRODUCTION\n---------------\n\nThe FreeRADIUS Server Project is a high performance and highly\nconfigurable AAA server.  Is available under the terms of the GNU\nGPLv2.  It has been in steady development for over a decade.  It is\nthe most widely used RADIUS server in the world, by quite a large\nmargin.\n\nAAA stands for \"Authentication, Authorization, and Accounting\".  The\nserver can do any or all of the AAA functions, across three protocols:\nRADIUS, DHCP, and VMPS.  The reason is that at its core, it is a\npolicy engine.  The policy engine connects network protocols to\nback-end systems such as SQL, LDAP, Active Directory, etc.\n\nFreeRADIUS started out as a RADIUS server, of course.  We then added\nVMPS and DHCP when it became clear that doing so was both easy and\nuseful.\n\nIt supports all popular authentication methods for RADIUS.  This\nincludes PAP, CHAP, MS-CHAP, EAP, etc.  It works with all known\nnetworking equipment.  The authors of FreeRADIUS have written the\nofficial specifications for how RADIUS works (RFC 5080 and RFC 6158,\namong others).  It is compliant with all RADIUS standards.  This means\nthat if a NAS does not inter-operate with FreeRADIUS, the most likely\nreason is that the NAS is wrong.\n\nFreeRADIUS can authenticate users on systems such as 802.1x (WiFi),\ndialup, PPPoE, VPN's, VoIP, and many others.  It supports back-end\ndatabases such as MySQL, PostgreSQL, Oracle, Microsoft Active\nDirectory, OpenLDAP, and many more.  It is used daily to authenticate\nthe Internet access for hundreds of millions of people, in sites\nranging from 10 users, to 10 million and more users.  It is used in\nappliances, WiFi boxes, ISPs, enterprises, and large\ntelecommunications providers.\n\nVersion 2.2 of the server is intended to be backwards compatible with\nprevious versions.  It has features not available in Version 1, many\nof which are also not available in any commercial server.\n\n* simple policy language (see ``man unlang``)\n* virtual servers (raddb/sites-available/README)\n* DHCP support (server and relay)\n* VMPS support\n* IPv6 support\n* better proxy support (raddb/proxy.conf)\n* More EAP types\n* verbose and descriptive Debugging output\n* Almost 50 \"stable\" modules, and many more experimental ones.\n* Sample SQL configuration for all major SQL databases.\n* Some support for on-the-fly changing of configuration (HUP)\n* check configuration test (``radiusd -C``)\n* Event-based server core.\n\nPlease see http://freeradius.org and http://wiki.freeradius.org for\nmore information.\n\n\n2. INSTALLATION\n---------------\n\nTo install the server, please see the INSTALL file in this directory.\nIn general, we recommend using a pre-packaged installation for your\noperating system.\n\n\n3. DEBUGGING THE SERVER\n-----------------------\n\nRADIUS systems can be complicated to configure.  Unlike a simple\n\"query-response\" protocol such as DNS, RADIUS systems need to juggle\nlarge amounts of information.  There may be dozens of attributes in\nthe request.  Processing the request may involve querying any or all\nof LDAP, SQL, flat files, external scripts, etc.\n\nThere is no easy solution to creating a working RADIUS configuration.\nThe only method that works is to run the server in debugging mode,\n(``radiusd -X``) and READ the output.  We cannot emphasize this point\nstrongly enough.  The vast majority of problems can be solved by\ncarefully reading the debugging output, which includes WARNINGs about\ncommon issues, and suggestions for how they may be fixed.\n\nRead the FAQ.  Many questions are answered there.  See the Wiki\n\nhttp://wiki.freeradius.org\n\nRead the configuration files.  Many parts of the server have NO\ndocumentation, other than comments in the configuration file.  That\nbeing said, there are dozens of examples in the configuration files.\nThe configuration items are extensively commented, with all of their\nbehavior documented.\n\nSearch the mailing lists.  Many questions come up repeatedly, and are\nanswered there.  There is a Google link on the bottom of the page:\n\nhttp://www.freeradius.org/list/users.html\n\nType some key words into the search box, and you should find\ndiscussions about common problems and solution.\n\n\n4. ADDITIONAL INFORMATION\n-------------------------\n\nSee 'doc/README' for more information about FreeRADIUS.\n\nSee raddb/sites-available/README for documentation on virtual servers.\n\n5. PROBLEMS AND CONCERNS\n------------------------\n\nWe understand that the server may be difficult to configure,\ninstall, or administer.  It is, after all, a complex system with many\ndifferent configuration possibilities.\n\nThe most common problem is that people change large amounts of the\nconfiguration without understanding what they're doing, and without\ntesting their changes.  The preferred method of operation is the\nfollowing:\n\n1. Start off with the default configuration files.\n2. Save a copy of the default configuration: It WORKS.  Don't change it!\n3. Run the server in debugging mode. (radiusd -X)\n4. Send it test packets using \"radclient\", or a NAS or AP.\n5. Verify that the server does what you expect.\n      - If it does not work, change the configuration, and go to step (3) \n        If you're stuck, revert to using the \"last working\" configuration.\n      - If it works, proceed to step (6).\n6. Save a copy of the working configuration, along with a note of what \n   you changed, and why.\n7. Make a SMALL change to the configuration.\n8. Repeat from step (3).\n\nThis method will ensure that you have a working configuration that\nis customized to your site as quickly as possible.  While it may seem\nfrustrating to proceed via a series of small steps, the alternative\nwill always take more time.  The \"fast and loose\" way will be MORE\nfrustrating than quickly making forward progress!\n\n\n6. FEEDBACK\n-----------\n\nIf you have any comments, bug reports, problems, or concerns, please\nsend them to the 'freeradius-users' list (see the URL above).  We will\ndo our best to answer your questions, to fix the problems, and to\ngenerally improve the server in any way we can.\n\nPlease do NOT complain that the developers aren't answering your\nquestions quickly enough, or aren't fixing the problems quickly\nenough.  Please do NOT complain if you're told to go read\ndocumentation.  We recognize that the documentation isn't perfect, but\nit *does* exist, and reading it can solve most common questions.\n\nThe list policy changed in mid 2012, due to the high volume of\ninappropriate posts from a subset of users.  These users would refuse\nto read the documentation, even when asked to.  They would ask\nquestions, and then refuse to follow the instructions given them on\nthe list.  They would argue over the answers given on the list, even\nwhen it was clear that they understood less about RADIUS than the\npeople trying to help them.\n\nThe new policy is to warn people engaging in this asocial behavior.\nIf they continue after a warning, they are unsubscribed and banned\npermanently from the list.\n\nThe decision to enforce etiquette came after over 10 years of having a\nmore open policy.  Sadly, a small subset of users abused the help\ngiven by the volunteers on the list.  This behavior is unacceptable,\nand will not be tolerated.\n\nFreeRADIUS is the cumulative effort of many years of work by many\npeople, and you've gotten it for free.  No one gets paid to work on\nFreeRADIUS, and no one is getting paid to answer your questions.\n\nIf you want the community to help you, you need to make it easy for\nthe community to help you.\n\nSupport is available.  See http://networkradius.com/.\n\nPlease submit bug reports, suggestions, or patches.  That feedback\ngives the developers a guide as to where they should focus their work.\nIf you like the server, feel free to mail the list and say so.\n\n.. |BuildStatus| image:: https://travis-ci.org/FreeRADIUS/freeradius-server.png?branch=v2.x.x\n.. _BuildStatus: https://travis-ci.org/FreeRADIUS/freeradius-server\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresearchgate%2Ffreeradius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresearchgate%2Ffreeradius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresearchgate%2Ffreeradius/lists"}