HP Deskjet install guide for Ubuntu 10.10 x64

last updated: Oct 16th, 2011

As promised here are the complete instructions as I have found them online and pieced together to properly install an HP Deskjet in Linux/Ubuntu 10.10 x64. As I mentioned before I did not do this originally and it seemed to work, but then later I started having issues. So here they are, all in one place, in order, complete with reference links to the sources (most are to the HPLIP open source website), these instructions are for you to build from the source files, not from a precompiled binary.

If you want the automated method, the HPLIP website has a great guide that has screen shots on using their binary package to do the install.

****update**** I have run through these instructions again and there is a new HPLIP driver, after installing this some of the wording has changed, if you use this new version and some things look different, don’t worry. I also noticed after following these instructions with the new versions of everything (Ubuntu 11.10 x64 also) that I ended up with two printers! one from HPLIP and another from CUPS… I only figured out it was one from each, as I set the description different when configuring each one! So you may want to test printing before you do the CUPS configuration section and see if it is necessary for you.

On we go!
Once again, anything in BOLD you can copy and paste directly into a terminal window, this is a standard method I use on all my guides.

Part One

– updating your system and downloading dependencies and the HPLIP source – information borrowed from here

  1. ***** PLEASE PLEASE PLEASE ***** unplug the printer’s USB cable from the computer! (or ethernet cable if that is how you are using it).
  2. If you have not already, now would be a good time to setup your printer and power it on (but don’t plug it in to the computer).
  3. Open up a terminal window.
  4. sudo apt-get update && sudo apt-get check && sudo apt-get dselect-upgrade
    • This will update your system and check for any missing dependencies you might have already.
  5. sudo apt-get remove hplip hpijs
    • This will remove any existing HPLIP installation, prevent errors or other issues while installing, and make sure you end up with a shiny clean install. Also handy if you are trying to fix a botched install…
  6. sudo apt-get install --assume-yes libcups2 cups libcups2-dev cups-bsd cups-client libcupsimage2-dev libdbus-1-dev build-essential ghostscript openssl libjpeg62-dev libsnmp-dev libtool libusb-dev python-imaging policykit-1 policykit-1-gnome python-qt4 python-qt4-dbus python-dbus python-gobject python-dev python-notify python python-reportlab libsane libsane-dev sane-utils xsane gs python2.6-dev gcc lsb postfix libcups2-dev
    • This did popup a window asking me about email settings, I selected no change, or no connection.
    • This is the list of dependencies that I have found are required and some optional requirements for HPLIP. Please make sure they all install, if any fail, do a “sudo apt-get install –force-yes [package name]” to try and get them to install.
  7. mkdir ~/build-loc
    • If you have not used any of my previous how to guides (not all of them use this), you may not have this DIR created on your machine, this is where I do all my source builds. it may not be the best place for you, depending on your FileSystem setup, I have separate mounts for documents, pictures, music, video, downloads, and a fairly large home directory. If you have limited space in your home directory you may want to put this somewhere else, or if you intend to follow this or any other guide I write, you might want to do a mount redirect to this location, so the data is on a different FS, but the DIR is in the same place. leave a comment if you need help with this, also, I believe I cover this in my Appcelerator guides near the beginning if you want to look there.
  8. cd ~/build-loc
  9. wget http://iweb.dl.sourceforge.net/project/hplip/hplip/3.12.2/hplip-3.12.2.tar.gz
    • The good news is this will download the most recent release of HPLIP as of this writing, the bad news is that the HPLIP website does not have a direct link to the “newest” so, when they update this project this link will then be out of date, and I probably won’t know about it. The version used in this guide was posted on Fri, 13 May 2011 03:32:54 GMT. Updated on October 16th 2011 February 8th 2012, there was a new version available. Some other good news, after you finish this guide one of the last steps will have you update your installed packages, and the HPLIP software may/should be part of you update repo’s and will then update as updates become available. (on feb 2012 the current repo version for ubuntu was still 3.11.x)
  10. tar xvfz hplip-3.12.2.tar.gz
  11. cd hplip-3.12.2
  12. ./configure --with-hpppddir=/usr/share/ppd/HP --libdir=/usr/lib64 --prefix=/usr --enable-udev-acl-rules --enable-qt4 --enable-doc-build --disable-cups-ppd-install --disable-foomatic-drv-install --disable-foomatic-ppd-install --disable-hpijs-install --disable-policykit --enable-cups-drv-install --enable-hpcups-install --enable-network-build --enable-dbus-build --enable-scan-build --enable-fax-build
    • You can leave out the fax build at the end, unless your printer has built in fax capabilities, and if all goes well this will check to make sure you have every prerequisite installed and will set the configuration flags for the build process.
  13. make && sudo make install
    • This step does two things:
      1. It builds the drivers from source with your user credentials to set the file permissions correctly.
      2. It installs it using sudo to root credentials which provides read/write permissions to system directories.
    • Total time on my system to build was under 2 minutes (about 90 seconds give or take).
  14. sudo usermod -a -G lp $USER
    • This will add your user name to the “lp” group allowing you access to the printer, you will either need to rerun this line for each user, after logging in as those users, OR type in the user name instead of “$USER” for each user you want to be able to print.
  15. Restart your computer OR log out and log back in – mostly this is to grant you access rights to print.

