> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/authentication/authentication-proxy/auth-proxy-for-radius.md).

# Auth Proxy for RADIUS

***

### Overview

Authentication requests received from the RADIUS client are validated through 1Kosmos using the configured authentication methods.

{% hint style="info" %}
Supported Version: goauthproxy 1.00.07
{% endhint %}

***

### Configuring Community for Radius Servers

The RADIUS server must be configured with a shared secret (community) that matches the configuration on the RADIUS client.

This shared secret is used to establish trust between the RADIUS client and the Auth Proxy.

***

### Command Line Arguments

The RADIUS server is executed using the following command:

```bash
goauthproxy radius
```

### RADIUS Server Setup and Configuration

#### Starting the Radius Server Service

Run the following command to start the RADIUS server:

```
goauthproxy radius
```

***

#### Stopping the Radius Server Service

The RADIUS server runs as a foreground process. It can be stopped using:

**If running in terminal:**

```
Ctrl + C
```

**If running in background:**

Linux / macOS:

```
ps -ef | grep goauthproxykill -9 <PID>
```

Windows:

```
tasklist | findstr goauthproxytaskkill /PID <PID> /F
```

***

#### RADIUS Server Configuration Parameters

RADIUS server configuration is managed through the AdminX control plane. Parameters such as authentication behavior, user mapping, and integration settings are defined during Auth Proxy configuration.

***

#### Configuring the Radius Secret

A shared secret must be configured on both:

* RADIUS client
* Auth Proxy

The values must match exactly for successful authentication.

***

### Managing Logs and PID Directories

* The Auth Proxy generates logs during RADIUS server execution
* The running process is associated with a Process ID (PID)

These logs can be used for monitoring and troubleshooting authentication flows.

{% hint style="info" %}
Use system process commands to identify the PID and manage the running service.
{% endhint %}

***

### RADIUS Event Logs in AdminX

Authentication events related to RADIUS are recorded in AdminX and can be used for auditing and troubleshooting.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.1kosmos.com/authentication/authentication-proxy/auth-proxy-for-radius.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.