Find your dream job at PaperCut

Choose your language

Choose your login

Contact us

Help Center menu


PaperCut NG & PaperCut MF Manual


Groups in PaperCut NG/MF

Groups are collections of users. PaperCut NG/MF sources groups and group members from a selected directory/domain source, enabling SysAdmins to take advantage of the existing network structure. Groups in PaperCut are used in the following ways:

  • To control how quota/credit is allocated to users on a regular basis.

  • To automate the addition of new (future) user accounts.

  • To assist with making modifications to user accounts by group.

  • For group-based reporting.

  • To filter/restrict user behavior and access.

  • For use with Print Deploy to determine which users are sent which print queues.

PaperCut NG/MF mirrors (caches) domain network group memberships for performance reasons. Therefore, changes in group membership made at the domain level might not be immediately reflected in PaperCut. To see the changes immediately, you just need to refresh the group membership.

Refresh group membership

  1. Select Options > User/Group Sync.
    The User/Group Sync page is displayed.

  2. Click Synchonize now.
    Groups are mirror/cached for two reasons:

    • For fast reporting and search performance.

    • To ensure PaperCut NG/MF is a good network application and does not overload domain controllers with group membership requests.

Large networks can contain hundreds of groups and/or organizational units. In many cases only a small percentage of these groups are pertinent to PaperCut NG/MF management. To ensure administrators are not overwhelmed with all groups, PaperCut NG/MF only lists the groups that the administrator selected as relevant.

Add an imported group to the PaperCut NG/MF Group List

When you import users into PaperCut NG/MF from a user directory, the groups in that directory are also imported. The groups are not, however, automatically displayed in the Group List. You need to add the required groups to the Group List.

  1. Click the Groups tab. The Group List page is displayed.

  2. In the Actions menu, click Add/Remove groups. The Add/Remove Groups page is displayed.

  3. On the left side, select the group(s) required; then click the Add arrow.

  4. Click Apply.

Adding/removing groups

Define a group via a text file

There are some situations where it’s not possible to maintain groups within the network directory source, for example, you might not have read-access to the domain.

If it’s not possible to define the required groups using your network directory, you can define them via a text file (for example, a tab-delimited file). There’s an example template and further information in the file called additional-groups.txt.tmpl in [app-path]/server/data/conf/.

You need to place your group definition file in the same directory.

  1. Go to [app-path]/server/data/conf/ and open additional-groups.txt.tmpl

  2. Update the file with all of your users.

    The format is a simple, tab-delimited list of groups and their associated users, with one group and one user per line, for example:

    group-1 johnnie

    group-1 kellyschultz

    group-2 johnnie



  3. Save the file as additional-groups.txt in [app-path]/server/data/conf/

Bypass LDAP connections using a text file

You can create an additional-groups.txt file both to create new groups in PaperCut NG/MF and to populate those groups with existing PaperCut NG/MF users.

Ordinarily, if you’ve configured LDAP as your primary user sync source (under Options > User/Group sync), PaperCut NG/MF still reaches out to your LDAP directory server to verify the group memberships you have defined in additional-groups.txt. It tries to override the Group settings you have configured manually via your additional-groups.txt file and can cause errors when searching for new groups.

If you use LDAP for authentication, however, you might prefer to define groups using a text file instead of relying on LDAP. This prevents any LDAP searches while executing Add/Remove groups.

  1. Define a group via a text file.

  2. In the Admin web interface, click Options.

  3. In the Actions menu, click Config editor (advanced).

  4. Find the config key and update the value to Y.