Created at 07:12 May 20, 2005 by steve, last modified at 14:37 Dec 14, 2008
CUPS provides a web interface (which is sometimes called a GUI, although we rely on the web browser to provide the graphical part) that allows you to view print jobs, printers, and the online help, as well as manage your printers.
The CUPS web interface is available on your machine at the following URL:
Some pages require a username and password to perform certain actions, for example to add a printer. In general you can use your login name and password, but on Mac OS X your login name is called the "short user name" which is usually your first and last name in lowercase. For example, if your name is "John Doe", your short username would be "johndoe".
For most Linux and BSD distributions, you must use the "root" username and password to add, modify, or delete printers or classes.
Note: Your cups.org username and password are not used by the CUPS web interface. Only accounts on your system can be used.
For more information on specific operating systems, see the following FAQs:
Listing
Didn't work on my Kubuntu Dapper and I followed it exactly Reply
I use Debian... this should also work on K/Ubuntu :
try adding your user account to the 'lpadmin' group.
see /etc/cups/cupsd_conf . the SystemGroup is usually 'lpadmin'.
lpadmin s/b in /etc/group .
to add a user named joe to lpadmin, from command line:
adduser joe lpadmin .
I am using Ubuntu 6 (dapper) and I have followed the the instructions, but none of them could made me autenticate sucessfully.
Then I've realized that the cupsys user didn't have access to the shadow file, so I've changed my cupsys user to belong to the shadow group and changed the SystemGroup in /etc/cups/cupsys.conf to point to the shadow group.
Then restart the cupsd (killall cupsd; /etc/init.d/cupsys restart) and then I could get my access validated by the Cups web interface.
Reply
did not work for me. I have current kubuntu distro up to date. Whenever I get a password challenge I am warned data is being transmitted unencrypted and then access is denied. I think the current implementation of cups is paranoid in the extreme. I understand the risks of open ports, but to not enable a home network setup without endless hassles about passwords is crazy. Much exacerbated by the ubuntu/kubuntu prohibition on root logins. The farther we go the loster I get. I could to this stuff in Redhat 7.2 and 9.0 and now I can't do much of anything. Reply
Could you please provide step by step instructions of what is needed to solve the problem? I am a new user and it is not clear from your explanation what I need to do. I will really appreciate it. Reply
Mablan,
Been through a lot today but got it working. First you need to download the LPR driver and cupswrapper from the Brother Solutions Center as Debian versions. Copy and paste into HOME directory (does work).
Open a terminal window and type "sudo ln -s /etc/init.d/cupsys /etc/init.d/cups" enter (throughout enter password if requested)
Still in terminal type "sudo dpkg -i --force-all (the name of the lpr file you downloaded)" enter
Next "sudo dpkg -i --force-all (the name of the cupswrapper file)" enter
Now vary from the Brother instructions and go to SYSTEM, ADMIN, USERS&GROUPS, GROUPS tab. Check the "Show all users and groups" box. Highlight "shadow" and click on properties. Find cupsys in the left list, highlight it and click on Add, should move to right list. Click OK.
Check the directory File System /etc/cups for either cupsd.conf or cupsys.conf (if you are very new it will probably be the first.
Back in the terminal window type "sudo gedit /etc/cups.cupsd.conf" (Beansdad 9 Dec 2006 - sorry this should read /etc/cups/cupsd.conf) (replace "cupsd" with "cupsys" if you do have the latter) enter. Find where it refers to "# Administrator user group... SystemGroup lpadmin" and change "lpadmin" to "shadow", then do file save as "cupsys.conf" enter
From the above it says to then in terminal "sudo killall cupsd; /etc/init.d/cupsys restart" enter. Not sure this works but we'll do it anyway.
Now close the terminal, shut down and restart (it won't work unless you do!)
When restarted, open your browser type "http://localhost:631" in the page bar at the top and then enter. This should then take you to the CUPS site, click on "Manage Printers" and, hopefully, the next screen will show your printer.
You do need to do this next bit as well, click "Modify Printer" and follow the entries (pick a name, select the connection (mainly USB or LPT#1) etc) through until it asks for your user and password - enter the name and password you use to start Ubuntu. Click OK and you should be there.
I've done this on my laptop and desktop today, both running Ubuntu 6.06 and got a test page out of both OK.
Hope it works for you. Reply
This is almost exactly right.
cupsys does need to read shadow, so editing /etc/group and adding cupsys to the shadow group is necessary - but that's all you need to do. There's no restart required, and you should leave lpadmin as the printer admin group (cupsys takes care of verifying that the user it authentifies is in SystemGroup).
Thanks for the hint - I would not have gotten it without you.
Dave Neary. Reply
To have access to the web interface from another computer on your network you need to allow computers on your network:
Example:
<Location />
Order allow,deny
Allow 192.168.0.0/24
</Location>
ReplyIf you have root privileges and ssh access to a remote network then you can just as easily manage printers on that network as on the local network by binding the remote and local ports.
ssh -L 6310:localhost:631 root@remote_ip_address Then, in the browser, http://localhost:6310/ Reply
Hello, translation
I have translate this page http://localhost:631/help/overview.html I do not know how to proceed to make some profit the community. First § english, second § french for each paragraph
Overview of CUPS Vue d'ensemble de CUPS
The Common UNIX Printing SystemTM, or CUPS, is the software you use to print from applications like the web browser you are using to read this page. It converts the page descriptions produced by your application (put a paragraph here, draw a line there, and so forth) into something your printer can understand and then sends the information to the printer for printing.
Le système commun d'impression d'UNIX (Common UNIX Printing SystemTM, or CUPS) est le logiciel que vous employez pour imprimer les documents de vos application comme le navigateur internet que vous employez utilisez pour lire cette page. CUPS convertit les descriptions de page utilisées par votre application (un paragraphe ici, une ligne là, et ainsi de suite) en quelque chose que votre imprimante peut comprendre et puis envoie l'information à l'imprimante pour l'impression.
Now, since every printer manufacturer does things differently, printing can be very complicated. CUPS does its best to hide this from you and your application so that you can concentrate on printing and less on how to print. Generally, the only time you need to know anything about your printer is when you use it for the first time, and even then CUPS can often figure things out on its own.
Mais, puisque chaque fabricant d'imprimeur fait des choses différemment, l'impression peut être très compliquée. CUPS fait de son mieux pour que vous n'ayez pas à vous soucier de ceci afin que vous puissiez vous concentrer sur l'impression et moins sur la façon dont imprimer. Généralement, le seul cas où vous devez savoir quelque chose au sujet de votre imprimante est quand vous l'employez pour la première fois, et même alors CUPS peut souvent trouver la solution seul.
How Does It Work? Comment ça fonctionne ?
The first time you print to a printer, CUPS creates a queue to keep track of the current status of the printer (everything OK, out of paper, etc.) and any pages you have printed. Most of the time the queue points to a printer connected directly to your computer via a USB or parallel port, however it can also point to a printer on your network, a printer on the Internet, or multiple printers depending on the configuration. Regardless of where the queue points, it will look like any other printer to you and your applications.
La première fois que vous imprimez depuis une imprimante, CUPS crée une file d'attente et vérifie les statuts de l'imprimante (chaque chose est contrôlée, manque de papier, etc.) ainsi que toutes les pages que vous devez imprimer. Le plus souvent les points à contrôler depuis la file d'attente transitent par l'intermédiaire du port USB ou du port parallèle relié à votre imprimante, toutefois il peut également indiquer une imprimante sur votre réseau, une imprimante sur l'Internet, ou des imprimantes multiples selon la configuration. Indépendamment de l'endroit où est acheminé la file d'attente, il verra n'importe quelle imprimante pour vous et vos applications.
Every time you print something, CUPS creates a job which contains the queue you are sending the print to, the name of the document you are printing, and the page descriptions. Job are numbered (queue-1, queue-2, and so forth) so you can monitor the job as it is printed or cancel it if you see a mistake. When CUPS gets a job for printing, it determines the best programs (filters, printer drivers, port monitors, and backends) to convert the pages into a printable format and then runs them to actually print the job.
Chaque fois que vous imprimez quelque chose, CUPS crée une tâche qui contient la file d'attente que vous envoyez à la copie, le nom du document en impression et les descriptions de page. Les tâches sont numérotées (queue-1, queue-2, et ainsi de suite) ainsi vous pouvez surveiller les tâches pendant l'impression, le suspendre ou l'annuler si vous voyez une erreur. Quand CUPS prend un travail pour l'impression, il détermine les meilleurs programmes (les filtres, pilotes d'impression, ports de contrôle, et centralise) pour convertir les pages en format imprimable et puis les exécute pour imprimer réellement le travail.
When the print job is completely printed, CUPS removes the job from the queue and moves on to any other jobs you have submitted. You can also be notified when the job is finished, or if there are any errors during printing, in several different ways.
Quand le tirage est complètement imprimé, CUPS enlève le travail de la file d'attente et effectue les mouvements pour poursuivre tous les autres travaux que vous avez soumis. Vous pouvez également être prévenu quand l'impression d'un document est terminée, ou s'il y a des erreurs pendant l'impression, de plusieurs manières différentes.
Where Do I Begin? Où commencer ?
Click on the Administration tab at the top of this page. If you have a printer connected to a USB or parallel port, you will see it listed as a new printer - click on the Add This Printer button, verify the printer driver CUPS has chosen for you, and click on the Add Printer button. If you do not see your printer listed, or if you have a network printer, click on the Add Printer button and follow the prompts.
Cliquez sur dessus l'onglet Administration en haut de cette page. Si vous avez une imprimante reliée à un port USB ou à un port parallèle, vous verrez il l'énumérera comme nouvelle imprimante - cliquer sur le bouton Ajouter une imprimante, vérifiez le pilote que CUPS a choisi pour vous, et cliquez sur le bouton Ajouter une imprimante. Si vous ne voyez pas votre imprimante énumérée, ou si vous avez une imprimante réseau, cliquez sur le bouton Ajouter une imprimante et suivez les messages de sollicitation.
Framed beginning If you are asked for a username and password, enter your login username and password or the "root" username and password. On MacOS X, the login username (or "short name") is typically your first name in lowercase.
S'il vous est demandé un nom d'utilisateur et un mot de passe, écrivez votre nom d'utilisateur et votre mot de passe ou le nom de l'utilisateur "root" et son mot de passe. Sur MaOS X, le nom d'utilisateur d'ouverture (ou "nom court") est typiquement votre prénom en minuscules. End framed
After the printer is added, CUPS will ask you to set the default printer options (paper size, output mode, etc.) for the printer. Make any changes as needed and then click on the Set Printer Options button to save them.
Après que l'imprimante soit ajoutée, CUPS vous demandera de choisir les options par défaut (format du papier, mode de sortie, etc.) pour l'imprimante. Choisissez les réglages que vous souhaitez avoir comme standard et cliquez sur le bouton (nom du bouton en français, en italique et sans les parenthèses. NDT) pour les enregistrer.
Finally, click on the Print Test Page button to print a simple test page and verify that everything is working properly.
Finalement, cliquez sur le bouton pour imprimer une page de test pour vérifier que tout fonctionne correctement.
Once you have added the printer, you can print to it from any application.
Une fois que vous avez ajouté l'imprimante, vous pouvez imprimer avec elle depuis n'importe quelle application.
Figure 1: Page Administration de CUPS (*) Figure 2: Page de Choix des Pilotes de l'imprimante (*)
Figure 3: Boite de dialogue d'identification pour utiliser CUPS (*) Figure 4: Page de choix des options par défaut de votre imprimante (*)
Figure 5: Page des statuts de l'imprimante (*) Figure 6: Page de test de CUPS (*)
(*) Mettre les captures et images en français ou indiquer que les captures sont toujours en anglais. To put the captures and images in French or to indicate that the captures are always in English. NDT
I manage to translate English into French rather suitably, but I have more difficulties in write in English. Well cordially with all. Reply
Hi, I followed the instruction given in: "http://www.cups.org/articles.php?L237+I10+TMine+P1+Q" but it did not work at all. I use Ubuntu (Dapper) and was not able to edit the file cupsd.conf at all, even when I used the "sudo" cmd before the actual cmd. If someone have any idea about how to continue, I will be very grateful for the help/tips. Regards A_dreamer Reply
have you tried becoming root by using the "sudo -s" first and then use your password to become root and then inter the cmd that you like. Reply
can't start the cups server. Running Mandriva 2005 LE. Can enter command to start cups service, but not thru gui. Don't know why or what happened. Can't print now. Downloaded latest CUPS and Ghostscript software, but cups service won't start.............. Everything else works perfectly tho.
dallas25@voicenet.com Reply