Printer Setup - Revision history

Prabuanand: changed color of pill

2025-12-09T05:26:51Z

changed color of pill

← Older revision		Revision as of 05:26, 9 December 2025
Line 23:		Line 23:

	<!-- The below pill needs to be removed once the package gets released with v3.24 -->		<!-- The below pill needs to be removed once the package gets released with v3.24 -->
	{{Pill_clickable\|\|edge only\|~~green~~\|~~palegreen~~\|right\|Repositories#Edge}}		{{Pill_clickable\|\|edge only\|#DF0000\|#FFDFDF\|right\|Repositories#Edge}}
	To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is currently available in the [[Repositories#Community\|Community]] repository of [[Repositories#Edge\|Edge branch]]. It can be installed with the below command:{{cmd\|# apk add hplip}}		To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is currently available in the [[Repositories#Community\|Community]] repository of [[Repositories#Edge\|Edge branch]]. It can be installed with the below command:{{cmd\|# apk add hplip}}

Prabuanand: updated due to https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/94373

2025-12-09T05:21:14Z

updated due to https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/94373

← Older revision		Revision as of 05:21, 9 December 2025
Line 22:		Line 22:
	Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group. Once you have added a printer, you should be able to print.		Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group. Once you have added a printer, you should be able to print.

	To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is available in the [[Repositories#~~Testing~~\|~~testing~~]] repository~~. It can be installed after~~ [[Repositories#~~Using_testing_repository~~\|~~configuring the testing repository~~]] with the below command:{{cmd\|# apk add hplip}}		<!-- The below pill needs to be removed once the package gets released with v3.24 -->
			{{Pill_clickable\|\|edge only\|green\|palegreen\|right\|Repositories#Edge}}
			To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is currently available in the [[Repositories#Community\|Community]] repository of [[Repositories#Edge\|Edge branch]]. It can be installed with the below command:{{cmd\|# apk add hplip}}

	If that doesn't work, you may also need to add HPLIP's dependencies separately.		If that doesn't work, you may also need to add HPLIP's dependencies separately.

Line 29:		Line 32:
	{{cmd\|# apk add ghostscript py3-reportlab libjpeg net-snmp}}		{{cmd\|# apk add ghostscript py3-reportlab libjpeg net-snmp}}

	{{Expand\|Modifications/sections required e.g. to address container user-case scenarios, etc.}}		{{Expand\|Modifications/sections required e.g. to address container user-case scenarios, etc.}}

	== Configure mdev for USB printers ==		== Configure mdev for USB printers ==

Unicorn at 20:34, 23 October 2025

2025-10-23T20:34:10Z

← Older revision		Revision as of 20:34, 23 October 2025
Line 5:		Line 5:
	Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}}		Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}}

	If you want to make use of automatic discovery for [https://openprinting.github.io/printers/ printers that support IPP Everywhere™ or AirPrint™], you also need to set up [[MDNS\|mDNS with avahi]].		If you want to make use of automatic discovery for [https://openprinting.github.io/printers/ printers that support IPP Everywhere™ or AirPrint™] or other printers that support [https://en.wikipedia.org/wiki/Multicast_DNS Multicast DNS], you also need to set up [[MDNS\|mDNS with avahi]].

	To use CUPS to print to PDF, you can use the {{pkg\|cups-pdf}} package, which is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add cups-pdf@testing}}		To use CUPS to print to PDF, you can use the {{pkg\|cups-pdf}} package, which is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add cups-pdf@testing}}

Unicorn at 20:10, 23 October 2025

2025-10-23T20:10:51Z

← Older revision		Revision as of 20:10, 23 October 2025
Line 20:		Line 20:
	== Printer configuration ==		== Printer configuration ==

	Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group ~~(or root)~~. Once you have added a printer, you should be able to print.		Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group. Once you have added a printer, you should be able to print.

	To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add hplip}}		To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add hplip}}

Unicorn: Remove redundant user group instructions

2025-10-23T20:09:54Z

Remove redundant user group instructions

@@ Line 12: / Line 12: @@
 == Service configuration ==
-To allow a regular user to configure CUPS, you need to add them to the <code>lpadmin</code> group: {{cmd|# adduser $USER lpadmin}}
+To allow a user to configure CUPS, you need to add them to the <code>lpadmin</code> group: {{cmd|adduser $USER lpadmin}}
 To be able to use the CLI commands to configure CUPS, you need to log out and back in again or possibly reboot in order for the new group to take effect.
@@ Line 57: / Line 57: @@
 CUPS will be able now to use libusb to discover the local USB printer.
 == Managing Printers via KDE Plasma Settings ==
@@ Line 170: / Line 147: @@
 == See also ==
 * [https://www.cups.org/documentation.html CUPS documentation]
 [[Category:Printers]]

Unicorn at 19:58, 23 October 2025

2025-10-23T19:58:13Z

← Older revision		Revision as of 19:58, 23 October 2025
Line 22:		Line 22:
	Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group (or root). Once you have added a printer, you should be able to print.		Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group (or root). Once you have added a printer, you should be able to print.

	To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package ~~was~~ is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add hplip}}		To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add hplip}}
	If that doesn't work, you may also need to add HPLIP's dependencies separately.		If that doesn't work, you may also need to add HPLIP's dependencies separately.