Part two

– configuring your printer driver – with information borrowed from here

  1. Plug your printer back into the computer.
  2. Head back to your terminal window.
  3. sudo hp-setup
  4. Select your connection type, most likely USB.
  5. and select next.
    • If all goes well you shall receive a screen listing all available HP printers.
    • If you forgot to plug your printer back in, don’t panic, you can do it now!
  6. Select your printer and click next (if you only have one showing, and it is correct, then just click next).
  7. Fill in the description, location and change the name if you want, then click “Add Printer”.
  8. Now the setup window disappears and you can go back to your terminal window and start the next step, or if you don’t want to, all should work now.

Part three

– configuring CUPS for your printer – with information borrowed from here

  1. sudo restart cups
  2. Pop open your favorite web browser and head over here:
    • http://localhost:631
  3. Now for some optional maintenance, IF you previously tried to install/setup this printer, you may need to follow these steps, or if you need to remove the printer you are replacing, else go to the next number directly preceding this current one. note: it is possible your printer was automatically installed via cups during the OS install if you had it plugged in during that time, it will show up here, as “idle” you should remove that one, it will cause issues, and will not work with the “Extra” features of your printer, ie scanning.
    1. Click Administration
    2. select “Manage Printers”
    3. Select the “old” installation of the printer – should say something about being “unplugged” in the status. (possibly shows “idle” read the note above for more info on that)
    4. Select Maintenance –> Cancel all jobs
      • this should prompt you for a user name and password, you can use any user name and password that you have previously added to the “lp” security group (see near the end of Part one of this post).
    5. Click the Printer name to get back to the previous screen.
    6. Select Administration –> Delete Printer
      • If you accidentally delete the wrong printer, go back to Part two and start over from step #1, then be more careful when you get back to this step… :)
  4. Hopefully your printer shows up in the printers list on this screen, if it does, then you are done and this entire Part was just to verify the installation was successful. If NOT, then go back to Part two and do it again! or you can manually add your printer to CUPS with the following steps (won’t work as good as if you got it right in hp-setup though). One more note about the following, I did not need to do this, so hopefully you don’t either, so I am copying these steps from the HPLIP website instructions word for word, although my CUPS management web interface is different from theirs.
    1. Hopefully you have the CUPS management console still open in your web browser, if not go to the following:
      • localhost:631
    2. The screen is divided into three columns, if you need to setup fax capabilities, do the following: in the middle the first option is “Adding Printers and Classes” click on it.
    3. The first option in the top left corner is “Add Printer” click on it.
    4. If you have not previously provided it, it will now prompt for a user name and password, again it is looking for someone who is a member of the “lp” group, if you have been following my directions so far, you should have added yourself at the end of Part one and should be able to use your username and password.
    5. Next enter a name for your HP printer in the Name box, good thing to know, don’t use spaces if you want your printer to work.
    6. Enter a description/location if you want (I use these to differentiate amongst installations when doing a reinstall).
    7. Click “Continue”.
    8. Select a printer from the dropdown box (It should show up in this format “hpfax:/usb/[printer name, serial number]” and choose HPLIP Fax (en) for the model” and click “Continue”. If your printer is not available to be selected, go back to the top of this Blog post and figure out where you missed a step… sorry.
    9. Select the Manufacturer of the printer, and click “Continue”
    10. Select the Model of your printer (it should be there because we just installed HPLIP), and click continue.
    11. You are now done here, so select finish or complete or what ever allows you to get out of the Add Printer section, then close the web browser.
  5. Now, head back to your terminal window (this is for configuring faxing, you really are done if you are not setting up a fax!).
  6. hp-toolbox
  7. Select your printer (the one you selected as hpfax:/usb/[printer name, serial number]).
  8. Select the Tools and Settings tab across the top.
  9. Click on Fax setup and fill in your information.
  10. Click on OK and that is it, now you are done.

You should not need to print a test page unless you had problems somewhere in between the top of this post and the bottom. If there were no issues, save a tree, don’t waste it with a test page, especially if you are using Ubuntu, the default test page will use up a good bit of your color inks. I’ll add an update on to this post if I have any further printer problems.


One thought on “HP Deskjet install guide for Ubuntu 10.10 x64