> ## 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 für Ruby: Install

> Kommandozeilen-Tool zur Installation von AppSignal in einer Ruby-Anwendung. Dokumentation zu Verwendung, Optionen und Konfigurationsmethoden.

Diese Dokumentation sagt Ihnen alles, was Sie über die Installation von AppSignal über das Kommandozeilen-Tool wissen müssen.

## Beschreibung

Das Kommandozeilen-Tool hilft Ihnen beim Einrichten der Konfiguration für Ihre Anwendung. Die Integration mit Ruby-Anwendungen, die nicht das Rails-Framework verwenden, erfordert zusätzliche Schritte, da der AppSignal-Installer nicht weiß, wie Ihre Anwendung eingerichtet ist. Wir empfehlen unseren [Installationsleitfaden](/guides/new-application), wenn Sie eine neue Anwendung zu AppSignal hinzufügen.

Bei Rails-Anwendungen erfolgt die vollständige Integration automatisch. Für andere Frameworks beachten Sie bitte unsere [Integrationsdokumentation](/ruby/integrations/).

Sobald die Installation abgeschlossen ist, führen Sie den Befehl [Demo-Tool](/ruby/command-line/demo) aus, um zu überprüfen, ob die Installation erfolgreich war. Der Demo-Tool-Befehl sendet Beispieldaten aus Ihrer Anwendung an die AppSignal-Server, was Ihnen hilft zu überprüfen, ob alles richtig funktioniert.

## Konfigurationsmethoden

Es gibt zwei Konfigurationsmethoden, die vom Kommandozeilen-Installer bereitgestellt werden:

1. [Konfiguration über eine Konfigurationsdatei](#1-configuration-file)
2. [Konfiguration über Umgebungsvariablen](#2-environment-variables).

### 1. Konfigurationsdatei

AppSignal kann über eine Konfigurationsdatei namens `appsignal.rb` oder `appsignal.yml` konfiguriert werden, die sich in Ihrer Anwendung im Verzeichnis `config/` befindet.
Wenn Sie diese Option wählen, schreibt unser Installer Ihre Konfiguration in diese Datei.

Wenn Sie Ihre AppSignal-Integration über die Konfigurationsdatei konfigurieren, wird der Push API-Schlüssel, den Sie dem Installer angeben, in die Konfigurationsdatei `appsignal.yml` geschrieben. Wir empfehlen nicht, diesen Schlüssel zu Versionskontrollsystemen wie Git, SVN oder Mercurial hinzuzufügen. Verwenden Sie stattdessen die Umgebungsvariable `APPSIGNAL_PUSH_API_KEY`, um Ihren API-Schlüssel zu speichern.

Mehr über die Konfiguration Ihrer Anwendung erfahren Sie in unserer [Konfigurationsdokumentation](/ruby/configuration).

### 2. Umgebungsvariablen

AppSignal kann über System-Umgebungsvariablen konfiguriert werden. Wenn Sie diese Option wählen, wird keine [Konfigurationsdatei](#1-configuration-file) generiert.

Mehr über die Konfiguration Ihrer Anwendung erfahren Sie in unserer [Konfigurationsdokumentation](/ruby/configuration).

## Verwendung

Um appsignal über die Kommandozeile zu installieren, navigieren Sie zu Ihrem Projektverzeichnis und führen Sie folgenden Befehl aus:

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

Der "Push API-Schlüssel" Ihrer Anwendung wird im [Installations-Wizard](https://appsignal.com/redirect-to/organization?to=sites/new) angezeigt und ist auch im Administrationsbereich der Einstellungen Ihrer Organisation oder über [diesen Link](https://appsignal.com/redirect-to/organization?to=admin/api_keys) verfügbar.

## Verfügbare Optionen

| Option | Verwendung     | Beschreibung                            |
| ------ | -------------- | --------------------------------------- |
| color  | `--[no-]color` | Schaltet die Einfärbung der Ausgabe um. |