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

# PaperCut Bridge

> Connect PaperCut MF or NG to Nexudus with the Nexudus Bridge agent, so customers print with their Nexudus details and are charged or use credit automatically.

## Overview

**PaperCut Bridge** connects your PaperCut MF or NG server to Nexudus. A small agent — the **Nexudus Bridge agent** — runs on a Windows computer next to PaperCut. It creates and removes PaperCut users as customers gain and lose access, sends their printing credit to PaperCut, and brings their print jobs back to Nexudus to be charged.

PaperCut Bridge replaces the older [PaperCut extender](/integrations/printing/papercut). The integration is free in Nexudus; you need a PaperCut licence.

<Warning>
  Set aside at least an hour to prepare and set up the integration. If you have a network of locations, set it up from your network location. If each location has its own PaperCut server, each server needs its own Bridge agent.
</Warning>

## Before you start

### A Windows computer

The Bridge agent only runs on Windows. Use the computer that runs PaperCut if you can. It must:

* Stay **switched on at all times** — the agent can't sync while it's off.
* Have a **static IP address**. Find it by running `ipconfig` in Command Prompt and noting the IPv4 address.
* Have the latest version of **.NET** installed.
* Be one you have **admin access** to.

### PaperCut settings

In your PaperCut admin console:

1. **Licence** — make sure your PaperCut MF or NG licence covers everyone who'll print, with some room to grow.
2. **User sync** — in **Options → User/Group Sync**, leave **Primary sync source** empty and tick **Enable internal users**. Nexudus creates your users instead.
3. **Printers** — for each printer customers use, tick **Unauthenticated printer** under **Advanced configuration**, so PaperCut asks customers to sign in to release prints.
4. **Authentication token** — set up a web services authentication token (PaperCut's guide explains how) and keep it safe; you'll need it in Nexudus.
5. **Approved server** — in **Options → Config Editor**, add a comma and your computer's IP address to `auth.webservices.allowed-addresses`, with no spaces.
6. **Password length** — in **Options → Config Editor**, set `internal-users.self-registration.min-password-length` to **8** or more. Customers' PaperCut password is their Nexudus PIN padded with zeros — PIN *12345* becomes *00012345*.

Then choose your [pricing model](/integrations/printing#choosing-how-to-charge-for-printing) and set up its printing credit and product.

## Setting up PaperCut Bridge

<Steps>
  <Step title="Download the agent">
    Go to **Settings → Integrations → PaperCut Bridge (Beta)**, turn on **Enable PaperCut Bridge integration.**, and select **Download Nexudus Bridge Agent**. Move the file to its own folder on the C: drive, for example *C:\Nexudus PaperCut Bridge*.
  </Step>

  <Step title="Get the device ID">
    Open Command Prompt, paste the agent's file path (right-click the file → **Copy as path**), and press Enter. Copy the ID shown after **Register device with ID**.
  </Step>

  <Step title="Register the device in Nexudus">
    Go to **Settings → Devices**, select **Register device**, and enter the ID. Open the new device, rename it *PaperCut Bridge Agent*, and under **Configuration data → host** enter `http://` followed by your IP address and `:9191` — for example `http://192.168.1.20:9191`, with nothing after it.
  </Step>

  <Step title="Install and start the agent">
    Open Command Prompt as administrator, enter the agent's file path followed by ` --install`, and press Enter. Then open **Services** in Windows, right-click **Nexudus Bridge Agent**, and select **Start**.
  </Step>

  <Step title="Finish the settings">
    Back in **Settings → Integrations → PaperCut Bridge (Beta)**, enter your PaperCut authentication token as the **API Key** and the **Bridge Device ID**. Set the options for your pricing model (below), choose the **Location**, and save.
  </Step>
</Steps>

<img src="https://mintcdn.com/nexudus/_vKYV6BblXHm7HHO/images/integrations/int-papercut-bridge.png?fit=max&auto=format&n=_vKYV6BblXHm7HHO&q=85&s=410bfe592e668795de3ca07997f0aba4" alt="PaperCut Bridge settings" width="1440" height="900" data-path="images/integrations/int-papercut-bridge.png" />

## Settings

| Setting | What it does |
| - | - |
| **API Key** | Your PaperCut web services authentication token. |
| **Bridge Device ID** | The ID of the Bridge agent registered in **Settings → Devices**. |
| **New members should be set as unrestricted users in PaperCut by default.** / **New contacts should be set as unrestricted users in PaperCut by default.** | Lets new customers print beyond their credit and be charged per print. Turn on for **pay-per-print only** or **credits and pay-per-print**. |
| **New members registered can print for free by default.** / **New contacts registered can print for free by default.** | Gives new customers free printing. Turn on for **free unlimited printing** only. |
| **Use Pincode as Access Card ID** | Lets customers release prints with their Nexudus PIN. |
| **Printing Credit Type** | The printing credit customers print with. For the credit-based models. |
| **Print Usage Product** | The product customers are charged through per print. For the pay-per-print models. |
| **Location** | The location the integration is for, or **All locations**. |

For **credits only**, leave all four "new members/contacts" switches off.

<Warning>
  Don't change the **Printing Credit Type** or **Print Usage Product** once the integration is running. Changing the credit type invalidates customers' existing printing credit, and changing the product can invoice printing incorrectly.
</Warning>

The "new members/contacts" switches only affect customers created after you turn them on. For existing customers, see below.

## Giving customers access

With **credits only**, customers are added to PaperCut automatically when they get printing credit. For the other models, give them access:

* **In bulk** — use **Settings → Bulk edits** on your customers and, under **Printing**, turn on **Unrestricted user in PaperCut** (pay-per-print models) or **Free unlimited printing via PaperCut** (free printing).
* **One at a time** — on the customer's **Integrations & Services** tab, turn on **Unrestricted user in PaperCut** or **Free unlimited printing**.

The Bridge agent adds and removes PaperCut users every few minutes as customers' access changes. Suspended customers are never added, and email addresses containing `+` aren't supported.

If a customer has several Nexudus accounts with the same email address, they're one user in PaperCut, linked to their **preferred account**. Nexudus picks, in order: the account that already has a PaperCut balance, then one with a portal login, then an active account, then an individual (rather than company) account, then the oldest. Printing credit from all their accounts goes to that PaperCut user, and pay-per-print charges are invoiced to the preferred account.

Deleting a customer in Nexudus doesn't remove their PaperCut user. Suspend them, or turn off their printing options, before you delete them. Turning off the integration doesn't remove PaperCut users either.

## How customers print

1. Customers sign in to the PaperCut web portal with their PaperCut username — their email address with the `@` replaced by a dot, so *[sam@example.com](mailto:sam@example.com)* becomes *sam.example.com* — and their **password**, which is their PIN padded with zeros. They can find their PIN in the Passport app (**My Profile → PIN and Password**) or the members portal (**Settings → Security**).
2. They send their print job, then release it at the printer with their five-digit **PIN code**.

With **ELATEC TWN4 MultiTech 2** readers plugged into your printers, customers can also release prints by holding their phone to the reader with the Passport app.

## Moving from the PaperCut extender

To switch from the older extender, set aside an hour outside opening hours — customers can't print during the move. First turn off **Enable PaperCut integration.** in **Settings → Integrations → PaperCut**, then in Windows **Task Scheduler** open the **Nexudus\_spaces** folder and disable (don't delete) each task. Then follow the setup above.

## Related

* [Printing](/integrations/printing) — pricing models and setting up credits and products
* [Printing credit](/platform/billing/credits/printing-credit) — giving customers printing credit
* [PaperCut (Extender)](/integrations/printing/papercut) — the older PaperCut integration


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.