https://github.com/opennms-forge/opennms-install

Basic install script for default Linux systems
https://github.com/opennms-forge/opennms-install

hacktoberfest opennms quickstart

Last synced: 4 months ago
JSON representation

Basic install script for default Linux systems

• Host: GitHub
• URL: https://github.com/opennms-forge/opennms-install
• Owner: opennms-forge
• License: gpl-3.0
• Created: 2015-11-04T16:23:01.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2025-11-20T09:34:01.000Z (6 months ago)
• Last Synced: 2025-11-20T11:27:54.868Z (6 months ago)
• Topics: hacktoberfest, opennms, quickstart
• Language: Shell
• Homepage:
• Size: 147 KB
• Stars: 37
• Watchers: 11
• Forks: 19
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🚀 OpenNMS Quick Installer ✨

This script is a convenient bootstrap script to install OpenNMS on Debian or CentOS systems.

The script executes the steps documented in [Installation and Configuration guide](https://docs.opennms.com/horizon/latest/deployment/core/getting-started.html).

The script is tested with:

* Ubuntu 24.04 (Noble Numbat) x86_64

* Debian 12 (Bookworm) x86_64

* CentOS Stream 9/10 x86_64

* Rocky Linux 9/10 x86_64

* AlmaLinux 9/10 x86_64

[![asciicast](https://asciinema.org/a/dCzY67dR6Ph07X2XLEdoGe9FC.svg)](https://asciinema.org/a/dCzY67dR6Ph07X2XLEdoGe9FC)

💁‍♀️ If you want to learn in detail, take a look at the deployment section in our documentation for [OpenNMS Horizon](https://docs.opennms.com/horizon/latest/) or [OpenNMS Meridian](https://docs.opennms.com/meridian/latest/).

We have also started to work on Ansible roles for the Ubuntu-based operating systems, which you can find at https://github.com/opennms-forge/ansible-opennms.

## 🎯 Scope

* Bootstrap a single-node OpenNMS system on RPM or DEB-based systems quickly with the latest stable release

* Installation procedure closely following the best practices from our official docs

* Scripts don't deal with existing installations or upgrades

* Scripts don't configure or install Minions, Sentinels, or distributed time series storage like Cortex.

* Users can use the installed system to learn and investigate how to configure OpenNMS Horizon in complex distributed environments, which gives them a quick starting point.

## 🏆 Goal

* Give people a way to install OpenNMS Horizon on their system to get familiar with OpenNMS Horizon quickly on a bare metal system.

* Remove the need to know Docker or Ansible to quickly bootstrap an OpenNMS Horizon system.

* Keep it simple and support operating systems based on official packages using RPM and DEB.

## 🕹️ Usage

Download the script to your system.

Execute on a CentOS-based system

```bash

sudo bash bootstrap-yum.sh

```

Execute on a Debian-based system

```bash

sudo bash bootstrap-debian.sh

```

## 👋 Say hello

You are very welcome to join us to make this repo a better place.

You can find us at:

* Public OpenNMS [Mattermost Chat](https://chat.opennms.com/opennms/channels/opennms-discussion)

* If you have longer discussions to share ideas, use our [OpenNMS Discourse](https://opennms.discourse.group) and tag your post with `opennms-installer`