> ## 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.

# Installation d'AppSignal pour Ruby

Veuillez d'abord suivre le [guide d'installation](/guides/new-application) lors de l'ajout d'une nouvelle application à AppSignal.

## Prérequis

Avant de pouvoir compiler la gem AppSignal, assurez-vous que les outils de build/compilation sont installés pour votre système. Veuillez consulter la page [Systèmes d'exploitation pris en charge](/support/operating-systems) pour toutes les dépendances système qui pourraient être requises.

## Installation de la gem

Nous vous recommandons d'installer et de gérer la dépendance de la gem AppSignal avec
[Bundler](http://bundler.io/).

Ajoutez la ligne suivante à votre `Gemfile`.

<CodeGroup>
  ```ruby Ruby theme={null}
  # Gemfile
  source "https://rubygems.org"

  gem "appsignal"
  ```
</CodeGroup>

Exécutez ensuite `bundle install` pour installer la gem.

Pour installer AppSignal dans votre application, nous vous recommandons d'exécuter la commande `appsignal install`. Veuillez la fournir avec votre [clé Push API](/appsignal/terminology#push-api-key) pour la configurer correctement.

<CodeGroup>
  ```sh Shell theme={null}
  bundle exec appsignal install YOUR_PUSH_API_KEY
  ```
</CodeGroup>

Cela vous présentera un script d'installation qui peut s'intégrer automatiquement dans certains frameworks et gems et qui vous permettra de configurer AppSignal.

Pour plus d'informations sur l'intégration d'AppSignal dans votre application, consultez la [documentation des intégrations](/ruby/integrations) pour voir quelles étapes sont nécessaires.

***

<Note>
  📖 Poursuivez avec notre [guide d'installation](/guides/new-application).
</Note>

## Désinstallation

Désinstallez AppSignal de votre application en suivant les étapes ci-dessous. Une fois ces étapes terminées, votre application n'enverra plus de données aux serveurs AppSignal.

1. Dans le `Gemfile` de votre application, supprimez la ligne `gem "appsignal"`.

2. Exécutez `bundle install` pour mettre à jour votre `Gemfile.lock` avec la gem supprimée.

3. Supprimez tous les [fichiers de configuration](/ruby/configuration/) AppSignal de votre application.
   * Emplacement du fichier de configuration : `config/appsignal.rb` ou `config/appsignal.yml`

4. Supprimez toutes les variables d'environnement système de vos hôtes de développement, staging, production, etc.
   * Variables d'environnement préfixées par `APPSIGNAL_`

   * Variable d'environnement [`APP_REVISION`](/ruby/configuration/options#option-revision)

5. Validez, déployez et redémarrez votre application.
   * Cela garantira que les serveurs AppSignal ne continueront pas à recevoir des données depuis votre application.

6. Facultatif : assurez-vous qu'aucun processus `appsignal-agent` n'est en cours d'exécution en arrière-plan.
   * Vérifiez la sortie de `ps aux | grep appsignal-agent` et tuez les processus encore en cours d'exécution.

7. Enfin, [supprimez l'application](/guides/application/deleting-applications) sur AppSignal.com.

<Note>
  📖 Poursuivez avec notre [guide de
  désinstallation](/guides/application/deleting-applications).
</Note>