{% extends 'generic/object_edit.html' %} {% load form_helpers %} {% block title %}Plugin Settings{% endblock %} {% block tabs %} {% endblock tabs %} {% block content %}
{% csrf_token %}

LibreNMS Server Settings

Configure which LibreNMS server to use for synchronization operations. Multiple servers can be configured in the NetBox configuration file.

{% render_field server_form.selected_server %}

Connection Test

Test the connection to the selected LibreNMS server to verify configuration.

Configuration Example

To configure multiple LibreNMS servers, update your NetBox configuration.py:

PLUGINS_CONFIG = {
    'netbox_librenms_plugin': {
        'servers': {
            'production': {
                'display_name': 'Production LibreNMS',
                'librenms_url': 'https://librenms-prod.example.com',
                'api_token': 'your_production_token',
                'cache_timeout': 300,
                'verify_ssl': True,
                'interface_name_field': 'ifDescr'
            },
            'testing': {
                'display_name': 'Test LibreNMS',
                'librenms_url': 'https://librenms-test.example.com',
                'api_token': 'your_test_token',
                'cache_timeout': 300,
                'verify_ssl': False,
                'interface_name_field': 'ifName'
            }
        }
    }
}
Note: For backward compatibility, the legacy single-server configuration is still supported if no "servers" configuration is provided.
{% csrf_token %}

Device Naming Defaults

Configure default naming preferences for imported devices.

User preferences: These defaults apply to users who have not yet changed their own toggle settings on the import page. Once a user changes a toggle, their personal preference is saved and takes priority over these defaults. Saving these settings will also update your own preferences to match.
{{ import_form.use_sysname_default }} {% if import_form.use_sysname_default.help_text %} {{ import_form.use_sysname_default.help_text }} {% endif %}
{{ import_form.strip_domain_default }} {% if import_form.strip_domain_default.help_text %} {{ import_form.strip_domain_default.help_text }} {% endif %}

Virtual Chassis Member Naming

Configure how virtual chassis member devices are named during import.

{{ import_form.vc_member_name_pattern }} {% if import_form.vc_member_name_pattern.errors %}
{{ import_form.vc_member_name_pattern.errors }}
{% endif %}

Available placeholders:

  • {position} - VC position number
  • {serial} - Member serial number

Note: The pattern is appended to the master device name. At least one placeholder is required to ensure each member gets a unique name.

Examples:

  • -M{position} → switch01-M1, switch01-M2
  • ({position}) → switch01 (1), switch01 (2)
  • -SW{position} → switch01-SW1, switch01-SW2
  • [{serial}] → switch01 [ABC123], switch01 [ABC124]
{% endblock %}