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

Bitte folgen Sie zuerst dem [Installationsleitfaden](/guides/new-application), wenn Sie eine neue Anwendung zu AppSignal hinzufügen.

## Anforderungen

Bevor Sie das AppSignal-Paket kompilieren können, stellen Sie sicher, dass die Build-/Kompilierungswerkzeuge für Ihr System installiert sind. Bitte prüfen Sie die Seite [Unterstützte Betriebssysteme](/support/operating-systems) auf eventuell erforderliche Systemabhängigkeiten.

## Installation

[Registrieren](https://appsignal.com/users/sign_up) Sie sich zunächst für ein AppSignal-Konto. Installieren Sie dann AppSignal, indem Sie den Anweisungen für Ihren Paketmanager folgen.

### Mit npm

<CodeGroup>
  ```bash Bash theme={null}
  npm install @appsignal/nodejs
  ```
</CodeGroup>

Es ist auch möglich, das `@appsignal/nodejs`-Paket manuell zu Ihrer `package.json` hinzuzufügen. Führen Sie dann `npm install` aus.

<CodeGroup>
  ```json JSON theme={null}
  {
    "name": "my-app",
    "dependencies": {
      "@appsignal/nodejs": "^3.0.0"
    }
  }
  ```
</CodeGroup>

Erstellen Sie eine `appsignal.cjs`-Datei, um AppSignal zu requiren und zu konfigurieren. Diese Datei kann auch an einem anderen Ort platziert werden, z. B. im Verzeichnis `src/`. Weitere Informationen zur Konfiguration finden Sie in unserem [Konfigurationsabschnitt](/nodejs/3.x/configuration).

<CodeGroup>
  ```javascript Node.js theme={null}
  // appsignal.cjs
  const { Appsignal } = require("@appsignal/nodejs");

  new Appsignal({
    active: true,
    name: "<YOUR APPLICATION NAME>",
    pushApiKey: "<YOUR API KEY>",
  });
  ```
</CodeGroup>

### Mit pnpm

pnpm unterdrückt standardmäßig Lifecycle-Skripte für Abhängigkeiten. Das `@appsignal/nodejs`-Paket verlässt sich auf ein `install`-Lifecycle-Skript, um seine native Erweiterung herunterzuladen und zu kompilieren. Ohne dieses wird die Erweiterung nicht geladen und AppSignal meldet keine Daten.

Um das Paket zu installieren und sein Lifecycle-Skript ausführen zu lassen:

<CodeGroup>
  ```bash Bash theme={null}
  pnpm --allow-build=@appsignal/nodejs add @appsignal/nodejs
  ```
</CodeGroup>

### Den AppSignal-Client requiren

Jetzt können Sie Ihre Anwendung wie gewohnt starten, aber verwenden Sie das Flag `--require`, um die Instrumentierung von AppSignal vor jeder anderen Bibliothek zu laden:

<CodeGroup>
  ```shell Shell theme={null}
  node --require './appsignal.cjs' index.js
  ```
</CodeGroup>

Wir empfehlen, das Flag `--require` zu jedem Skript hinzuzufügen, das Ihre App startet:

<CodeGroup>
  ```json JSON theme={null}
  {
    "scripts": {
      "server": "node --require ./appsignal.cjs index.js"
    }
  }
  ```
</CodeGroup>

Sie können das Flag `--require` auch mit Tools wie `ts-node` und `nodemon` verwenden.

Wenn Sie ein Wrapper-CLI wie `nest start` oder `fastify start` zum Starten Ihrer Anwendung verwenden, nutzen Sie die Umgebungsvariable `NODE_OPTIONS`, um das Flag an die Node.js-Laufzeit zu übergeben:

<CodeGroup>
  ```sh Shell theme={null}
  NODE_OPTIONS='--require ./appsignal.cjs' nest start
  ```
</CodeGroup>

<Warning>
  Damit die AppSignal-Integration korrekt funktioniert, **muss** die Datei `appsignal.cjs` vor allen anderen Abhängigkeiten required werden.
</Warning>

### TypeScript-Unterstützung

AppSignal ist vollständig mit TypeScript kompatibel. Wenn Sie eine kompilierte TypeScript-Anwendung mit `node` ausführen, empfehlen wir die Verwendung des [Node.js-Flags `--enable-source-maps`](https://nodejs.org/api/cli.html#--enable-source-maps), damit Fehler-Backtraces in AppSignal auf Stellen im ursprünglichen TypeScript-Code verweisen:

<CodeGroup>
  ```sh Shell theme={null}
  node --enable-source-maps --require './appsignal.cjs' dist/src/main.js
  ```
</CodeGroup>

Wenn Sie ein Wrapper-CLI wie `nest start` oder `fastify start` zum Starten Ihrer Anwendung verwenden, nutzen Sie die Umgebungsvariable `NODE_OPTIONS`, um das Flag an die Node.js-Laufzeit zu übergeben:

<CodeGroup>
  ```sh Shell theme={null}
  NODE_OPTIONS='--enable-source-maps --require ./appsignal.cjs' nest start
  ```
</CodeGroup>

### AppSignal-Client importieren

Auf den AppSignal-Client wird über das global exportierte Objekt `Appsignal.client` zugegriffen.

Um Funktionen wie [benutzerdefinierte Metriken](/metrics/custom) zu verwenden, müssen Sie zuerst den AppSignal-Client importieren:

<CodeGroup>
  ```javascript Node.js theme={null}
  import { Appsignal } from "@appsignal/nodejs";
  // or: const { Appsignal } = require("@appsignal/nodejs");

  const client = Appsignal.client;
  ```
</CodeGroup>

### Integrationen hinzufügen

AppSignal unterstützt mehrere Bibliotheken und Frameworks mit zusätzlichen Paketen, wie Express, Koa, Next.js und mehr. Zusätzliche Installationsanweisungen für diese Pakete finden Sie im [Abschnitt Node.js-Integrationen](/nodejs/3.x/integrations).

***

<Note>
  📖 Fahren Sie mit unserem [Installationsleitfaden](/guides/new-application) fort.
</Note>

## AppSignal für Node.js deinstallieren

Deinstallieren Sie AppSignal aus Ihrer App, indem Sie die folgenden Schritte ausführen. Wenn diese Schritte abgeschlossen sind, sendet Ihre App keine Daten mehr an die AppSignal-Server.

1. Führen Sie `npm uninstall @appsignal/nodejs` aus, um die AppSignal für Node.js-Integration zu deinstallieren, oder löschen Sie die Zeile innerhalb des `dependencies`-Blocks der `package.json`-Datei Ihrer Anwendung, die auf das Paket `@appsignal/nodejs` verweist.

2. Führen Sie `npm install` aus, um Ihre `package.lock` mit dem Status der entfernten Pakete zu aktualisieren.

3. Entfernen Sie alle AppSignal-[Konfigurationen](/nodejs/3.x/configuration/) aus Ihrer App.

4. Committen, deployen und starten Sie Ihre App neu.
   * Dadurch wird sichergestellt, dass die AppSignal-Server keine Daten mehr von Ihrer App empfangen.

5. Entfernen Sie schließlich [die App](/guides/application/deleting-applications) auf AppSignal.com.

<Note>
  📖 Fahren Sie mit unserem [Deinstallationsleitfaden](/guides/application/deleting-applications) fort.
</Note>

## Den AppSignal-Client stoppen

AppSignal stoppt automatisch, wenn Ihre Anwendung oder Ihr Rechner nicht mehr läuft. Wenn Sie AppSignal jedoch manuell stoppen möchten, können Sie den folgenden Befehl ausführen:

<CodeGroup>
  ```javascript Node.js theme={null}
  import { Appsignal } from "@appsignal/nodejs";
  // or: const { Appsignal } = require("@appsignal/nodejs");

  Appsignal.client.stop();
  ```
</CodeGroup>