You are here: Administration > Server management > Change the server address

Change the server address

Change the server address presented to users

Some features in PaperCut require being able to create a link or address for the Application ServerAn Application Server is the primary server program responsible for providing the PaperCut user interface, storing data, and providing services to users. PaperCut uses the Application Server to manage user and account information, manage printers, calculate print costs, provide a web browser interface to administrators and end users, and much more.. One example of this is when using Email to PrintEmail to Print allows any device to print documents by sending an email to your network's print devices. - the verification email sent to users contains a link that they must click. This link must resolve to the PaperCut server both from the internet and from the local network.

The default address presented in these cases is an automatically detected IP address. In some cases this might not be suitable, for example, where it needs to be resolved from the internet.

The recommended approach is to configure a DNS name for your PaperCut server that can be resolved and accessed wherever your users require it. This can involve creating a public/external DNS name and opening the appropriate ports in your firewall. After the name is configured:

  1. Select Options > Advanced.

    The Advanced page is displayed.

  2. In the Server Address area, select DNS name (or other IP).
  3. Enter your chosen (fully qualified) name.
  4. Click Apply.

Change the server port presented to users

In some circumstances, you might also need to customize the server HTTP port presented to users. An example scenario is when a reverse proxy server for WebAuth or Shibboleth SSO is placed in front of the PaperCut NG server. For this situation, PaperCut provides two advanced config keys to allow the user facing server port to be customized: system.network-port-http.user-facing and system.network-port-https.user-facing. (See Using the Config Editor for instructions on using the Config Editor.)

Change the server address presented to external components

In some cases PaperCut publishes its address to external components (e.g. MFDs) to allow them to establish a connection back to the server. The published address is an automatically detected IP address by default. If your server has multiple IP addresses then the detected IP might not be suitable and could cause components to fail to connect.

To resolve this you can configure the network address (e.g. DNS name or IP address) that PaperCut publishes to these external components. To do this use the Config Editor (see Using the Config Editor) to change the system.network-address to your chosen address.

This is configured separately from the Server address presented to users to provide the option to use an IP address for components and a DNS name for users (for example, to avoid DNS lookups on devices that do not cache the result).

PaperCut Site Servers can have their published network address configured by navigating to Sites > (site name) > Configuration > Network address used by devices .


Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.