Available in PaperCut NG and PaperCut MF.

Install a Site Server

Site Servers are an architectural component of the PaperCut solution. Setup is a straightforward process. Like most architecture projects, the time is best spent planning.

Step 1: Planning

Planning is the most critical step of a successful Site ServerSite Servers take over the role of a Primary Application Server in the event of network outages. Key roles taken over include authentication, copy and print tracking and Find-Me printing. Site Servers ensure continuous availability of printing resources to support key business functions over unreliable network links or during unplanned network disruptions. deployment. Take a few moments prior to installation to run through a checklist of items:

Step 2: Apply your license

Your Application Server must be licensed for Site Servers before installing the Site Server software.

Step 3: [optional] Import a trusted signed certificate

Some MFDs may see a self-signed certificate error during the embedding process. Installing a signed certificate on your Site Server helps to prevent that from occurring and hardens your PaperCut server against a MitM attack.

To install a signed certificate on your Site Server, the process is almost identical to the steps you take to install one on your Primary PaperCut Application Server. Follow our steps on how to Installing an SSLSecure Sockets Layer (SSL) is the standard security technology for establishing an encrypted link between a web server and a browser. This link ensures that all data passed between the web server and browsers remain private and integral. The protocol uses a third party, a Certificate Authority (CA), to identify one end or both end of the transactions. To be able to create an SSL connection a web server requires an SSL certificate. When you choose to activate SSL on your web server you will be prompted to complete a number of questions about the identity of your website and your company. Your web server then creates two cryptographic keys - a Private Key and a Public Key. Certificate the Easy Way, but when generating your certificate make sure that the Common Name (CN) or Subject Area Name (SAN) is that of your Site Server.

Step 4: Installation

Before installing a Site Server, verify that the primary server (central Application Server) is set up and running correctly.


On a Windows server, install the Site Server software by selecting the Site Server installation (advanced) option in the installation wizard. If the PaperCut primary server software was previously installed on the server, uninstall it prior to installing the Site Server software.


Follow the existing Quick install: Linux (CUPS and/or Samba) section of the PaperCut manual, with the additional parameter of ––site-server when executing the installer.


On a Mac server, install the Site Server by downloading the latest Mac DMG disk image and run the contained installer called PaperCut NG/MF Site Server Install (advanced).pkg


It is recommended that you restrict Site Server connections to the Application Server to a fixed set of IP addresses. To specify the list of IP addresses or subnets that are allowed to submit information to the Application Server, see Restrict access to the Application Server.

Step 5: Post installation setup

  1. Set a unique name for the Site Server you are configuring.

  2. Enter the name or IP of the Application Server this Site Server connects to.

  3. Enter the credentials of a user with administrator access to PaperCut on the primary server.

    The Site Server is now connected to the Application Server and begins the data synchronization process.

  4. The Site Server requires no additional configuration at the local machine. You can use the Login link under the Application Server image to access the PaperCut Admin web interface. The Sites tab is now available.

  5. Select Sites > Offline Policies to set the Offline Policies for your installation.

Advanced Site Server configuration

The majority of the Site Server configuration is done in the Admin web interface, however, there are additional configuration options available in the print-provider.conf file.

Connect multiple print servers to a Site Server

If you have installed the Site Server onto an existing PaperCutConfiguring secondary print servers and locally attached printers, the Print ProviderA Print Provider is a monitoring service installed on a secondary print server to allow PaperCut to control and track printers. This monitoring component intercepts the local printing and reports the use back to the primary Application Server. is automatically configured to work with the new Site Server. However, if you have more than one print server connected to the Site Server, the Print Provider on these servers needs to be upgraded to the same version of the Application Server and also configured in the following file to connect to the Site Server address:

  1. Open the following file in a text editor:


  2. Locate the line starting with ApplicationServer= then enter the Site Server IP address. For example:


  3. Locate the line starting with ApplicationServerPort= then enter the port connecting to the Site Server. For example:


  4. Restart the server running Print Provider. If you do not want to restart the server, manually restart the PaperCut Print Provider service.

Connect directly with the Application Server when the Site Server is down

With the standard configuration, if your Site server is unavailable, the Print Providers will not work, even if the Application Server is available. You can, however, configure your Print Providers to attempt to connect directly with the Application Server if the Site Server is unavailable.

  1. Open the following file in a text editor:


  2. Add a new line with RedirectFallbackServer= then the Application Server IP address and port. For example:


  3. Restart the server running Print Provider. If you do not want to restart the server, manually restart the PaperCut Print Provider service.

MFD configuration

Configure embedded devices to use the Site Server as their hosting Server. You can add new devices to the Site Server directly, or migrate existing devices to the Site Server, without losing device history.

Implementations of embedded solutions vary according to manufacturer, however, they can be broadly grouped into two categories.

  • Devices that connect to PaperCut.

    Follow the installation guide for your particular device, taking care to enter the Site Server address where the Application Server address is usually entered.

  • Devices that PaperCut connects to.

    Follow the installation guide for your particular device. When configuring a new device, select the server that this device is hosted on.

    The device record also presents an option for administrators to change this Hosted on value at any time in the future. This allows for a device to be moved from one server to another.

  • You can view which server is currently hosting each of your devices in the Device List page of the Admin web interface.

  • Depending on the device, you can allow users to change the settings of held print jobs at the device if the Site Server is available but Application Server is unavailable. For more information, see Changing attributes of print jobs at the device.

Release Station configuration

The Standard Release Stations and Mobile Print Release—releasing print jobs using your mobile device apps are both supported by the Site Server to allow held jobs to be released in both online and offline operation.

Testing your installation

The Sites tab of the Admin web interface shows at a glance the status of all Site Servers. While the Site Server is connected, PaperCut operates as per normal.

To verify that your Site Server is providing resilience, you can take the site offline. You can achieve this by simulating network failure (pulling the plug), or by disabling the site in the Sites tab.

  1. On the Sites tab, select the site.

  2. In the Site Connection area, choose Disable connection (force offline).

  3. Click Apply.

You can validate the site as being in offline mode using the Site Server URL (http://[Site Server]:9191/admin). Printing and copying should continue according to the offline policiesOffline Policies allow an Administrator to define PaperCut's behaviour when there is an outage that disrupts PaperCut normal operations. Offline policies include account selection policy (the default account to charge (default is "Offline account")), offline credit policy (whether to assume credit is available or to deny the job when the Application Server is unavailable), user authentication policy (the behavior in offline mode where PaperCut cannot validate the owner of the job), and User Password Authentication (whether user authentication is attempted during a network outage). defined in the installation section. Validating the application of the policies via copy and print transactions ensures your settings have been applied correctly.

To complete the test, return the Site to online by selecting Enable connection in the Site record. Validate your transactions have been uploaded to the Application Server by searching either the User, Device, Printer, or Job log.


Version upgrades to the Application Server result in the Site Servers supporting their local site in offline mode until they are also upgraded. Make sure you upgrade the Site Servers as part of your upgrade procedure.