CUPS

Note: This branch is tracking a future CUPS 2.5.x feature release. Check out the "2.4.x" branch for CUPS 2.4.x.

Introduction

OpenPrinting CUPS is the most current version of CUPS, a standards-based, open source printing system for Linux® and other Unix®-like operating systems. CUPS supports printing to:

• AirPrint™ and IPP Everywhere™ printers,
• Network and local (USB) printers with Printer Applications, and
• Network and local (USB) printers with (legacy) PPD-based printer drivers.

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 cups-filters project provides additional filters and drivers.

CUPS is licensed under the Apache License Version 2.0 with an exception to allow linking against GNU GPL2-only software. See the files LICENSE and NOTICE for more information.

Note: Apple maintains a separate repository for the CUPS that ships with macOS and iOS at https://github.com/apple/cups.

Reading the Documentation

Initial documentation to get you started is provided in the root directory of the CUPS sources:

• CHANGES.md: A list of changes in the current major release of CUPS.
• CONTRIBUTING.md: Guidelines for contributing to the CUPS project.
• CREDITS.md: A list of past contributors to the CUPS project.
• DEVELOPING.md: Guidelines for developing code for the CUPS project.
• INSTALL.md: Instructions for building and installing CUPS.
• LICENSE: The CUPS license agreement (Apache 2.0).
• NOTICE: Copyright notices and exceptions to the CUPS license agreement.
• README.md: This file.
• REPORTING_ISSUES.md: Instructions what information to provide when reporting an issue.

Once you have installed the software you can access the documentation (and a bunch of other stuff) online at http://localhost:631/ and using the man command, for example man cups.

If you're having trouble getting that far, the documentation is located under the doc/help and man directories.

Please read the documentation before asking questions.

Setting Up Printers

CUPS includes a web-based administration tool that allows you to manage printers, classes, and jobs on your server. Open <http://localhost:63