{"id":18929113,"url":"https://github.com/jwillikers/librenms-config","last_synced_at":"2025-04-15T14:31:55.938Z","repository":{"id":241400221,"uuid":"806597865","full_name":"jwillikers/librenms-config","owner":"jwillikers","description":"My configuration for LibreNMS","archived":true,"fork":false,"pushed_at":"2024-10-01T12:13:27.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T21:52:13.351Z","etag":null,"topics":["config","librenms"],"latest_commit_sha":null,"homepage":"https://codeberg.org/jwillikers/librenms-config","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jwillikers.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.adoc","code_of_conduct":"CODE_OF_CONDUCT.adoc","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-27T13:58:40.000Z","updated_at":"2024-10-01T12:15:10.000Z","dependencies_parsed_at":"2024-07-28T17:04:15.860Z","dependency_job_id":null,"html_url":"https://github.com/jwillikers/librenms-config","commit_stats":null,"previous_names":["jwillikers/librenms-config"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwillikers%2Flibrenms-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwillikers%2Flibrenms-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwillikers%2Flibrenms-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwillikers%2Flibrenms-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jwillikers","download_url":"https://codeload.github.com/jwillikers/librenms-config/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249088889,"owners_count":21210878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["config","librenms"],"created_at":"2024-11-08T11:30:10.888Z","updated_at":"2025-04-15T14:31:55.661Z","avatar_url":"https://github.com/jwillikers.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"= LibreNMS Config\nJordan Williams \u003cjordan@jwillikers.com\u003e\n:experimental:\n:icons: font\nifdef::env-github[]\n:tip-caption: :bulb:\n:note-caption: :information_source:\n:important-caption: :heavy_exclamation_mark:\n:caution-caption: :fire:\n:warning-caption: :warning:\nendif::[]\n:LibreNMS: https://www.librenms.org/[LibreNMS]\n\nMy configuration for {LibreNMS}, a network management and monitoring tool.\n\n== Usage\n\nThis repository contains the configuration files for {LibreNMS}.\nThe configuration is meant to be used with the containers from the https://github.com/jwillikers/home-lab-helm[Home Lab Helm] repository.\n\n. Create a `Projects` directory in the current user's home directory.\n+\n[,sh]\n----\nmkdir --parents ~/Projects\n----\n\n. Clone this repository under `~/Projects`.\n+\n[,sh]\n----\ngit -C ~/Projects clone https://codeberg.org/jwillikers/librenms-config.git\n----\n\n. For each template file in the `config` directory, copy it to the same directory without the `.template` extension.\n+\nBash::\n+\n[,sh]\n----\nfor host_template in config/*.yaml.template; do cp --no-clobber -- \"$host_template\" config/$(basename -- \"$host_template\" \".template\"); done\n----\n\nfish::\n+\n[,sh]\n----\nfor host_template in config/*.conf.template; cp --no-clobber -- \"$host_template\" config/(basename -- \"$host_template\" \".template\"); end\n----\n\nNushell::\n+\n[,sh]\n----\nfor host_template in (glob \"config/*.conf.template\") { cp --no-clobber $host_template $\"($host_template | path parse | reject extension | path join)\" }\n----\n\n. Fill in any missing credentials in the files in the `config` directory, such as SNMPv3 authentication and encryption keys.\n\n. Make sure that the sensitive files are not world readable.\n+\n[,sh]\n----\nchmod 0660 config/*.yaml\n----\n\n. Determine the UID mappings inside the rootless user's namespace.\n+\n[,sh]\n----\npodman unshare cat /proc/self/uid_map\n         0        818          1\n         1     655360      65536\n----\n\n. Do the math to determine the UID outside of the container that is used for user inside the container.\nIn this case, the container defaults to UID 0 inside the container.\nFrom the output of the previous command, we can see that UID 1 maps to UID 655360.\nThe following expression yields the UID outside of the container.\n+\n[,sh]\n----\nmath 655360 + 0 - 1\n655359\n----\n\n. Make sure that files are owned by the subuid that will map to the `root` user in the container.\n+\n[,sh]\n----\nsudo chown --recursive 655359 config\n----\n\n. Then mount the provided `config/` directory inside the LibreNMS server container at `/data/config`.\n\n== References\n\n* https://docs.librenms.org/[LibreNMS Documentation]\n\n== Code of Conduct\n\nPlease refer to the project's link:CODE_OF_CONDUCT.adoc[Code of Conduct].\n\n== License\n\nThis repository is licensed under the https://www.gnu.org/licenses/gpl-3.0.html[GPLv3].\nPlease refer to the bundled link:LICENSE.adoc[license].\n\n== Copyright\n\n© 2024 Jordan Williams\n\n== Authors\n\nmailto:{email}[{author}]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwillikers%2Flibrenms-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjwillikers%2Flibrenms-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwillikers%2Flibrenms-config/lists"}