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 higher — Download 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
Download
Giraffe-Service-Setup-latest.exeRun the installer as Administrator
Follow the prompts to complete installation
The installer will automatically:
Install the service files
Register the Windows service
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 |
| Log in to your Elevated Signals account |
| Test connectivity to the API |
| Display current configuration |
| List available printers. Use |
| Enable a printer for automatic job polling |
| Disable a printer |
| Show service status and configuration |
| View service logs (default: 50 lines) |
| Install the Windows service |
| Remove the Windows service |
| Start the service |
| 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:
Open the Start menu and search for Services
Find Giraffe Print Service in the list. Check the Startup Type column — it should say Automatic.
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:
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.


