> For the complete documentation index, see [llms.txt](https://docs.octoxlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.octoxlabs.com/adapters/adapters/librenms.md).

# LibreNMS

## Connection Requirements

### 1 - IP

IP address of the LibreNMS host.

### 2 - Port

Port number (default: **8000**).

### 3 - X-Auth Token

To access any of the token end points you will be required to authenticate using a token. Tokens can be created directly from within the LibreNMS web interface by going to /api-access/.

1. Click on 'Create API access token'.
2. Select the user you would like to generate the token for.
3. Enter an optional description.
4. Click Create API Token.

{% hint style="info" %}
Make sure to save your generated API key in a secure location. This key is required for the OctoXLabs integration.
{% endhint %}

### 4 - Is Secure?

Choose this if your connection is going to be over HTTPS (default: **True**).

### 5 - Timeout

The amount of time (in seconds) to wait for API responses. (default: **30**)

### 6 - Proxy

Proxy URL (optional).

{% hint style="danger" %}
**Attention**

Please perform a connection test to ensure there is a valid connection to the LibreNMS. When the discovery operation is finalized you will be able to see the details on the Assets page.
{% endhint %}