PHPackages wizballesy/librenms-oxidized-history - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. wizballesy/librenms-oxidized-history ActivePackage[Utility & Helpers](/categories/utility) wizballesy/librenms-oxidized-history ==================================== LibreNMS package for viewing historical Oxidized configuration history through an external Oxidized History API service. v0.1.0-alpha.4(today)00GPL-3.0-or-laterPHPPHP ^8.2 Since Jun 6Pushed todayCompare [ Source](https://github.com/WizballESY/librenms-oxidized-history)[ Packagist](https://packagist.org/packages/wizballesy/librenms-oxidized-history)[ RSS](/packages/wizballesy-librenms-oxidized-history/feed)WikiDiscussions main Synced today READMEChangelogDependencies (1)Versions (5)Used By (0) LibreNMS Oxidized History ========================= [](#librenms-oxidized-history) LibreNMS package for viewing historical Oxidized configuration history directly from local Oxidized Git repositories. This package adds a `Historical Config` device tab in LibreNMS. It is intended for environments where Oxidized stores configuration history in Git repositories and LibreNMS should be able to view older saved configurations without modifying LibreNMS core or Oxidized itself. Status ------ [](#status) Alpha release. This README documents the local Git history provider used by the current alpha release. The package reads Oxidized Git repositories directly from PHP. No separate companion service, Ruby daemon, HTTP listener, or bearer token is required. What it does ------------ [](#what-it-does) - Adds a LibreNMS device tab named `Historical Config` - Reads historical config versions directly from local Oxidized Git repositories - Shows available config versions for the selected device - Shows selected historical config content - Shows diff output between saved versions - Shows local backend diagnostics and detected Git repositories - Shows installed plugin/package version - Uses LibreNMS Oxidized group mapping where available - Does not modify LibreNMS core - Does not modify Oxidized Requirements ------------ [](#requirements) - LibreNMS with Composer package support - PHP 8.2 or newer - Git available on the LibreNMS server - Oxidized configuration history stored in Git repositories - The LibreNMS user must be able to read the Oxidized Git repository path Configuration ------------- [](#configuration) The package reads configuration from `config/oxidized-history.php`. Default local Git storage root: ``` /opt/librenms/.config/oxidized ``` Default repository mode: ``` group_repos ``` With the default layout, the package expects repositories such as: ``` /opt/librenms/.config/oxidized/cisco.git /opt/librenms/.config/oxidized/dell.git /opt/librenms/.config/oxidized/paloalto.git ``` Optional environment overrides: ``` OXIDIZED_HISTORY_GIT_STORAGE_ROOT=/opt/librenms/.config/oxidized OXIDIZED_HISTORY_GIT_REPO_MODE=group_repos OXIDIZED_HISTORY_MAX_VERSIONS=200 OXIDIZED_HISTORY_MAX_CONFIG_BYTES=2000000 ``` Installation ------------ [](#installation) This plugin is installed as a Composer package. Manual copy-based installation is not the recommended installation method. ### Install from Packagist [](#install-from-packagist) Recommended installation method: ``` cd /opt/librenms sudo -u librenms ./lnms plugin:add wizballesy/librenms-oxidized-history v0.1.0-alpha.7 sudo -u librenms php artisan optimize:clear sudo -u librenms php artisan view:clear ``` Replace `v0.1.0-alpha.7` with the version you want to install. After installation, open a LibreNMS device and select the `Historical Config` tab. Updating -------- [](#updating) To update to a specific release: ``` cd /opt/librenms sudo -u librenms ./lnms plugin:add wizballesy/librenms-oxidized-history v0.1.0-alpha.7 sudo -u librenms php artisan optimize:clear sudo -u librenms php artisan view:clear ``` Replace `v0.1.0-alpha.7` with the version you want to install. LibreNMS validate note ---------------------- [](#librenms-validate-note) Installing LibreNMS plugin packages modifies: ``` composer.json composer.lock ``` LibreNMS `validate` may warn that these files are locally modified after installing or updating third-party plugin packages. This is expected because the plugin is installed as a Composer dependency inside the LibreNMS application directory. Do not run `./scripts/github-remove` unless you intentionally want to remove local Composer changes. Troubleshooting --------------- [](#troubleshooting) Check which backend the plugin is using: ``` cd /opt/librenms sudo -u librenms php artisan tinker --execute=' $contract = \WizballEsy\LibreNmsOxidizedHistory\Contracts\HistoryProvider::class; $provider = app($contract); echo "provider=" . get_class($provider) . PHP_EOL; ' ``` Check that the LibreNMS user can read the Oxidized Git repositories: ``` sudo -u librenms ls -ld /opt/librenms/.config/oxidized sudo -u librenms find /opt/librenms/.config/oxidized -maxdepth 1 -type d -name "*.git" -print ``` Check one repository manually: ``` sudo -u librenms git --git-dir=/opt/librenms/.config/oxidized/cisco.git log -1 ``` Security notes -------------- [](#security-notes) - Keep Oxidized Git repositories readable only by trusted local users. - Do not expose Oxidized Git repositories through the web server. - Do not commit real device configuration data, secrets, SNMP communities, private keys, or organization-specific configuration data. - Use normal filesystem permissions to control which local users can read historical configuration backups. License ------- [](#license) GPL-3.0-or-later ### Health Score 36 — LowBetter than 80% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity35 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Total 4 Last Release 0d ago PHP version history (2 changes)v0.1.0-alpha.1PHP >=8.2 v0.1.0-alpha.4PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/7f9fa43e58cc841d6636df7314ffce59d7c2e12c7519b067db89efed4be5970b?d=identicon)[WizballESY](/maintainers/WizballESY) --- Top Contributors [![WizballESY](https://avatars.githubusercontent.com/u/96005757?v=4)](https://github.com/WizballESY "WizballESY (36 commits)") ### Embed Badge ![Health badge](/badges/wizballesy-librenms-oxidized-history/health.svg) ``` [![Health](https://phpackages.com/badges/wizballesy-librenms-oxidized-history/health.svg)](https://phpackages.com/packages/wizballesy-librenms-oxidized-history) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)