lprint-server(1)

NAME
lprint-server - start a label print server.

SYNOPSIS
lprint server [ -o OPTION=VALUE ]

DESCRIPTION
This command starts a label print server. Normally a server is started automatically as needed, however you can run the server manually to listen on a public network address and/or enable different logging options.

Server options can be specified on the command-line using the - OPTION=VALUE arguments or in the lprint.conf configuration file.

OPTIONS
The following options are recognized by lprint server:

-o admin-group=GROUP
    Specifies that remote configuration is authenticated against the named group. If not specified or the value "none" is given then any authenticated user may remotely configure lprint.

-o auth-service=SERVICE
    Specifies the PAM service to use to authenticate for remote configuration requests. If not specified or the value "none" is given then printers can only be added, modified, or deleted locally.

-o listen-hostname=HOSTNAME
    Listens for IPP connections on the specified hostname/address(es). If not specified, uses the wildcard addresses to allow connections from any address.

-o log-file=-
    Specifies that all messages are written to the standard error.

-o log-file=syslog
    Specifies that all messages are sent to the syslog service.

-o log-file=FILENAME
    Specifies that all messages are written to the named file. If the file already exists, messages are appended to it. The default log file is "$TMPDIR/lprintUID.log".

-o log-level=debug
    Specifies that all messages should be logged.

-o log-level=error
    Specifies that fatal and error messages should be logged. This is the default.

-o log-level=fatal
    Specifies that only fatal messages should be logged.

-o log-level=info
    Specifies that error, warning, and informational messages should be logged.

-o log-level=warning
    Specifies that fatal, error, and warning messages should be logged.

-o server-hostname=HOSTNAME
    Specifies the hostname for the server. The default is the system hostname.

-o server-options=OPTIONS
    Specifies a comma-delimited list of server options. See "SERVER OPTIONS" below.

-o server-port=PORT
    Listens for IPP connections on the specified port. If not specified, a random port between 8000 and 8999 is chosen.

-o spool-directory=DIRECTORY
    Specifies a directory that holds pending print files. If not specified, a subdirectory in the system temporary directory is used.

-o system-name=NAME
    Specifies the DNS-SD service name for the server. The default is "LPrint".

SERVER OPTIONS
By default, lprint server uses the "multi-queue", "web-interface", "web-log", "web-security", and "web-tls" options. The -o server-options=OPTIONS option can be used to override the default options, where "OPTIONS" is a comma-delimited list of any of the following:

dnssd-host
    When resolving conflicts, add the DNS-SD hostname instead of a serial number or UUID.

no-multi-queue
    Do no support multiple print queues.

raw-socket
    Provide a raw ("JetDirect") socket for each printer on port 91xx.

usb-printer
    Enable a USB printer gadget for the default printer (Linux only for Raspberry Pi and similar embedded SBCs).

no-web-interface
    Disables the web interface.

web-log
    Enables the log file web page.

web-network
    Enables the network settings web page.

web-remote
    Enables remote queue management.

web-security
    Enables the user/password settings web page.

no-tls
    Disables TLS support entirely.

SEE ALSO
lprint(1), lprint-shutdown(1), lprint.conf(5).

COPYRIGHT
Copyright © 2019-2026 by Michael R Sweet.