lprint-server(1)

🎀 NAME 🎀

lprint-server — start a label print server.

This is the lprint-server(1) manual page from Michael R Sweet, bestie, and it's here to explain how to start a label print server without making you cry. 💖

✨ 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 -E 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 — Does not 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 🌈

Go check out lprint(1), lprint-shutdown(1), and lprint.conf(5). ✨

👑 COPYRIGHT 👑

Copyright © 2019-2026 by Michael R Sweet.

---

💖 That's the whole manual page, bestie — LPrint edition, dated 2026-06-03, and yes, the page is lprint-server(1). 🎀