site_name: LibreNMS Docs
docs_dir: doc
theme:
  name: material
  logo: img/librenms.svg
  language: en
  font:
    text: 'Roboto'
    code: 'Roboto Mono'
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: black
      accent: indigo
      toggle:
        icon: material/lightbulb-outline
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: black
      accent: indigo
      toggle:
        icon: material/lightbulb
        name: Switch to light mode

  features:
    - navigation.footer
    - navigation.instant
    - navigation.tracking
    - navigation.top
    - navigation.path
    - content.tabs.link
    - content.action.edit
    - content.code.copy
    - search.share
site_dir: out
site_url: https://docs.librenms.org
markdown_extensions:
  - tables
  - admonition
  - pymdownx.snippets
  - pymdownx.tasklist
  - pymdownx.tilde
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.details
  - pymdownx.highlight:
      extend_pygments_lang:
        - name: php
          lang: php
          options:
            startinline: true
plugins:
  - macros:
      j2_variable_start_string: '@='
      j2_variable_end_string: '=@'
  - markdown-exec
  - search
  - include_dir_to_nav
  - exclude:
      glob:
        - "Dockerfile"
  - redirects:
      redirect_maps:
        'Alerting/Introduction.md': 'Alerting/index.md'
        'API/API-Docs.md': 'API/index.md'
        'Extensions/Alerting.md': 'Alerting/index.md'
        'Extensions/Email-Alerting.md': 'Alerting/Transports.md'
        'Extensions/Graphite.md': 'Extensions/metrics/Graphite.md'
        'Extensions/InfluxDB.md': 'Extensions/metrics/InfluxDB.md'
        'Extensions/InfluxDBv2.md': 'Extensions/metrics/InfluxDBv2.md'
        'Extensions/Kafka.md': 'Extensions/metrics/Kafka.md'
        'Extensions/OpenTSDB.md': 'Extensions/metrics/OpenTSDB.md'
        'Extensions/Poller-Service.md': 'Extensions/Dispatcher-Service.md'
        'Extensions/Port-Description-Parser.md': 'Extensions/Interface-Description-Parsing.md'
        'Extensions/Prometheus.md': 'Extensions/metrics/Prometheus.md'
        'General/Contributing.md': 'Developing/Getting-Started.md'
        'Installation/CentOS-image.md': 'Installation/Install-LibreNMS.md'
        'Installation/index.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-CentOS-6-Apache-Nginx.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-CentOS-7-Apache.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-CentOS-7-Nginx.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-Debian-11-Nginx.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-Ubuntu-1604-Apache.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-Ubuntu-1604-Nginx.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-Ubuntu-1804-Apache.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installation-Ubuntu-1804-Nginx.md': 'Installation/Install-LibreNMS.md'
        'Installation/Installing-LibreNMS.md': 'Installation/Install-LibreNMS.md'
        'Installation/Ubuntu-image.md': 'Installation/Images.md'
        'Support/Support-New-OS.md': 'Developing/Support-New-OS.md'
  - minify:
      minify_html: true
      minify_js: true
      minify_css: true
      htmlmin_opts:
          remove_comments: true
      js_files:
          - js/docs-settings-links.js
      css_files:
          - librenms.css
extra_css:
  - https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/fontawesome.min.css
  - https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/solid.min.css
  - https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/brands.min.css
  - librenms.css
extra_javascript:
  - js/docs-settings-links.js
extra:
  analytics:
    provider: google
    property: G-K0B7KB9765
  article_nav_top: false
  article_nav_bottom: true
  php:
    version_min: 8.2
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/librenms/
      name: GitHub
    - icon: fontawesome/brands/docker
      link: https://hub.docker.com/r/librenms/librenms
      name: Docker
    - icon: fontawesome/brands/discord
      link: https://discord.com/invite/librenms
      name: Discord
    - icon: fontawesome/brands/reddit
      link: https://www.reddit.com/r/LibreNMS/
      name: Reddit
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/librenms
      name: Twitter
    - icon: fontawesome/brands/facebook
      link: https://www.facebook.com/LibreNMS
      name: Facebook
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/librenms/
      name: LinkedIn
