Skip to content

Latest commit

 

History

History
62 lines (40 loc) · 2.06 KB

installation.md

File metadata and controls

62 lines (40 loc) · 2.06 KB
Raw

Installation

The preferred way of installing Icinga Web 2 is to use the official package repositories depending on which operating system and distribution you are running. But it is also possible to install Icinga Web 2 directly from source.

Installing Requirements

  • A web server, e.g. Apache or nginx
  • PHP >= 5.3.0
  • MySQL or PostgreSQL PHP libraries when using a database for authentication or storing user preferences into a database
  • LDAP PHP library when using Active Directory or LDAP for authentication
  • Icinga 1.x w/ Livestatus or IDO, Icinga 2 w/ Livestatus or IDO feature enabled

Installing Icinga Web 2 from Package

A guide on how to install Icinga Web 2 from package will follow shortly.

Installing Icinga Web 2 from Source

Step 1: Getting the Source

First of all, you need to download the sources. Icinga Web 2 is available through a Git repository. You can clone this repository either via git or http protocol using the following URLs:

There is also a browsable version available at gi.icinga.org. This version also offers snapshots for easy download which you can use if you do not have git present on your system.

git clone git://git.icinga.org/icingaweb2.git

Step 2: Install the Source

Choose a target directory and move Icinga Web 2 there.

mv icingaweb2 /usr/share/icingaweb

Step 3: Configuring the Web Server

Use icingacli to generate web server configuration for either Apache or nginx.

Apache

./bin/icingacli setup config webserver apache --document-root /usr/share/icingaweb/public

nginx

./bin/icingacli setup config webserver nginx --document-root /usr/share/icingaweb/public

Step 4: Web Setup

Visit Icinga Web 2 in your browser and complete installation using the web setup.