> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal pour Ruby : Install

> Outil en ligne de commande pour installer AppSignal dans une application Ruby. Documentation sur l'utilisation, les options et les méthodes de configuration.

La documentation vous explique tout ce que vous devez savoir sur l'installation d'AppSignal via l'outil en ligne de commande.

## Description

L'outil en ligne de commande aide à configurer votre application. L'intégration avec des applications Ruby n'utilisant pas le framework Rails nécessite des étapes supplémentaires, car le programme d'installation d'AppSignal ne sait pas comment votre application est configurée. Nous vous recommandons de consulter notre [guide d'installation](/guides/new-application) lorsque vous ajoutez une nouvelle application à AppSignal.

Pour les applications Rails, l'intégration complète est automatique. Pour les autres frameworks, veuillez consulter notre [documentation sur les intégrations](/ruby/integrations/).

Une fois l'installation terminée, exécutez la [commande de l'outil demo](/ruby/command-line/demo) pour vérifier que l'installation a réussi. La commande de l'outil demo envoie des exemples de données depuis votre application vers les serveurs AppSignal, ce qui vous aide à vérifier que tout fonctionne correctement.

## Méthodes de configuration

Deux méthodes de configuration sont fournies par l'installateur en ligne de commande :

1. [Configuration via un fichier de configuration](#1-configuration-file)
2. [Configuration via des variables d'environnement](#2-environment-variables).

### 1. Fichier de configuration

AppSignal peut être configuré via un fichier de configuration appelé `appsignal.rb` ou `appsignal.yml`, situé dans votre application dans le répertoire `config/`.
Si vous choisissez cette option, notre installateur écrira votre configuration dans ce fichier.

Lors de la configuration de votre intégration AppSignal via le fichier de configuration, la clé Push API que vous fournissez à l'installateur sera écrite dans le fichier de configuration `appsignal.yml`. Nous ne recommandons pas d'ajouter cette clé à des systèmes de contrôle de version tels que Git, SVN ou Mercurial. Utilisez plutôt la variable d'environnement `APPSIGNAL_PUSH_API_KEY` pour stocker votre clé API.

Vous pouvez en savoir plus sur la configuration de votre application dans notre [documentation de configuration](/ruby/configuration).

### 2. Variables d'environnement

AppSignal peut être configuré via des variables d'environnement système. Si vous sélectionnez cette option, aucun [fichier de configuration](#1-configuration-file) ne sera généré.

Vous pouvez en savoir plus sur la configuration de votre application dans notre [documentation de configuration](/ruby/configuration).

## Utilisation

Pour installer appsignal via la ligne de commande, accédez au répertoire de votre projet et exécutez la commande suivante :

<CodeGroup>
  ```bash Bash theme={null}
  appsignal install <Push API key>
  # For example
  appsignal install 1234-1234-1234-1234
  ```
</CodeGroup>

La « Push API key » de votre application sera affichée dans l'[assistant d'installation](https://appsignal.com/redirect-to/organization?to=sites/new) et est également disponible dans la section d'administration des paramètres de votre organisation, ou via [ce lien](https://appsignal.com/redirect-to/organization?to=admin/api_keys).

## Options disponibles

| Option | Utilisation    | Description                                       |
| ------ | -------------- | ------------------------------------------------- |
| color  | `--[no-]color` | Active ou désactive la colorisation de la sortie. |