site_author: LibreNMS
site_description: LibreNMS user and developer documentation
repo_url: https://github.com/librenms/librenms/
edit_uri: edit/master/doc
repo_name: GitHub
nav:
  - General:
    - Home: index.md
    - Features: Support/Features.md
    - Changelog:
      - Current Changelog: General/Changelog.md
      - Historical: General/Changelogs
    - Welcome to Observium users: General/Welcome-to-Observium-users.md
    - 3rd Party Libraries: General/Acknowledgement.md

  - Installation:
    - Installing LibreNMS: Installation/Install-LibreNMS.md
    - Other Methods:
      - Docker: Installation/Docker.md
      - Virtual machines: Installation/Images.md
    - Choosing a release: General/Releases.md
    - Updating: General/Updating.md
    - First steps:
      - Adding a device: Support/Adding-a-Device.md
      - Grouping Devices: Extensions/Device-Groups.md
      - Submitting stats: General/Callback-Stats-and-Privacy.md
      - Migrating from Observium: Installation/Migrating-from-Observium.md

  - Setup:
    - Applications overview: Extensions/Applications.md
      # Uses plugin include_dir_to_nav
    - Applications: Extensions/Applications
    - Billing Module: Extensions/Billing-Module.md
    - Configuration: Support/Configuration.md
    - Dashboards: Extensions/Dashboards.md
    - Interface Description Parsing: Extensions/Interface-Description-Parsing.md
    - Network Maps:
      - Availability Map: Extensions/Availability-Map.md
      - Dependency Map: Extensions/Dependency-Map.md
      - Network Map: Extensions/Network-Map.md
      - Custom Map: Extensions/Custom-Map.md
      - World Map: Extensions/World-Map.md
      - VisJS Config: Extensions/VisJS-Config.md
    - Syslog: Extensions/Syslog.md
    - Advanced Setup:
      - 1 Minute Polling: Support/1-Minute-Polling.md
      - Authentication Options: Extensions/Authentication.md
      - Authorization: Extensions/Authorization.md
      - Auto-discovery Setup: Extensions/Auto-Discovery.md
      - Bare Dashboard: Support/Bare-Dashboard.md
      - Cleanup Options: Support/Cleanup-options.md
      - Customizing the Web UI: Extensions/Customizing-the-Web-UI.md
      - Dispatcher Service: Extensions/Dispatcher-Service.md
      - Environment Variables: Support/Environment-Variables.md
      - Fast Ping Checking: Extensions/Fast-Ping-Check.md
      - Galera Database Cluster: Extensions/Galera-Cluster.md
      - High Availability: Support/High-Availability.md
      - IRC Bot Extensions: Extensions/IRC-Bot-Extensions.md
      - IRC Bot: Extensions/IRC-Bot.md
      - Oauth/SAML support: Extensions/OAuth-SAML.md
      - Redis Sentinel: Extensions/Redis-Sentinel.md
      - RRDCached: Extensions/RRDCached.md
      - RRDTune: Extensions/RRDTune.md
      - Scaling LibreNMS: Extensions/Distributed-Poller.md
      - SNMP Proxy: Extensions/SNMP-Proxy.md
      - SNMP Trap Handler: Extensions/SNMP-Trap-Handler.md
      - Sub-directory Support: Extensions/Sub-Directory.md
      - Two-Factor Auth: Extensions/Two-Factor-Auth.md
      - Varnish: Extensions/Varnish.md
  - 3rd Party Integration:
    - Check_MK Setup: Extensions/Agent-Setup.md
    - Gateone: Extensions/Gateone.md
    - Graylog: Extensions/Graylog.md
    - Nagios Plugins: Extensions/Services.md
    - NFSen: Extensions/NFSen.md
    - Oxidized: Extensions/Oxidized.md
    - PeeringDB: Extensions/PeeringDB.md
    - Proxmox: Extensions/Proxmox.md
    - Rancid: Extensions/Rancid.md
    - Smokeping: Extensions/Smokeping.md
    - Weathermap: Extensions/Weathermap.md
    - Storing Metrics:
      - Intro: Extensions/Metric-Storage.md
      - Graphite: Extensions/metrics/Graphite.md
      - InfluxDB: Extensions/metrics/InfluxDB.md
      - InfluxDBv2: Extensions/metrics/InfluxDBv2.md
      - OpenTSDB: Extensions/metrics/OpenTSDB.md
      - Prometheus: Extensions/metrics/Prometheus.md
      - Kafka: Extensions/metrics/Kafka.md

  - Alerting:
    - Introduction: Alerting/index.md
    - Operations: Alerting/Operations.md
    - Rules: Alerting/Rules.md
    - Templates: Alerting/Templates.md
    - Transport Overview: Alerting/Transports.md
    - Transports: Alerting/Transports
    - Creating Transports: Alerting/Creating-Transport.md
    - Entities: Alerting/Entities.md
    - Macros: Alerting/Macros.md
    - Testing: Alerting/Testing.md
    - Device Dependencies: Alerting/Device-Dependencies.md
    - Scheduled Maintenances: Alerting/Scheduled-Maintenances.md

  - API:
    - Using the API: API/index.md
    - Endpoints:
      - Alerts: API/Alerts.md
      - ARP: API/ARP.md
      - Bills: API/Bills.md
      - DeviceGroups: API/DeviceGroups.md
      - Devices: API/Devices.md
      - Inventory: API/Inventory.md
      - Locations: API/Locations.md
      - Logs: API/Logs.md
      - Pollers: API/Pollers.md
      - PollerGroups: API/PollerGroups.md
      - Port_Groups: API/Port_Groups.md
      - PortGroups: API/PortGroups.md
      - PortSecurity: API/PortSecurity.md
      - Ports: API/Ports.md
      - Routing: API/Routing.md
      - Services: API/Services.md
      - Switching: API/Switching.md
      - System: API/System.md

  - Getting help:
    - How to get help: Support/index.md
    - FAQ: Support/FAQ.md
    - Install Validation: Support/Install Validation.md
    - Performance: Support/Performance.md
    - Discovery Support: Support/Discovery Support.md
    - Poller Support: Support/Poller Support.md
    - Example Hardware Setups: Support/Example-Hardware-Setup.md
    - Remote Monitoring VPN: Support/Remote-Monitoring-VPN.md
    - SNMP Configuration Examples: Support/SNMP-Configuration-Examples.md
    - Device Troubleshooting: Support/Device-Troubleshooting.md
    - Device Sensors: Support/Device-Sensors.md

  - Contributing + Developing:
    - Contributing:
      - Getting Started: Developing/Getting-Started.md
      - Using Git: Developing/Using-Git.md
      - Validating Code: Developing/Validating-Code.md
      - Code Structure: Developing/Code-Structure.md
      - Fetching SNMP Data: Developing/Using-SnmpQuery.md
      - Creating Documentation: Developing/Creating-Documentation.md
      - Component: Extensions/Component.md
    - Support for a new OS:
      - Intro: Developing/Support-New-OS.md
      - Initial Detection: Developing/os/Initial-Detection.md
      - Mem/CPU Information: Developing/os/Mem-CPU-Information.md
      - Test Units: Developing/os/Test-Units.md
      - Health Information: Developing/os/Health-Information.md
      - Wireless Sensors: Developing/os/Wireless-Sensors.md
      - Custom Graphs: Developing/os/Custom-Graphs.md
      - Settings: Developing/os/Settings.md
      - Sensor State Support: Developing/Sensor-State-Support.md
    - SNMP Traps: Developing/SNMP-Traps.md
    - Dynamic Config: Developing/Dynamic-Config.md
    - Localization: Developing/Localization.md
    - Time Handling: Developing/Time-Handling.md
    - Plugin System: Extensions/Plugin-System.md
    - Developer notes:
      - Merging Pull Requests: Developing/Merging-Pull-Requests.md
      - Creating Release: Developing/Creating-Release.md
      - Applications: Developing/Application-Notes.md

  - Miscellaneous:
    - Security information: General/Security.md
    - CLI Scripts: Support/CLI-Tools.md
    - Device Notes:
      - Asuswrt-Merlin: Support/Device-Notes/AsuswrtMerlin.md
      - Carel pCOweb: Support/Device-Notes/Carel-pCOweb-Devices.md
      - Dell OpenManage: Extensions/Dell-OpenManage.md
      - Fortigate: Support/Device-Notes/Fortigate.md
      - OpenWRT: Support/Device-Notes/Openwrt.md
      - Raritan: Support/Device-Notes/Raritan.md
      - RouterOS: Support/Device-Notes/Routeros.md
      - Supermicro: Extensions/Supermicro.md
