hp-setup

hp-setup [LOCATION | SERIAL | IP | HOSTNAME] [-i | --interactive] [-g | --gui] [-h | --help] [-n | --network] [-u | --usb] [-s | --scan] [-f | --fax] [-l | --list] [-r | --replace] [-bBUS#] [-mMODEL] [-pPLUGIN_URI]

-i, --interactive
    Interactive setup mode (default)

-g, --gui
    Launch graphical user interface

-h, --help
    Show help message and exit

-n, --network
    Network (wired/wireless) device setup

-u, --usb
    USB device setup

-s, --scan
    Scan for all available devices

-f, --fax
    Configure fax functionality

-l, --list
    List available devices/plugins

-r, --replace
    Replace existing device/queue

-bBUS#
    Specify USB bus number

-mMODEL
    Specify printer model

-pPLUGIN_URI
    Specify plugin URI

LOCATION
    Device URI, serial, IP, or hostname

hp-setup is a command-line tool from the HPLIP (HP Linux Imaging and Printing) software suite for Linux. It detects, configures, and installs HP printers, scanners, and multifunction devices into the CUPS printing system. The utility supports USB, network (wired/wireless), and manual device specification, automating PPD file installation, print queue creation, and optional fax/scan setup.

In interactive mode, it guides users through device selection and options. Network discovery uses protocols like Bonjour, SNMP, and IPP. USB mode requires device permissions. It also handles proprietary plugin installation for advanced features on supported models.

Typically run with sudo for system changes. Ideal for headless servers or scripted deployments. Success depends on HPLIP version matching printer firmware; check compatibility via hp-check. Provides verbose output for troubleshooting.

Requires HPLIP installed and sudo privileges. Not all HP models fully supported; check hp-support. USB may need udev rules. Network firewall can block discovery.

Some printers need proprietary plugin; auto-downloads or use hp-plugin.

Verbose output with HP_VERBOSE=1; logs in ~/.hplip.

Developed by HP as part of HPLIP since 2005 (version 0.9). Evolved with CUPS integration and network protocols. Maintained by open-source community post-HP divestiture.

hp(1), hp-probe(1), hp-check(1), hp-plugin(1), lpadmin(8), system-config-printer(1)