Unicorn: Expand basic printer setup instructions, add instructions for non-root configuration

2025-10-23T19:57:43Z

Expand basic printer setup instructions, add instructions for non-root configuration

← Older revision		Revision as of 19:57, 23 October 2025
Line 3:		Line 3:
	== Installation ==		== Installation ==

	Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}} As of now, {{pkg\|cups-pdf}} package is available in the [[Repositories#Testing\|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository\|guidelines]] as per the below command:{{cmd\|# apk add cups-pdf@testing}}		Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}}

	~~== Service configuration ==~~		If you want to make use of automatic discovery for [https://openprinting.github.io/printers/ printers that support IPP Everywhere™ or AirPrint™], you also need to set up [[MDNS\|mDNS with avahi]].

	~~Confirm that~~ cups [[~~OpenRC~~]] ~~service starts~~. ~~You may also set it to run at boot~~-~~up.~~		To use CUPS to print to PDF, you can use the {{pkg\|cups-pdf}} package, which is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add cups-pdf@testing}}

	{{cmd\|# rc-service cupsd start}}
	{{cmd\|# rc-update add cupsd ~~boot~~}}		== Service configuration ==

			To allow a regular user to configure CUPS, you need to add them to the <code>lpadmin</code> group: {{cmd\|# adduser $USER lpadmin}}
			To be able to use the CLI commands to configure CUPS, you need to log out and back in again or possibly reboot in order for the new group to take effect.

			Confirm that the CUPS [[OpenRC]] service starts:{{cmd\|# rc-service cupsd start}}
			You may also want to configure it to start automatically:{{cmd\|# rc-update add cupsd}}

	== Printer configuration ==		== Printer configuration ==

	Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser and ~~follow~~ the ~~steps to~~ "Add Printer"~~. It will ask you to log in~~ to add a printer. ~~Log~~ in as root~~, then finish the steps~~. Once you~~'re done~~, you should be able to print.		Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser, click on the "Administration" tab and use the "Add Printer" or "Find New Printers" button to add a new printer. When asked, you can log in with the user that you previously added to the <code>lpadmin</code> group (or root). Once you have added a printer, you should be able to print.

			To configure ''Hewlett-Packard'' (''HP'') printers ,the {{pkg\|hplip}} package was is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add hplip}}
			If that doesn't work, you may also need to add HPLIP's dependencies separately.

	{{pkg\|hplip}} package was available in the [[Repositories\|Repositories]] repository until V3.20 to configure ''Hewlett-Packard'' (''HP'') printers. It can be safely installed as per the below command:{{ic\|# apk add hplip}}		There are currently no packages for CUPS DDK, <code>hp-setup</code> or <code>foomatic</code>.
	~~If that doesn't work, you may also need to add HPLIP's dependencies separately.~~ There are currently no packages for ~~'''~~CUPS DDK~~'''~~, <code>hp-setup</code> or <code>foomatic</code>.

	{{cmd\|# apk add ghostscript py3-reportlab libjpeg net-snmp}}		{{cmd\|# apk add ghostscript py3-reportlab libjpeg net-snmp}}
Line 162:		Line 170:

	== See also ==		== See also ==
	* [[mDNS\|Use mDNS to discover printers]]
	* [https://www.cups.org/documentation.html CUPS documentation]		* [https://www.cups.org/documentation.html CUPS documentation]

	[[Category:Printers]]		[[Category:Printers]]

Prabuanand: changed introduction paragraph and few other sentence

2025-05-07T18:42:17Z

changed introduction paragraph and few other sentence

← Older revision		Revision as of 18:42, 7 May 2025
Line 1:		Line 1:
	~~First, you'll need~~ [https://en.wikipedia.org/wiki/CUPS CUPS]~~. If you have~~ a ~~''Hewlett~~-~~Packard'' (''HP'') printer, add the [https://en~~.~~wikipedia.org/wiki/HP_Linux_Imaging_and_Printing HPLIP] package. Some of these packages are outside of main,~~ and ~~the appropriate repos will need to be configured. See tip below~~.		[https://en.wikipedia.org/wiki/CUPS CUPS] is a modular printing system for Unix-like computer operating systems. This page explains how to install and configure printers in Alpine Linux.

	~~{{cmd\|# apk add cups cups-pdf cups-filters hplip}}~~		== Installation ==

	{{~~Tip~~\|As ~~with all installation processes~~, ~~Alpine's~~ [[~~Alpine_Linux_package_management~~\|~~package management~~]] can ~~guide you on~~ the ~~need to pull various packages from other repositories (e.g.''@testing'') other than the enabled ''main'' or ''edge'' repositories throughout this wiki page, as long~~ as the ~~other repos have been [https~~:~~//wiki.alpinelinux.org/wiki/Alpine_Linux_package_management~~#~~Repository_pinning pinned]. For example, for Alpine version 3.7.0 on x86_64 systems, '''~~apk~~''' would have guided you to substitute in <code>~~cups-pdf@testing~~</code> and <code>hplip@testing</code>.~~}}		Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}} As of now, {{pkg\|cups-pdf}} package is available in the [[Repositories#Testing\|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository\|guidelines]] as per the below command:{{cmd\|# apk add cups-pdf@testing}}

	Confirm cups starts. You may also set it to run at boot-up.		== Service configuration ==

			Confirm that cups [[OpenRC]] service starts. You may also set it to run at boot-up.

	{{cmd\|# rc-service cupsd start}}		{{cmd\|# rc-service cupsd start}}
	{{cmd\|# rc-update add cupsd boot}}		{{cmd\|# rc-update add cupsd boot}}

			== Printer configuration ==

	Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser and follow the steps to "Add Printer". It will ask you to log in to add a printer. Log in as root, then finish the steps. Once you're done, you should be able to print.		Go to <code><nowiki>http://localhost:631</nowiki></code> with your web browser and follow the steps to "Add Printer". It will ask you to log in to add a printer. Log in as root, then finish the steps. Once you're done, you should be able to print.

			{{pkg\|hplip}} package was available in the [[Repositories\|Repositories]] repository until V3.20 to configure ''Hewlett-Packard'' (''HP'') printers. It can be safely installed as per the below command:{{ic\|# apk add hplip}}
	If that doesn't work, you may also need to add HPLIP's dependencies separately. There are currently no packages for '''CUPS DDK''', <code>hp-setup</code> or <code>foomatic</code>.		If that doesn't work, you may also need to add HPLIP's dependencies separately. There are currently no packages for '''CUPS DDK''', <code>hp-setup</code> or <code>foomatic</code>.

	{{cmd\|# apk add ghostscript py3-reportlab libjpeg net-snmp}}		{{cmd\|# apk add ghostscript py3-reportlab libjpeg net-snmp}}


	{{Expand\|Modifications/sections required e.g. to address container user-case scenarios, etc.}}		{{Expand\|Modifications/sections required e.g. to address container user-case scenarios, etc.}}

			== Configure mdev for USB printers ==
	== ~~configure~~ mdev for USB printers ==

	By default USB printer with [[mdev]] would have ownership ''root:root'' and permission ''0660''. As ''cupsd'' would try to open a libusb-based printer as ''lp'' user, it won't have permission to use the device in ''/dev/bus/usb''.		By default USB printer with [[mdev]] would have ownership ''root:root'' and permission ''0660''. As ''cupsd'' would try to open a libusb-based printer as ''lp'' user, it won't have permission to use the device in ''/dev/bus/usb''.
Line 47:		Line 50:
	CUPS will be able now to use libusb to discover the local USB printer.		CUPS will be able now to use libusb to discover the local USB printer.

	== Desktop ~~Environment~~ ==		== Desktop usage ==

	Additionally, in a desktop environment ~~you could proceed as follows.~~		Additionally, in a desktop environment check whether ''root'' and the user's username (''yourusername'') are already members of the <code>lp</code> and <code>lpadmin</code> groups.
			{{Note\| A '''user''' needs be added to the <code>lpadmin</code> group, if they should be able to administer the CUPS system with their password}}
	~~Check~~ whether ''root'' and the user's username (''yourusername'') are already members of the <code>lp</code> and <code>lpadmin</code> groups. Note: ''~~yourusername~~'' ~~can~~ be added to the <code>lpadmin</code> group if they should be able to administer the CUPS system with their password.

	$ groups root		$ groups root
Line 160:		Line 162:

	== See also ==		== See also ==
			* [[mDNS\|Use mDNS to discover printers]]
	* [https://www.cups.org/documentation.html CUPS documentation]		* [https://www.cups.org/documentation.html CUPS documentation]

	[[Category:Printers]]		[[Category:Printers]]

Prabuanand: removed :Category:Installation

2025-04-26T17:57:44Z

removed Category:Installation

← Older revision		Revision as of 17:57, 26 April 2025
Line 164:		Line 164:

	[[Category:Printers]]		[[Category:Printers]]
	~~[[Category:Installation]]~~

Andar1an: Add note about requiring root user in SystemGroup configuration for CUPS to manage printers in KDE Settings.

2024-09-04T17:35:15Z

Add note about requiring root user in SystemGroup configuration for CUPS to manage printers in KDE Settings.

← Older revision		Revision as of 17:35, 4 September 2024
Line 70:		Line 70:
	# rc-update add cupsd		# rc-update add cupsd
	# reboot}}		# reboot}}

			== Managing Printers via KDE Plasma Settings ==

			To manage printers from KDE Plasma Settings, it is required to add "root" to SystemGroup in '''''/etc/cups/cups-files.conf'''''.

			e.g.
			{{Cmd\|
			SystemGroup root lpadmin}}

	== Managing Printers via Command Line ==		== Managing Printers via Command Line ==

← Older revision		Revision as of 20:34, 23 October 2025
Line 5:		Line 5:
	Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}}		Install the basic packages need for configuring printers: {{cmd\|# apk add cups cups-filters}}

	If you want to make use of automatic discovery for [https://openprinting.github.io/printers/ printers that support IPP Everywhere™ or AirPrint™], you also need to set up [[MDNS\|mDNS with avahi]].		If you want to make use of automatic discovery for [https://openprinting.github.io/printers/ printers that support IPP Everywhere™ or AirPrint™] or other printers that support [https://en.wikipedia.org/wiki/Multicast_DNS Multicast DNS], you also need to set up [[MDNS\|mDNS with avahi]].

	To use CUPS to print to PDF, you can use the {{pkg\|cups-pdf}} package, which is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add cups-pdf@testing}}		To use CUPS to print to PDF, you can use the {{pkg\|cups-pdf}} package, which is available in the [[Repositories#Testing\|testing]] repository. It can be installed after [[Repositories#Using_testing_repository\|configuring the testing repository]] with the below command:{{cmd\|# apk add cups-pdf@testing}}