Skip to content

User Guide

Jump to bottom
DadArcade edited this page Aug 13, 2026 · 3 revisions

Cupsie User & Administrator Guide

Welcome to Cupsie! Cupsie brings native CUPS print server queues and standalone IPP/IPPS network printers directly into your Chrome browser's print dialog.

This guide details enterprise domain administration as well as manual user configuration.

Quick Overview

  1. Enterprise Deployment: Domain administrators can force-install Cupsie silently and push pre-configured print servers across the organization. See Enterprise Deployment Guide.
  2. User Additions: End users can manually add personal CUPS servers or local IPP printers on top of enterprise-managed settings.
  3. Printing: All managed and manually added printers appear directly in Chrome's native print dialog (Ctrl + P / Cmd + P).

Table of Contents

  1. Domain Admin Setup & Enterprise Deployment
  2. Manual Installation & Setup
  3. Adding Personal Printers & CUPS Servers
  4. Granting Chrome Permissions
  5. Printing with Cupsie
  6. Authentication & Saved Passwords
  7. Troubleshooting & IT Support

1. Domain Admin Setup & Enterprise Deployment

Domain Administrators can centrally manage and push Cupsie across all Chrome devices in an organization.

Enterprise Deployment Highlights

  • Zero-Touch Installation: Force-install the extension silently via Google Admin Console or local policy.
  • Pre-Configured Printers: Push default CUPS print servers and standalone IPP printer lists so printers are immediately available to users.
  • Automatic Identity Matching: Map printing requests to active user profiles using ${user_name} placeholders.
  • Policy Protection: Domain-pushed settings are marked (Managed by Policy) in the Options menu and cannot be modified or deleted by end users.

Important

For complete policy schemas, Google Admin Console instructions, and JSON configuration files for Linux/Windows, refer to the Enterprise Deployment Guide.

2. Manual Installation & Setup

If Cupsie is not force-installed by your Domain Administrator, users can install the extension manually:

  1. Open the Cupsie Chrome Web Store Page.
  2. Click Add to Chrome and confirm the prompt.
  3. The Cupsie icon will appear in your Chrome toolbar.
  4. Domain policy will apply to the extension automatically.

3. Adding Personal Printers & CUPS Servers

Users can manually add personal or home network printers. These settings coexist alongside any enterprise-managed printers pushed by your Domain Administrator.

Opening Extension Options

  • Click the Cupsie icon in your toolbar and select Options (or right-click the icon $\rightarrow$ Options).
cupsie-options

Adding Personal CUPS Print Servers

To add custom print servers not pre-configured by your administrator:

  1. Open the Options page and locate CUPS Servers.
  2. Enter your server URLs or IP addresses (one per line): 
    http://192.168.1.10:631
https://cups-server.local
  3. Cupsie automatically discovers print queues on those servers.

Note

Managed servers configured by your Domain Admin are marked as (Managed by Policy) and cannot be removed here.

Adding Personal Standalone IPP/IPPS Printers

To connect directly to a network printer:

  1. Locate Standalone IPP Printers on the Options page.
  2. Enter the details:
    • URL: E.g., ipp://192.168.1.50:631/ipp/print or http://10.0.1.25/ipp/print
    • Name (Optional): Friendly nickname (e.g., Home Color Laser).
  3. Click + Add Another Printer to add more printers.
🔑 Advanced Settings: Requesting Username & Sync Intervals
  • Default Requesting Username: Tells print servers who you are (defaults to "Chrome User" unless set by Domain Policy).
  • Background Sync Interval: Set how frequently (in minutes) Cupsie refreshes printer status in the background.

1. Granting Chrome Permissions

For manually added printers, Chrome requires explicit permission to access devices on your network:

  1. Click the blue Save Settings button at the bottom of the Options page.
  2. Approve Permission Prompt: Chrome displays a browser popup requesting host permissions.

    [!IMPORTANT] Click Allow or Grant. If denied, Chrome blocks Cupsie from reaching manually added network printers. Domain-managed force-installs auto-grant permissions.

  3. Upon approval, a green banner confirms: "Settings saved and printers synced!"
cupsie-permissions

Tip

Chrome Sync: Manually added printers sync across your signed-in Chrome browsers. Local network permissions must be confirmed once per device by clicking Save Settings.

1. Printing with Cupsie

  1. Open Chrome's print dialog using Ctrl + P (Windows/Linux) or Cmd + P (macOS).
  2. In the Destination dropdown, select your printer. Both Domain-Managed and manually added printers appear here.
  3. Custom printer settings (paper trays, duplexing, quality) can be adjusted under printer options.
  4. Click Print!

1. Authentication & Saved Passwords

If a domain printer or personal printer requires authentication, a Printer Login Required window will pop up automatically when printing.

Logging In

  1. Enter your Username and Password in the prompt.
  2. Click Save Credentials. Cupsie verifies them immediately:
    • ✅ Green message: Credentials verified; dialog closes automatically.
    • ❌ Red message: Invalid login; check credentials and retry.
  3. Check "Don't ask again" to save credentials for that printer.

Managing Stored Logins

  • View saved logins under Stored Credentials on the Options page.
  • Click the ✕ button next to an entry to delete credentials, then click Save Settings.

1. Troubleshooting & IT Support

Issue Cause Action
Printers missing in print dialog Unreachable server or missing permissions Verify network connectivity. For manual printers, click Save Settings in Options and grant permissions.
HTTP 401 / 403 Unauthorized Authentication required Enter valid user credentials in the login prompt.
Network Connection Failed Printer offline or wrong subnet Ensure printer is powered on and connected to the corporate/local network.
Proxy / Firewall Block (HTTP 407) Intercepting proxy or network block Contact your Domain Administrator to verify proxy rules.

Diagnostic Logs for IT Administrators

  1. Open the Options page and click View Troubleshooting Logs →.
  2. Click Download Log to export a diagnostic .txt log file. Send this file to your IT / Domain Administrator for fast troubleshooting.

Clone this wiki locally