Skip to main content

Giraffe Print Service for Windows

Run print jobs automatically in the background — no need to keep the desktop app open.

Written by T Campbell

What is the Giraffe Print Service?

The Giraffe Print Service is a Windows background service that automatically picks up print jobs from Elevated Signals and sends them to your configured printers. Once installed, it runs silently in the background, even when no one is logged in to the computer.

Perfect for:

  • Shared workstations where users log in and out

  • Dedicated print stations that need to run 24/7

  • Environments where the Giraffe desktop app can't stay open

⚠️ Important: Only run one of the Giraffe desktop app or the Giraffe Print Service at a time — not both. Running both simultaneously will cause duplicate print jobs. If you install the Print Service, you should close and can safely uninstall the desktop app.


Requirements

Before you begin, make sure you have:

  • Windows 10/11 recommended

  • Node.js 22.15 or higherDownload here (24 LTS recommended)

  • Administrator access to install the Windows service

  • Network access to reach the Elevated Signals API

💡 Tip: You can check your Node.js version by opening Command Prompt and running node --version

⚠️ Note: Node.js 22.15 is the minimum. Some network configurations need a Node.js setting that older versions do not support — see Troubleshooting below.


Installation

  1. Run the installer as Administrator

  2. Follow the prompts to complete installation

  3. The installer will automatically:

  4. Install the service files

  5. Register the Windows service

  6. Open the configuration prompt


Getting Started

After installation, you'll need to log in and configure your printers.

Step 1: Log in to your account

Open Command Prompt and run:

giraffe-service login --domain dashboard

This opens your browser to complete the login. Once authenticated, you'll see a success message.

Step 2: View available printers

See which printers are configured in Elevated Signals:

giraffe-service list-printers

Step 3: Start the service

Start the service to start polling for print jobs:

giraffe-service start

Step 4: Verify everything is working

Check the service status:

giraffe-service status

You should see your enabled printers and connection status.


CLI Command Reference

Command

Description

login [--domain <name>]

Log in to your Elevated Signals account

test-connection

Test connectivity to the API

show-config

Display current configuration

list-printers [--local]

List available printers. Use --local to see system printers

enable-printer <id>

Enable a printer for automatic job polling

disable-printer <id>

Disable a printer

status

Show service status and configuration

logs [--lines <count>]

View service logs (default: 50 lines)

install

Install the Windows service

uninstall

Remove the Windows service

start

Start the service

stop

Stop the service


Troubleshooting

Print jobs stay in "Pending" and never print

The usual cause is that the service is installed and running, but not logged in.

A service that shows as Running in Windows Services can still be logged out. Windows only reports that the program is running — not that it has valid credentials. This is why the service can look perfectly healthy while nothing prints.

Check the credentials first:

giraffe-service status

If you see no credentials found, log in again:

giraffe-service login --domain dashboard

Then confirm jobs are being picked up:

giraffe-service logs

💡 If the printer itself is the suspect — nothing prints at all, or the output is blank or misaligned — see How To Troubleshoot Giraffe for printer hardware checks.

Login fails with "self-signed certificate in certificate chain"

If giraffe-service login fails with a message like:

Token exchange failed: request to https://dashboard.elevatedsignals.com/api/new/oauth2/token
failed, reason: self-signed certificate in certificate chain

then your network is inspecting HTTPS traffic. This is common with corporate security gateways (Netskope, Zscaler, and similar) and with some antivirus products. They re-sign traffic with your organisation's own certificate authority. Windows trusts that authority, so your browser accepts it — but Node.js, which the print service runs on, keeps its own separate list of trusted authorities and does not.

The telltale sign: you can log in to Elevated Signals in a browser on that same computer, but the print service cannot.

This often appears after a network change with no change to the printer or the computer — a new security gateway, a domain migration, or a certificate rotation.

How to fix it

Open PowerShell as Administrator and run:

setx NODE_OPTIONS "--use-system-ca" /M

Then restart the computer.

Both steps are required. Without Administrator the command is denied (access to the registry path is denied), and without the restart the running service never sees the change — login will keep failing.

This tells Node.js to also trust the certificate authorities Windows already trusts. It does not disable any security checking; certificates are still fully validated.

After the restart, verify:

node -e "console.log(process.env.NODE_OPTIONS)"
giraffe-service login --domain dashboard
giraffe-service list-printers

The first command should print --use-system-ca. Then print a test label from Elevated Signals to confirm.

⚠️ This has to be done on each computer running the print service.

💡 The permanent fix is on the network side. Ask your IT or network team to exclude *.elevatedsignals.com from HTTPS/SSL inspection — often called a "do not decrypt" or "bypass" rule. That covers every workstation at once and survives certificate rotations and Node.js upgrades, so the problem cannot come back.

⚠️ Do not use NODE_TLS_REJECT_UNAUTHORIZED=0. It appears to fix the problem, but it switches off certificate validation entirely for that program — not something you want on a service that holds login credentials.

Still stuck?

Collect this before contacting support — it saves a round trip:

giraffe-service status
giraffe-service show-config
giraffe-service logs --lines 100
node --version

🌟 Please don't hesitate to reach out to our Support Team should you require any further assistance!


Frequently Asked Questions

Does the service start automatically after a reboot?

Yes! Once installed, the service is configured to start automatically when Windows starts.

If the service is not starting automatically after a reboot, you can verify and configure it using the Windows Services manager:

  1. Open the Start menu and search for Services

  1. Find Giraffe Print Service in the list. Check the Startup Type column — it should say Automatic.

  1. If it doesn't say Automatic, right-click the service → Properties, then set Startup type to Automatic and click OK.

How do I change the polling interval?

The service checks for new print jobs every 10 seconds by default. If you need faster printing, you can reduce this interval:

  1. Stop the service:

giraffe-service stop 2. Open the config file in Notepad:

notepad C:\ProgramData\Giraffe\config.json 3. Find the "pollingIntervalMs" value and change it. For example, to check every 3 seconds:

"pollingIntervalMs": 3000 4. Save the file and start the service:

giraffe-service start

⚠️ Note: Setting the interval below 3000ms (3 seconds) is not recommended as it may increase API load.

Did this answer your question?