diff --git a/doc/02-Installation.md b/doc/02-Installation.md index 32670effc..4ea058566 100644 --- a/doc/02-Installation.md +++ b/doc/02-Installation.md @@ -47,6 +47,7 @@ Below is a list of official package repositories for installing Icinga Web 2 for | Gentoo | [Upstream](https://packages.gentoo.org/packages/www-apps/icingaweb2) | | FreeBSD | [Upstream](http://portsmon.freebsd.org/portoverview.py?category=net-mgmt&portname=icingaweb2) | | ArchLinux | [Upstream](https://aur.archlinux.org/packages/icingaweb2) | +| Alpine Linux | [Upstream](http://git.alpinelinux.org/cgit/aports/tree/community/icingaweb2/APKBUILD) | Packages for distributions other than the ones listed above may also be available. Please contact your distribution packagers. @@ -63,7 +64,6 @@ wget -O - http://packages.icinga.com/icinga.key | apt-key add - echo 'deb http://packages.icinga.com/debian icinga-jessie main' >/etc/apt/sources.list.d/icinga.list apt-get update ``` - > INFO > > For other Debian versions just replace jessie with your distribution's code name. @@ -110,6 +110,15 @@ zypper ar http://packages.icinga.com/openSUSE/ICINGA-release.repo zypper ref ``` +**Alpine Linux**: +``` +echo "http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repos +apk update +``` +> INFO +> +> Latest version of Icinga Web 2 is in the edge repository, which is the -dev branch. + #### RHEL/CentOS Notes The packages for RHEL/CentOS depend on other packages which are distributed as part of the @@ -118,6 +127,14 @@ The packages for RHEL/CentOS depend on other packages which are distributed as p > Please note that installing Icinga Web 2 on **RHEL/CentOS 5** is not supported due to EOL versions of PHP and PostgreSQL. + +#### Alpine Linux Notes + +The example provided suppose that you are running Alpine edge, which is the -dev branch and is a rolling release. +If you are using a stable version, in order to use the latest Icinga Web 2 version you should "pin" the edge repository. +In order to correctly manage your repository, please follow +[these instructions](https://wiki.alpinelinux.org/wiki/Alpine_Linux_package_management). + ### Installing Icinga Web 2 You can install Icinga Web 2 by using your distribution's package manager to install the `icingaweb2` package. @@ -139,6 +156,12 @@ For RHEL/CentOS please read the [package repositories notes](#package-repositori zypper install icingaweb2 icingacli ``` +**Alpine Linux**: +``` +apk add icingaweb2 +``` +For Alpine Linux please read the [package repositories notes](#package-repositories-alpine-notes). + ### Preparing Web Setup You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time @@ -234,6 +257,10 @@ Example for Apache on Debian Jessie: a2enconf icingaweb2 ``` +Example for Apache on Alpine Linux: +``` +icingacli setup config webserver apache --document-root /usr/share/webapps/icingaweb2/public > /etc/apache2/conf.d/icingaweb2.conf +``` ### Preparing Icinga Web 2 Setup You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time @@ -275,6 +302,12 @@ usermod -a -G icingaweb2 www-data service apache2 restart ``` +**Alpine Linux**: +``` +gpasswd -a apache icingaweb2 +rc-service apache2 restart +``` + Use `icingacli` to create the configuration directory which defaults to **/etc/icingaweb2**: ```