Your company here, and a link to your site. Click to find out more.

cupsctl - Man Page

configure cupsd.conf options

Examples (TL;DR)


cupsctl [ -h server[:port] ] [ -E ] [ -U username ] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ] [ --[no-]share-printers ] [ --[no-]user-cancel-any ] [ name=value ]


cupsctl updates or queries the cupsd.conf file for a server. When no changes are requested, the current configuration values are written to the standard output in the format "name=value", one per line.


The following options are recognized:


Enables encryption on the connection to the scheduler.

-U username

Specifies an alternate username to use when authenticating with the scheduler.

-h server[:port]

Specifies the server address. Note: This option must occur before all others.


Enables (disables) debug logging to the error_log file.


Enables (disables) remote administration.


Enables (disables) printing from any address, e.g., the Internet.


Enables (disables) sharing of local printers with other computers.


Allows (prevents) users to cancel jobs owned by others.


Display the current settings:


Enable debug logging:

    cupsctl --debug-logging

Get the current debug logging state:

    cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'

Disable printer sharing:

    cupsctl --no-share-printers

Known Issues

You cannot set the Listen or Port directives using cupsctl.

See Also

cupsd.conf(5), cupsd(8),
CUPS Online Help (http://localhost:631/help)

Referenced By


CUPS 2022-05-02 OpenPrinting