> For the complete documentation index, see [llms.txt](https://indigo-dc.gitbook.io/identity-harmonization/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://indigo-dc.gitbook.io/identity-harmonization/deployment-and-administration-guide/installing-idh.md).

# Installing IdH

## Introduction

The recommended procedure is to build IdH from sources. But INDIGO-DataCloud also provides pre-build packages for Ubuntu >= 14.04 and Centos 7.

How to install the IdH service with packages is described in the following.

## Requirements

* Java >= 8 runtime
* OS: Ubuntu >= 14.04 or Centos 7

## Installation

The package repository can be found at the [INDIGO-DataCloud Software Repository](http://repo.indigo-datacloud.eu/).

### Ubuntu

You can either add INDIGO-DataCloud Software Repository to your package sources or download the `.deb` package manually.

#### INDIGO-DataCloud Repository

To enable the INDIGO-DataCloud Software Repository you can do the following.

`cd /etc/apt/sources.list.d`

`wget http://repo.indigo-datacloud.eu/repos/1/indigo1-ubuntu14_04.list`

Install the GPG key for INDIGO-DataCloud Software Repository:

`wget -q -O - http://repo.indigo-datacloud.eu/repository/RPM-GPG-KEY-indigodc | sudo apt-key add -`

Install the IdH package

`sudo apt update`

`sudo apt install identity-harmonization`

#### INDIGO-DataCloud Repository (manually)

You can use dpkg to install the IdH server as a service.

`sudo dpkg -i identity-harmonization-0.0.1.deb`

#### Running the Service

The IdH server will be installed as a init.d/systemd service and can be controlled via its init/systemd script. It will be enabled automatically and runs as a new user called idh.

`sudo service identity-harmonization stop`

`sudo service identity-harmonization start`

The Java executable jar is installed in `/var/lib/identity-harmonization/`

The configuration can be modified at `/var/lib/identity-harmonization/config/application.yml` or any other Spring Boot application supported way, see [Spring Boot - External config](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#boot-features-external-config).

For more details on the configuration please have a look at the Configuration section.

### CentOS

You can either add INDIGO-DataCloud Software Repository to your package sources or download the `.rpm` package manually.

#### INDIGO-DataCloud Repository

To enable the INDIGO-DataCloud Software Repository you can do the following.

`cd /etc/yum.repos.d`

`wget http://repo.indigo-datacloud.eu/repos/1/indigo1.repo`

Install the GPG key for INDIGO-DataCloud Software Repository:

`rpm --import http://repo.indigo-datacloud.eu/repository/RPM-GPG-KEY-indigodc`

Install the IdH package

`sudo yum install identity-harmonization`

#### INDIGO-DataCloud Repository (manually)

You can use rpm to install the IdH server as a service.

`sudo rpm -i identity-harmonization-0.0.1-1.x86_64.rpm`

#### Running the Service

The IdH server will be installed as a init.d/systemd service and can be controlled via its init/systemd script. It will be enabled automatically and runs as a new user called idh.

`sudo systemctl stop identity-harmonization.service`

`sudo systemctl stop identity-harmonization.service`

The Java executable jar is installed in `/var/lib/identity-harmonization/`

The configuration can be modified at `/var/lib/identity-harmonization/config/application.yml` or any other Spring Boot application supported way, see [Spring Boot - External config](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#boot-features-external-config).

For more details on the configuration please have a look at the Configuration section.