{"id":13463877,"url":"https://github.com/redBorder/freeradius","last_synced_at":"2025-03-25T09:31:15.055Z","repository":{"id":17176798,"uuid":"19944116","full_name":"redBorder/freeradius","owner":"redBorder","description":"A clone of freeradius server with apache kafka accounting and auth plugin.","archived":false,"fork":false,"pushed_at":"2022-09-16T11:05:10.000Z","size":20189,"stargazers_count":25,"open_issues_count":1,"forks_count":45,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-29T16:21:47.414Z","etag":null,"topics":["redborder","redborder-ng","service"],"latest_commit_sha":null,"homepage":"","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/redBorder.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}},"created_at":"2014-05-19T14:04:14.000Z","updated_at":"2023-11-16T19:33:01.000Z","dependencies_parsed_at":"2023-01-11T20:26:02.653Z","dependency_job_id":null,"html_url":"https://github.com/redBorder/freeradius","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redBorder%2Ffreeradius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redBorder%2Ffreeradius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redBorder%2Ffreeradius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redBorder%2Ffreeradius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redBorder","download_url":"https://codeload.github.com/redBorder/freeradius/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245435114,"owners_count":20614831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["redborder","redborder-ng","service"],"created_at":"2024-07-31T14:00:29.757Z","updated_at":"2025-03-25T09:31:10.037Z","avatar_url":"https://github.com/redBorder.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"The FreeRADIUS server\n=====================\n\n|BuildStatus|_ |CoverityStatus|_\n\n.. contents::\n   :local:\n\nIntroduction\n------------\n\nThe FreeRADIUS Server Project is a high performance and highly\nconfigurable RADIUS server that is available under the terms of the\nGNU GPLv2.  Using RADIUS allows authentication and authorization for a\nnetwork to be centralized, and minimizes the number of changes that\nhave to be done when adding or deleting new users to a network.\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.\n\nVersion 3.0 of the server is largely compatible with version 2.x, but\nwe highly recommend that you recreate your configuration, rather than\ntrying to get the older configuration to work.\n\nFor a list of changes in version 3.0, please see ``doc/ChangeLog``.\n\nSee ``raddb/README.rst`` for information on what to do to update your\nconfiguration.\n\nAdministrators upgrading from a previous version should install this\nversion in a different location from their existing systems.  Any\nexisting configuration should be carefully migrated to the new\nversion, in order to take advantage of the new features which can\ngreatly simply configuration.\n\nPlease see http://freeradius.org and http://wiki.freeradius.org for\nmore information.\n\n\nInstallation\n------------\n\nTo install the server, please see the INSTALL file in this directory.\n\n\nDebugging the Server\n--------------------\n\nRun the server in debugging mode, (``radiusd -X``) and READ the output.\nWe cannot emphasize this point strongly enough.  The vast majority of\nproblems can be solved by carefully reading the debugging output,\nwhich includes WARNINGs about common issues, and suggestions for how\nthey 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.\n\nSearch the mailing lists.  There is a Google link on the bottom of\nthe 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\nAdditional Information\n----------------------\n\nSee ``doc/README`` for more information about FreeRADIUS.\n\nThere is an O'Reilly book available.  It serves as a good\nintroduction for anyone new to RADIUS.  However, it is almost 11 years\nold, and is not much more than a basic introduction to the subject.\n\nhttp://www.amazon.com/exec/obidos/ASIN/0596003226/freeradiusorg-20/\n\nProblems 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. Verify that the server starts.  (You ARE using debugging mode, right?)\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\nFeedback\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\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.  This\nis free software, and the only way it gets better is if you make a\ncontribution back to the project ($$, code, or documentation).\n\nWe will note that the people who get most upset about any answers to\ntheir questions usually do not have any intention of contributing to\nthe project.  We will repeat the comments above: no one is getting\npaid to answer your questions or to fix your bugs.  If you don't like\nthe responses you are getting, then fix the bug yourself, or pay\nsomeone to address your concerns.  Either way, make sure that any fix\nis contributed back to the project so that no one else runs into the\nsame issue.\n\nSupport is available.  See the \"support\" link at the top of the main\nweb page:\n\nhttp://freeradius.org\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.. |CoverityStatus| image:: https://scan.coverity.com/projects/58/badge.svg?\n.. _CoverityStatus: https://scan.coverity.com/projects/58\n\n.. |BuildStatus| image:: https://travis-ci.org/FreeRADIUS/freeradius-server.png\n.. _BuildStatus: https://travis-ci.org/FreeRADIUS/freeradius-server\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FredBorder%2Ffreeradius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FredBorder%2Ffreeradius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FredBorder%2Ffreeradius/lists"}