OpenPrinting CUPS

<!doctype html> <html lang="en"> <head> <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-T3c6CoIi6uLrA9TneNEoa7RxnatzjcDSCmG1MXxSR1GAsXEV/Dwwykc2MPK8M2HN" crossorigin="anonymous"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.2/font/bootstrap-icons.min.css"> <link rel="stylesheet" type="text/css" href="/cups/css/cups.css"> <link rel="shortcut icon" href="/cups/apple-touch-icon.png" type="image/png"> <meta charset="utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=9"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>OpenPrinting CUPS</title> <meta name="keywords" content="printing,printer driver,internet printing protocol,ipp,ipp everywhere,ppd,linux,unix,mac,os x,postscript,pdf,text,image"> </head> <body> <nav class="navbar navbar-expand-md navbar-dark bg-dark" role="navigation"> <div class="container-fluid"> <a class="navbar-brand" href="/cups/index.html"><img src="/cups/images/cups.png" width="32" height="32" alt="OpenPrinting CUPS"></a> <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#cups-nav-collapse" aria-controls="cups-nav-collapse" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <div class="collapse navbar-collapse" id="cups-nav-collapse"> <ul class="navbar-nav"> <li class="nav-item"><a class="nav-link" href="cups3.html">CUPS v3</a></li> <li class="nav-item"><a class="nav-link" href="https://subspace.kernel.org/lists.linux.dev.html"><i class="bi bi-chat-left-text-fill"></i> Mailing List</a></li> <li class="nav-item"><a class="nav-link" href="https://github.com/openprinting/cups/issues/new"><i class="bi bi-bug-fill"></i> Report a Bug</a></li> <li class="nav-item"><a class="nav-link" href="https://github.com/openprinting/cups"><i class="bi bi-github"></i> Repository</a></li> <li class="nav-item"><a class="nav-link" href="https://github.com/openprinting/cups/wiki"><i class="bi bi-diagram-2-fill"></i> Wiki</a></li> </ul> <form action="https://duckduckgo.com/" method="get" class="d-flex ms-auto me-0"> <input type="hidden" name="sites" value="openprinting.github.io/cups"> <input class="form-control" style="width: 80%;" type="search" name="q" placeholder="Search" aria-label="Search"><button class="btn btn-primary mr-0" type="submit"><i class="bi bi-search"></i></button> </form> </div> </div> </nav>  <div class="container-fluid"> <div class="row"> <div class="col col-md-9"> <h1>OpenPrinting CUPS</h1> <p>The current standards-based, open source printing system developed by <a class="jumbolink" href="https://openprinting.github.io/" target="_blank">OpenPrinting</a> for Linux® and other Unix®-like operating systems. CUPS uses <a href="https://www.pwg.org/ipp/everywhere.html" target="_blank">IPP Everywhere™</a> to support printing to local and network printers.</p> <p style="line-height: 2;"> <span class="float-end fs-5 mt-2"> <a href="#INTRO">Introduction</a> · <a href="#HISTORY">History</a> · <a href="#SETUP">Setting Up</a> · <a href="#PRINTING">Printing</a> · <a href="#DOCUMENTATION">Documentation</a> · <a href="https://github.com/OpenPrinting/cups/wiki/Platforms">Platforms</a> </span> <a class="btn btn-primary btn-large" href="https://github.com/openprinting/cups/releases"><i class="bi bi-download"></i> Download CUPS<img src="https://img.shields.io/github/v/release/OpenPrinting/cups?style=for-the-badge&label=%20&labelColor=%2377777700&color=%2377777700"></a> </p> </div> <div class="col col-md-3"> <img class="logo-mascot"> </div> </div> </div> <div class="container-fluid" id="INTRO"> <div class="row py-3"> <div class="col col-section"> <h2>Introduction</h2> <p>CUPS supports printing to:</p> <ul> <li><a href="https://support.apple.com/en-us/HT201311" target="_blank">AirPrint™</a> and <a href="https://www.pwg.org/ipp/everywhere.html" blank="_blank">IPP Everywhere™</a> printers,</li> <li>Network and local (USB) printers with Printer Applications, and</li> <li>Network and local (USB) printers with (legacy) PPD-based printer drivers.</li> </ul> <p>CUPS provides the System V ("lp") and Berkeley ("lpr") command-line interfaces, a configurable web interface, a C API, and common print filters, drivers, and backends for printing. The <a href="https://github.com/openprinting/cups-filters" target="_blank">cups-filters</a> project provides additional filters and drivers.</p> <p>CUPS is licensed under the <a href="doc/license.html" target="_blank">Apache License Version 2.0</a> with an exception to allow linking against GNU GPL2-only software.</p> </div> </div> </div> <div class="container-fluid" id="HISTORY"> <div class="row py-3"> <div class="col col-section"> <h2>A Brief History of CUPS</h2> <p>CUPS was originally developed by <a href="https://www.msweet.org" target="_blank">Michael R Sweet</a> at Easy Software Products starting in 1997, with the first beta release on <a href="https://web.archive.org/web/20000126074742/http://cups.org/news.html" target="_blank">May 14, 1999</a>. Not long after, Till Kamppeter started packaging CUPS for Mandrake Linux and created the Foomatic drivers for CUPS, leading the adoption of CUPS for printing on Linux. Apple licensed CUPS for macOS in 2002, and in February 2007 Apple purchased CUPS and hired Michael to continue its development as an open source project.</p> <p>In December 2019, Michael left Apple to start <a href="https://www.lakesiderobotics.ca" target="_blank">Lakeside Robotics</a>. In September 2020 he teamed up with the OpenPrinting developers to fork Apple CUPS to continue its development. Today <a href="https://github.com/apple/cups" target="_blank">Apple CUPS</a> is the version of CUPS that is provided with macOS® and iOS® while <a href="https://github.com/OpenPrinting/cups" target="_blank">OpenPrinting CUPS</a> is the version of CUPS being further developed by OpenPrinting for all operating systems.</p> </div> </div> </div> <div class="container-fluid" id="SETUP"> <div class="row py-3"> <div class="col col-section"> <h2>Setting Up Printer Queues</h2> <p>CUPS includes a web-based administration tool that allows you to manage printers, classes, and jobs on your server. Open <a href="http://localhost:631/admin/" target="_blank">http://localhost:631/admin/</a> in your browser to access the printer administration tools. You will be asked for the administration password (root or any other user in the "sys", "system", "root", "admin", or "lpadmin" group on your system) when performing any administrative function.</p> <p>The "lpadmin" command is used to manage printers from the command-line. For example, the following command creates a print queue called "myprinter" for an IPP Everywhere printer at address "11.22.33.44": <pre>lpadmin -p myprinter -E -v "ipp://11.22.33.44/ipp/print" -m everywhere</pre> <p>You can run the "lpinfo" command to list all of the available drivers ("lpinfo -m") or printers ("lpinfo -v").</p> </div> </div> </div> <div class="container-fluid" id="PRINTING"> <div class="row py-3"> <div class="col col-section"> <h2>Printing Files</h2> <p>CUPS provides both the System V ("lp") and Berkeley ("lpr") commands for printing:</p> <pre>lp filename lpr filename</pre> <p>Both the "lp" and "lpr" commands support printing options for the driver:</p> <pre>lp -o media=A4 -o resolution=600dpi filename lpr -o media=A4 -o resolution=600dpi filename</pre> <p>CUPS recognizes many types of images files as well as PDF, PostScript, and text files, so you can print those files directly rather than through an application.</p> <p>If you have an application that generates output specifically for your printer then you need to use the "-o raw" or "-l" options:</p> <pre>lp -o raw filename lpr -l filename</pre> <p>This will prevent the filters from misinterpreting your print file. <span id="DOCUMENTATION"> </span></p> </div> </div> </div> <div class="container-fluid" id="DOCUMENTATION"> <div class="row py-3"> <div class="col col-md-12 col-section"> <h1>Documentation</h1> </div> <div class="col col-md-12"> <h2>Getting Started</h2> </div> <div class="col col-md-4"><a href="doc/admin.html">Command-Line Printer Administration</a></div> <div class="col col-md-4"><a href="doc/options.html">Command-Line Printing and Options</a></div> <div class="col col-md-4"><a href="doc/firewalls.html">Firewalls</a></div> <div class="col col-md-4"><a href="doc/glossary.html">Glossary</a></div> <div class="col col-md-4"><a href="doc/encryption.html">Managing Encryption Policies</a></div> <div class="col col-md-4"><a href="doc/policies.html">Managing Operation Policies</a></div> <div class="col col-md-4"><a href="doc/overview.html">Overview of CUPS</a></div> <div class="col col-md-4"><a href="doc/accounting.html">Printer Accounting Basics</a></div> <div class="col col-md-4"><a href="doc/sharing.html">Printer Sharing</a></div> <div class="col col-md-4"><a href="doc/relnotes.html">Release Notes</a></div> <div class="col col-md-4"><a href="https://github.com/OpenPrinting/cups/issues" target="_blank">Reporting Bugs</a></div> <div class="col col-md-4"><a href="doc/security.html">Server Security</a></div> <div class="col col-md-4"><a href="doc/license.html">Software License Agreement</a></div> <div class="col col-md-4"><a href="doc/translation.html">Translating and Customizing CUPS</a></div> <div class="col col-md-4"><a href="doc/cgi.html">Using CGI Programs</a></div> <div class="col col-md-4"><a href="doc/kerberos.html">Using Kerberos Authentication</a></div> <div class="col col-md-4"><a href="doc/network.html">Using Network Printers</a></div> <div class="col col-md-12"> <h2 class="mt-3">Man Pages</h2> </div> <div class="col col-md-3"><a href="doc/man-cancel.html">cancel(1)</a></div> <div class="col col-md-3"><a href="doc/man-classes.conf.html">classes.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-client.conf.html">client.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-cups.html">cups(1)</a></div> <div class="col col-md-3"><a href="doc/man-cups-config.html">cups-config(1)</a></div> <div class="col col-md-3"><a href="doc/man-cups-files.conf.html">cups-files.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-cups-lpd.html">cups-lpd(8)</a></div> <div class="col col-md-3"><a href="doc/man-cups-snmp.html">cups-snmp(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupsaccept.html">cupsaccept(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupsctl.html">cupsctl(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupsd.html">cupsd(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupsd-helper.html">cupsd-helper(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupsd-logs.html">cupsd-logs(5)</a></div> <div class="col col-md-3"><a href="doc/man-cupsd.conf.html">cupsd.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-cupsenable.html">cupsenable(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupsfilter.html">cupsfilter(8)</a></div> <div class="col col-md-3"><a href="doc/man-cupstestppd.html">cupstestppd(1)</a></div> <div class="col col-md-3"><a href="doc/man-ippeveprinter.html">ippeveprinter(1)</a></div> <div class="col col-md-3"><a href="doc/man-ippevepcl.html">ippevepcl/ps(7)</a></div> <div class="col col-md-3"><a href="doc/man-ippfind.html">ippfind(1)</a></div> <div class="col col-md-3"><a href="doc/man-ipptool.html">ipptool(1)</a></div> <div class="col col-md-3"><a href="doc/man-ipptoolfile.html">ipptoolfile(5)</a></div> <div class="col col-md-3"><a href="doc/man-lp.html">lp(1)</a></div> <div class="col col-md-3"><a href="doc/man-lpadmin.html">lpadmin(8)</a></div> <div class="col col-md-3"><a href="doc/man-lpc.html">lpc(8)</a></div> <div class="col col-md-3"><a href="doc/man-lpinfo.html">lpinfo(8)</a></div> <div class="col col-md-3"><a href="doc/man-lpmove.html">lpmove(8)</a></div> <div class="col col-md-3"><a href="doc/man-lpoptions.html">lpoptions(1)</a></div> <div class="col col-md-3"><a href="doc/man-lpq.html">lpq(1)</a></div> <div class="col col-md-3"><a href="doc/man-lpr.html">lpr(1)</a></div> <div class="col col-md-3"><a href="doc/man-lprm.html">lprm(1)</a></div> <div class="col col-md-3"><a href="doc/man-lpstat.html">lpstat(1)</a></div> <div class="col col-md-3"><a href="doc/man-mailto.conf.html">mailto.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-notifier.html">notifier(7)</a></div> <div class="col col-md-3"><a href="doc/man-printers.conf.html">printers.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-cups-snmp.conf.html">snmp.conf(5)</a></div> <div class="col col-md-3"><a href="doc/man-subscriptions.conf.html">subscriptions.conf(5)</a></div> <div class="col col-md-12"> <h2 class="mt-3">Programming</h2> </div> <div class="col col-md-4"><a href="doc/cupspm.html">CUPS Programming Manual (HTML)</a></div> <div class="col col-md-4"><a href="doc/cupspm.epub">CUPS Programming Manual (EPUB)</a></div> <div class="col col-md-4"><a href="doc/api-admin.html">Administrative APIs</a></div> <div class="col col-md-12"> <h2 class="mt-3">References</h2> </div> <div class="col col-md-4"><a href="doc/spec-design.html">CUPS Design Description</a></div> <div class="col col-md-4"><a href="doc/spec-ipp.html">CUPS Implementation of IPP</a></div> <div class="col col-md-4"><a href="doc/spec-ppd.html">CUPS PPD Extensions</a></div> <div class="col col-md-4"><a href="doc/spec-raster.html">CUPS Raster Format</a></div> <div class="col col-md-4"><a href="doc/spec-stp.html">CUPS Software Test Plan</a></div> </div> </div> <nav class="navbar navbar-expand navbar-dark bg-dark justify-content-center"> <span class="navbar-text">Copyright © 2020-2025 OpenPrinting.</span> <ul class="navbar-nav ms-4"> <li class="nav-item"><a class="nav-link" href="/cups/doc/license.html">CUPS License</a></li> </ul> </nav> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-C6RzsynM9kWDrMNeT87bh95OGNyZPhcTNXj1NW7RuBCsyN/o0jlpcV8Qyq46cDfL" crossorigin="anonymous"></script> </body> </html>

CINXE.COM

OpenPrinting CUPS