--- title: "Migrating to PaperCut Bridge" slug: "migrating-to-papercut-bridge" updated: 2026-02-03T17:53:16Z published: 2026-02-03T17:53:16Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.nexudus.com/llms.txt > Use this file to discover all available pages before exploring further. # Migrating to PaperCut Bridge The PaperCut extender has been replaced by the new PaperCut bridge integration. Use this guide if you are migrating from the PaperCut extender. Check out [Preparing your PaperCut Bridge Integration](/v3/docs/preparing-your-papercut-bridge-integration) if you're integrating PaperCut for the first time. We recommend setting aside at least 60 minutes outside of your space's operating hours to set up the integration. Customers won't be able to print while you migrate from the extender to the bridge agent. Setting up the integration for a network? Make sure you complete these steps from your network location. If you have an individual PaperCut server for each location, you'll need to complete the migration process for each location, as each PaperCut server requires its own dedicated bridge agent. ## Step 1: Disable the PaperCut Extender You need to disable the extender before you can set up the PaperCut bridge integration. 1. Log in to [dashboard.nexudus.com](https://dashboard.nexudus.com/) if you aren't already. 2. Go to [**Settings > Integrations > PaperCut**](https://dashboard.nexudus.com/settings/integrations/papercut). 3. Toggle off **Enable PaperCut integration**. 4. Click the **Save Changes** button. 5. On your device, open **Task Scheduler** from Windows Search. ![PaperCutBridgeTaskScheduler.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutBridgeTaskScheduler.png) 1. Open the folder named **Nexudus_spaces**. 2. Right-click and select **Disable** for each task. We don't recommend deleting the tasks. --- All set! The next step is to review your device settings. ## Step 2: Review your Device Settings While PaperCut MF and NG are available on all operating systems, including macOS, the Nexudus bridge integration only works with **devices running Windows**. We recommend installing Nexudus bridge on the same device as your PaperCut driver. You need admin access to your device in order to set up the integration. The device you use to run the bridge integration must be turned ON at all times. The bridge can't regularly sync print jobs and users when you turn off the device. You'll also need your device's IP address. You can easily find your device's IP address by opening a command prompt from Windows Search and entering the command **ipconfig**. Your device must be configured with a static IP address to run the integration. Make a note of your IPv4 address, which is a set of four numbers separated by periods. You'll need this address at two steps in the integration process: when you [define your PaperCut Settings](/v3/docs/migrating-to-papercut-bridge#step-3-review-your-settings-in-papercut) and when you [set up the integration](/v3/docs/migrating-to-papercut-bridge#step-4-set-up-the-papercut-bridge-integration). You should also make sure you're running the latest version of [.NET](https://dotnet.microsoft.com/en-us/download) on your device. Once you've reviewed your device settings, the next step is to review your settings in PaperCut. ## Step 3: Review your Settings in Papercut The settings you've already configured in PaperCut for the extender will remain the same for the bridge agent. You also need to complete three additional steps in PaperCut: [setting up an authentication token](/v3/docs/migrating-to-papercut-bridge#setting-up-an-authentication-token), [adding your IP address as an approved server](/v3/docs/migrating-to-papercut-bridge#adding-your-ip-address-as-an-approved-server), and [setting your minimum password length](/v3/docs/migrating-to-papercut-bridge#setting-your-minimum-password-length). ### Setting up an Authentication Token You'll need to set up an authentication token so that the bridge agent can communicate with PaperCut. You can follow [PaperCut's instructions](https://www.papercut.com/help/manuals/ng-mf/common/tools-web-services/#web-services-api-security) to set up this token. You'll need to add it in Nexudus when you set up the integration. Treat your authentication token as you would any other password. Store it in a safe location and don't share it with anyone. ### Adding your IP Address as an Approved Server You'll also need to add your IP address to the list of approved servers. 1. Go to **Options > Config Editor** on the PaperCut Admin Panel. 2. In the field next to **auth.webservices.allowed-addresses**, add a comma and your IP address. PaperCut Approved Server Format - Make sure you add a comma between the IP addresses - Make sure there are no spaces before or after your IP address ✅ **Correct Format** ![PaperCutApprovedServerAddressCorrectFormat.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutApprovedServerAddressCorrectFormat.png) ❌ **Incorrect Format** ![PaperCutApprovedServerAddressIncorrectFormatSpace.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutApprovedServerAddressIncorrectFormatSpace.png) 1. Click **Update**. ### Setting your Minimum Password Length You'll need to set a minimum password length of 8 digits or more in PaperCut to allow customers to log in to the client portal to print. The password will always be the customer's PIN code in Nexudus preceded by several zeroes. 1. Go to **Options > Config Editor** on the PaperCut Admin Panel. 2. In the field next to **internal-users.self-registration.min-password-length**, enter a digit that is **8** or higher. 3. Click **Update**. Customers will now be able to log in to the PaperCut client portal using their Nexudus PIN code preceded by several zeroes. *For example, if a customer's PIN code in Nexudus is **12345** and you set the minimum password length to **8**, the customer's password will be **00012345**.* Customers will still use their 5-digit Nexudus PIN code to release prints. Once you've configured your settings in PaperCut, the next step is to begin the integration process. ## Step 4: Set up the PaperCut Bridge Integration The final step is to set up the bridge integration on your device. [Embedded content](https://www.youtube.com/embed/vKsCW_YmM5E) --- 1. Log in to [dashboard.nexudus.com](https://dashboard.nexudus.com/) if you aren't already. 2. Go to [**Settings > Integrations > PaperCut Bridge**](https://dashboard.nexudus.com/settings/integrations/papercut-bridge). 3. Toggle on **Enable PaperCut Bridge integration**. 4. Click **Download Nexudus Bridge Agent**. *Your file may take a few moments to download.* 1. In your device's **C: drive**, create a folder with the name *Nexudus PaperCut Bridge*. 2. Move the file from your *Downloads* folder to the *Nexudus PaperCut Bridge* folder. Running multiple bridge agents on the same device? Make sure each agent is in a separate folder. 1. Open **Command Prompt** on your device. You need admin access to your device to complete this step. How do I open Command Prompt? 1. Look for **Command Prompt** using Windows Search. 2. Select **Open**. ![PaperCutBridgeCommandPrompt.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutBridgeCommandPrompt.png) 1. Add the file path to the location where you stored the bridge agent. How do I find the file path to the bridge agent? 1. Go to where the agent is stored on your device. 2. Right-click and select **Copy as Path**. 3. Paste the path directly into the command prompt using **Ctrl + V**. ![BridgeDeviceRegisterInput_Example.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/BridgeDeviceRegisterInput_Example.png) 1. Tap **Enter**. *You should get an output similar to the one shown below* ![BridgeDeviceRegisterOutput_Example.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/BridgeDeviceRegisterOutput_Example.png) 1. Copy the device ID after **Register device with ID**. *Close the command prompt window and return to the Nexudus Admin Panel.* 1. Go to [**Settings > Devices**](https://dashboard.nexudus.com/settings/4/7/0). 2. Click **Register device**. 3. Enter your device ID. 4. Click **Register device**. 5. Click on the device you've just registered. 6. Rename your device to **PaperCut Bridge Agent**. 7. Under **Configuration data > host**, enter **http://** followed by your **IP address** followed by **:9191** PaperCut Server Address Format - Use **HTTP** protocol - Leave no spaces or slashes after your address | ✅ **Correct Format** | ❌ **Incorrect Format** | | --- | --- | | ![PaperCutServerAddressCorrectFormat.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutServerAddressCorrectFormat.png) | ![PaperCutServerAddressIncorrectFormatHTTPS.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutServerAddressIncorrectFormatHTTPS.png) ![PaperCutServerAddressIncorrectFormatSlash.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/PaperCutServerAddressIncorrectFormatSlash.png) | 1. Click the **Save Changes** button. *Open a new command prompt.* 1. Enter the file path to the location where you stored the bridge agent followed by a space and **--install**. ![BridgeDeviceInstallInput_Example.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/BridgeDeviceInstallInput_Example.png) 1. Tap **Enter**. *You should get an output similar to this:* ![BridgeDeviceInstallOutput_Example.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/BridgeDeviceInstallOutput_Example.png) *Close the command prompt and open the services console on your device.* How do I open the services console? 1. Use Windows Search to find **Services**. 2. Click **Open.** 1. Scroll down to the **Nexudus Bridge Agent**. 2. Right-click on the agent and select **Start**. *Return to the Nexudus Admin Panel.* 1. Go to [**Settings > Integrations > PaperCut Bridge**](https://dashboard.nexudus.com/settings/integrations/papercut-bridge). 2. Enter your authorization token from PaperCut. Where can I find my PaperCut authorization token? You can find your authorization token in your PaperCut admin panel under **Options > Config Editor > auth.webservices.auth-token**. 1. Enter your Nexudus bridge device ID. This is the same ID you used to register your device in Step 8. You can also find this ID in your device's services console by clicking on **Nexudus Bridge Agent**. 1. Enable the following toggles based on your PaperCut [pricing model](/v3/docs/papercutbridge-pricing-examples). - **Pay-per-print Only** or **Credits & Pay-per-print** Enable **New members should be set as unrestricted users in PaperCut by default** and **New contacts should be set as unrestricted users in PaperCut by default**. - **Credits Only** Make sure all four toggles are **disabled**. - **Free unlimited printing** Enable **New contacts registered can print for free by default** and **New members registered can print for free by default**. 1. Toggle on **Use Pincode as Access Card ID** if you'd like customers to be able to use their PIN code to release PaperCut prints. 2. Under **Printing Credit Type**, add your printing credit if you're using the **Credits Only** or **Credits & Pay-per-print** pricing model. 3. Under **Print Usage Product**, add your product dedicated to printing if you're using the **Pay-per-print Only** or **Credits & Pay-per-print** pricing model. 4. Select the locations where you'd like to enable the integration. 5. Click **Save changes**. --- All set! Now that you've successfully set up the integration, the bridge agent will sync any changes between PaperCut and Nexudus in minutes. New customers will be given access according to the settings you've enabled above or when you [give them printing credits](/v3/docs/managing-printing-credits). You can also [transfer customers individually](/v3/docs/transferring-users-with-papercut-bridge##transferring-users-individually) if needed.