---
title: Installation
slug: oip-next/v3/core/installation
icon: {"lucideIcon":"📘"}
createdAt: 2025-10-13T13:20:45.000Z
---

La bibliothèque OIP Core est distribuée sous la forme d'un [package npm](https://www.npmjs.com/package/@fasstech/oip-core). Elle peut être installée via les outils `npm` ou `yarn`, ou déclarée comme dépendance du projet dans le fichier `package.json`.

:::CodeblockTabs
npm

```shell
npm install '@fasstech/oip-core'
```

yarn

```shell
yarn add '@fasstech/oip-core'
```

package.json

```json
{
  dependencies: {
    "@fasstech/oip-core": '^3.0.0'
  }
}
```
:::

# Peer dependencies

L'OIP Core nécessite plusieurs [peer dependencies](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#peerdependencies) :

Pour utiliser les dépendances @fasstech, vous devez disposer des droits d'accès NPM nécessaires.

- [@fasstech/logger](https://github.com/fasst/fasst-logger)
- [@fasstech/oip-transition-manager](https://github.com/fasst/oip-transition-manager)
- [@fasstech/rabbitmq-helper](https://github.com/fasst/fasst-rabbitmq-helper)
- [bluebird](https://github.com/petkaantonov/bluebird)
- [express](https://github.com/expressjs/express)

# Variables d'environnement

## CIPHER\_IV

**\[obligatoire]** Vecteur d'initialisation utilisé par l'algorithme de chiffrement.

Cette valeur est spécifique à chaque projet.

La longueur doit être de 16 caractères.

Exemple : W05IGQ5qdBnIqAWE

## CIPHER\_KEY

**\[obligatoire]** Clé utilisée par l'algorithme de chiffrement.

Cette valeur est spécifique à chaque projet.

La longueur doit être de 32 caractères.

Exemple : ayz9VFNtbRQM0yBODcCb1lrUtVVH3D3y

## OIP\_MONGO\_DB\_URL

**\[obligatoire]** URL de la base MongoDB.

## OIP\_WORK\_DIR

**\[obligatoire]** Répertoire racine du projet.

## ENABLE\_DEFAULT\_DATA\_COLLECTOR

Si spécifié, l'appel à la fonction `save` de l'entité `Project` pourra générer un évènement via le *data collector*. Un évènement sera généré dans l'une des deux conditions décrites ci-dessous :

- Création de l'entité `Project` ; le type de l'évènement est `'CREATE_PROJECT'`.
- Mise à jour du statut de l'entité `Project` ; le type de l'évènement est `'UPDATE_STATUS'`. L'évènement porte l'information du nouveau statut : `{ metadata: { newStatus } }`.

Si activé, des variables d'environnement doivent être ajoutées :

- `RABBIT_MQ_HOST`
- `RABBIT_MQ_USER`
- `RABBIT_MQ_PASSWORD`
- `RABBIT_MQ_VHOST`

Ces variables d'environnement sont requises par la bibliothèque `@fasstech/rabbitmq-helper` ; la documentation est disponible [ici](https://github.com/fasst/fasst-rabbitmq-helper).
