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

# Install Procuros Bridge

> Download and install Procuros Bridge on Windows or Linux, and migrate from the legacy bridge.

Procuros Bridge runs on the host machine or server connected to your on-premise ERP system and links it to the Procuros network. It runs as a background service, so it keeps syncing after you close the window or restart the machine. Install it once — it updates itself automatically.

## Download

<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 for 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 package for 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 package for x64
  </Card>
</CardGroup>

<Note>
  You only need to install once. Procuros Bridge keeps itself up to date automatically in the background.
</Note>

## Install on Windows

<Steps>
  <Step title="Download the installer">
    Download the Windows `.msi` from the [Download](#download) section above.
  </Step>

  <Step title="Run the installer">
    Double-click `procuros-bridge-amd64.msi` and follow the prompts (administrator rights required). The installer registers Procuros Bridge as a Windows service that starts automatically and keeps running after a reboot.
  </Step>

  <Step title="Open Procuros Bridge">
    Click the **Procuros Bridge** icon in the Windows notification area (system tray), then choose **Open Dashboard**. The Bridge interface opens in your default browser at a local address (for example `http://127.0.0.1:1923`).
  </Step>

  <Step title="Connect to Procuros">
    Set up your connection in the Bridge interface. Moving from the previous version? See [Migrating from the legacy bridge](#migrating-from-the-legacy-bridge) to bring your existing setup across.
  </Step>
</Steps>

## Install on Linux

<Steps>
  <Step title="Download the package">
    Download the `.deb` (Debian / Ubuntu) or `.rpm` (RHEL / Fedora / SUSE) from the [Download](#download) section above.
  </Step>

  <Step title="Install the package">
    Install it with your package manager. This registers Procuros Bridge as a systemd service that is enabled and started automatically.

    <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="Open Procuros Bridge">
    On a machine with a desktop, run `procuros-bridge open` to open the interface in your browser. On a headless server, browse to the local address the service reports (for example `http://127.0.0.1:1923`).
  </Step>

  <Step title="Connect to Procuros">
    Set up your connection in the Bridge interface. Moving from the previous version? See [Migrating from the legacy bridge](#migrating-from-the-legacy-bridge).
  </Step>
</Steps>

## Migrating from the legacy bridge

<Info>
  This is a one-time migration **only for customers still running the legacy desktop bridge**. It has nothing to do with staying up to date: the new Procuros Bridge updates itself automatically in the background, so there's never anything you need to do to get the latest version.
</Info>

If you're moving from the legacy Procuros Bridge, you can carry your full setup across — your profiles, imports, and exports — without re-entering anything.

<Accordion title="Migrate from the legacy bridge in 4 steps">
  <Steps>
    <Step title="Export your configuration from the legacy bridge">
      Open your current Procuros Bridge and go to **Settings → Configuration**. Under **Export Configuration**, leave **All profiles** selected and click **Export**. Save the `procuros-bridge-config.json` file somewhere you can find it.
    </Step>

    <Step title="Install the new bridge">
      Install the new version for your operating system using the steps above ([Windows](#install-on-windows) or [Linux](#install-on-linux)).
    </Step>

    <Step title="Import your configuration">
      Open the new Bridge and go to **Settings → Configuration**. Under **Import Configuration**, click **Import** and choose the `procuros-bridge-config.json` you exported. Existing items are updated in place; newly added items are imported **disabled**.
    </Step>

    <Step title="Review and enable">
      Open your profiles, imports, and exports, review them, and **enable** the items that were imported as disabled. Confirm the Bridge connects and syncs as expected.
    </Step>
  </Steps>

  <Warning>
    Don't run the old and new bridge against the same folders at the same time — both would process the same files. Once you've confirmed the new bridge works, stop and uninstall the legacy bridge.
  </Warning>
</Accordion>