---
name: "cupsctl"
section: "8"
platform: "linux"
package: "cups"
version: "2:2.4.20-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/cupsctl"
---

# cupsctl(8)

configure cupsd.conf options

## NAME

cupsctl - configure cupsd.conf options

## SYNOPSIS

**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* \]

## DESCRIPTION

**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.

## OPTIONS

The following options are recognized:

- **-E**

  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.

- **--**\[**no-**\]**debug-logging**

  Enables (disables) debug logging to the *error\_log* file.

- **--**\[**no-**\]**remote-admin**

  Enables (disables) remote administration.

- **--**\[**no-**\]**remote-any**

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

- **--**\[**no-**\]**share-printers**

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

- **--**\[**no-**\]**user-cancel-any**

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

## EXAMPLES

Display the current settings:

```
    cupsctl
```

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.conf/5.md), [**cupsd**(8)](/cupsd/8.md),\
 CUPS Online Help (http://localhost:631/help)

## COPYRIGHT

Copyright © 2020-2024 by OpenPrinting.