System Client

CirrusPrint client software must be installed at each remote location that will receive jobs from the server.  Each client can be configured to connect to one or more CirrusPrint servers, login as a location, and accept jobs for that location.  The location ID can be considered an actual location, servicing printers and files for all users of a system, or different users can be assigned unique location ID's and run their own copies of the client software.  In either case, the client receives jobs and delivers them to local printers or files.

The client is available on both Linux and Windows.

Profiles

The client supports multiple profiles, if needed, to enable it to connect to multiple CirrusPrint servers.  Each profile is started as a separate task and writes to its own log files.  Profile settings are stored in the same config file in different sections prefixed with a [name] header line.  The default profile is named "settings", and it should not be deleted.

The client runs under the user that launches it, and the configuration is based on that user's private data store, based on the HOME environment variable under Linux, or the APPDATA environment variable on Windows.  When setting it up to run as a service, it is important to perform configuration steps while logged in as the same user as the service.

Linux

The Linux client is a command line tool, which is written in Node.js.  The Node.js interpreter is a requirement, and the installation script will attempt to install it it isn't already on the system.  If installed by the root user, the client is also automatically setup to run at boot time.  The client is run with the command cp20c, a script created in /usr/bin.  Numerous command line options are provided.  For details, enter man cp20c.

Windows

The Windows client includes a graphical management tool, cp20c.exe, and also includes the command line node client.  Shortcuts to the management tool are added to the Start menu and desktop during the installation.  Use this tool to configure the client settings, and to start, stop, install or uninstall as a service, or install or uninstall on a user's personal Startup menu.  Note that to install or manage a service, you must be running the client as an administrator.

The Windows environment also can run a command line client with a full node.exe command line.  Node.exe is bundled with the Windows client.

cp20c.node.exe cp20c.node.js options