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

# Procuros Bridge installieren

> Procuros Bridge unter Windows oder Linux herunterladen und installieren und von der bisherigen Bridge migrieren.

Procuros Bridge läuft auf dem Host-Rechner oder Server, der mit Ihrem On-Premise-ERP-System verbunden ist, und bindet dieses an das Procuros-Netzwerk an. Sie läuft als Hintergrunddienst und synchronisiert daher weiter, auch nachdem Sie das Fenster schließen oder den Rechner neu starten. Einmal installiert, hält sie sich automatisch aktuell.

## Herunterladen

<CardGroup cols={3}>
  <Card title="Windows" icon="windows" href="https://procuros-bridge.s3.eu-central-1.amazonaws.com/v1/updates/latest/procuros-bridge-amd64.msi">
    .msi-Installer für x64
  </Card>

  <Card title="Linux (Debian / Ubuntu)" icon="ubuntu" href="https://procuros-bridge.s3.eu-central-1.amazonaws.com/v1/updates/latest/procuros-bridge-amd64.deb">
    .deb-Paket für x64
  </Card>

  <Card title="Linux (RHEL / Fedora / SUSE)" icon="redhat" href="https://procuros-bridge.s3.eu-central-1.amazonaws.com/v1/updates/latest/procuros-bridge-x86_64.rpm">
    .rpm-Paket für x64
  </Card>
</CardGroup>

<Note>
  Sie müssen nur einmal installieren. Procuros Bridge hält sich im Hintergrund automatisch auf dem neuesten Stand.
</Note>

## Installation unter Windows

<Steps>
  <Step title="Installer herunterladen">
    Laden Sie den Windows-`.msi`-Installer aus dem Abschnitt [Herunterladen](#herunterladen) oben herunter.
  </Step>

  <Step title="Installer ausführen">
    Doppelklicken Sie auf `procuros-bridge-amd64.msi` und folgen Sie den Anweisungen (Administratorrechte erforderlich). Der Installer richtet Procuros Bridge als Windows-Dienst ein, der automatisch startet und auch nach einem Neustart weiterläuft.
  </Step>

  <Step title="Procuros Bridge öffnen">
    Klicken Sie auf das **Procuros Bridge**-Symbol im Windows-Infobereich (Systray) und wählen Sie **Open Dashboard**. Die Bridge-Oberfläche öffnet sich in Ihrem Standardbrowser unter einer lokalen Adresse (zum Beispiel `http://127.0.0.1:1923`).
  </Step>

  <Step title="Mit Procuros verbinden">
    Richten Sie Ihre Verbindung in der Bridge-Oberfläche ein. Wechseln Sie von der vorherigen Version? Siehe [Migration von der bisherigen Bridge](#migration-von-der-bisherigen-bridge), um Ihre bestehende Konfiguration zu übernehmen.
  </Step>
</Steps>

## Installation unter Linux

<Steps>
  <Step title="Paket herunterladen">
    Laden Sie das `.deb`-Paket (Debian / Ubuntu) oder das `.rpm`-Paket (RHEL / Fedora / SUSE) aus dem Abschnitt [Herunterladen](#herunterladen) oben herunter.
  </Step>

  <Step title="Paket installieren">
    Installieren Sie es mit Ihrem Paketmanager. Dadurch wird Procuros Bridge als systemd-Dienst registriert, der automatisch aktiviert und gestartet wird.

    <CodeGroup>
      ```bash Debian / Ubuntu theme={null}
      sudo apt install ./procuros-bridge-amd64.deb
      ```

      ```bash RHEL / Fedora / SUSE theme={null}
      sudo dnf install ./procuros-bridge-x86_64.rpm
      ```
    </CodeGroup>
  </Step>

  <Step title="Procuros Bridge öffnen">
    Führen Sie auf einem Rechner mit grafischer Oberfläche `procuros-bridge open` aus, um die Oberfläche im Browser zu öffnen. Rufen Sie auf einem Server ohne Oberfläche die vom Dienst angezeigte lokale Adresse auf (zum Beispiel `http://127.0.0.1:1923`).
  </Step>

  <Step title="Mit Procuros verbinden">
    Richten Sie Ihre Verbindung in der Bridge-Oberfläche ein. Wechseln Sie von der vorherigen Version? Siehe [Migration von der bisherigen Bridge](#migration-von-der-bisherigen-bridge).
  </Step>
</Steps>

## Migration von der bisherigen Bridge

<Info>
  Dies ist eine einmalige Migration **nur für Kunden, die noch die bisherige Desktop-Bridge verwenden**. Mit Aktualisierungen hat das nichts zu tun: Die neue Procuros Bridge aktualisiert sich im Hintergrund automatisch, sodass Sie nie etwas tun müssen, um die neueste Version zu erhalten.
</Info>

Wenn Sie von der bisherigen Procuros Bridge wechseln, können Sie Ihre gesamte Konfiguration übernehmen – Ihre Profile, Importe und Exporte – ohne etwas neu eingeben zu müssen.

<Accordion title="In 4 Schritten von der bisherigen Bridge migrieren">
  <Steps>
    <Step title="Konfiguration aus der bisherigen Bridge exportieren">
      Öffnen Sie Ihre aktuelle Procuros Bridge und gehen Sie zu **Settings → Configuration**. Lassen Sie unter **Export Configuration** die Option **All profiles** ausgewählt und klicken Sie auf **Export**. Speichern Sie die Datei `procuros-bridge-config.json` an einem Ort, den Sie wiederfinden.
    </Step>

    <Step title="Neue Bridge installieren">
      Installieren Sie die neue Version für Ihr Betriebssystem anhand der Schritte oben ([Windows](#installation-unter-windows) oder [Linux](#installation-unter-linux)).
    </Step>

    <Step title="Konfiguration importieren">
      Öffnen Sie die neue Bridge und gehen Sie zu **Settings → Configuration**. Klicken Sie unter **Import Configuration** auf **Import** und wählen Sie die zuvor exportierte Datei `procuros-bridge-config.json`. Bestehende Einträge werden direkt aktualisiert; neu hinzugefügte Einträge werden **deaktiviert** importiert.
    </Step>

    <Step title="Prüfen und aktivieren">
      Öffnen Sie Ihre Profile, Importe und Exporte, prüfen Sie sie und **aktivieren** Sie die Einträge, die deaktiviert importiert wurden. Stellen Sie sicher, dass sich die Bridge wie erwartet verbindet und synchronisiert.
    </Step>
  </Steps>

  <Warning>
    Betreiben Sie die alte und die neue Bridge nicht gleichzeitig auf denselben Ordnern – beide würden dieselben Dateien verarbeiten. Sobald Sie sich vergewissert haben, dass die neue Bridge funktioniert, stoppen und deinstallieren Sie die bisherige Bridge.
  </Warning>
</Accordion>