January 14th 2013

Wireless Printing/AirPrint Server via the Raspberry Pi

NOTICE: Please read the entire post (and the comments) before proceeding.  This post was originally written at the end of 2012 and some of you have left comments noting fewer steps are required nowadays.  This guide should still work though. Updated guide (no Windows section) available at http://www.lynsayshepherd.com/blog/2015/10/18/wireless-printingairprint-server-via-the-raspberry-pi-updated-guide/.

NOTICE 2: Thank you for all of your emails regarding this post. Unfortunately, I can’t answer every one. If you’re struggling with printing, it might be worth reading through the comment section.

One of the first projects I wanted to attempt when I got my Raspberry Pi was to turn my wired Canon printer into a wireless printer. I managed to get it working so I thought I’d share the steps I went through.

Right, first things first, update the packages on your Pi:

sudo apt-get update

Next up, install all the packages required for printing. The following commands could be put on one line but I took the longer option of installing one package at a time.

sudo apt-get install avahi-daemon
sudo apt-get install avahi-discover
sudo apt-get install libnss-mdns
sudo apt-get install cups
sudo apt-get install cups-pdf
sudo apt-get install python-cups

It takes a while for the packages to install, so grab a cup of tea while you wait. Once everything has finished, you’ll need to add your username to the CUPS server so you’re able to add printers etc later on.

sudo usermod -aG lpadmin pi

Now, check that CUPS has installed correctly and that the service works (it stands for Common Unix Printing System and will let the Raspberry Pi act as a print server):

sudo /etc/init.d/cups start

You’ll need to check the Avahi service works too (it finds various devices on the network which are discoverable):

sudo /etc/init.d/avahi-daemon start

Next, you’ll need to edit the CUPS config file:

sudo nano /etc/cups/cupsd.conf

You’ll need to set-up the port we’re going to be listening on. Comment out the line that reads “Listen localhost:631”. Add in “Port 631”. It should look something like this:

#Listen localhost:631
Port 631

CUPS will need to be told to be used with any hostname, so it can work with AirPrint. The ServerAlias * directive needs to be added before the first occurence of <Location />

The config file will also need to be edited to control access to the server by adding “Allow @Local” in several places e.g.:

# Restrict access to the server...
Order allow,deny
Allow @Local

You need to include it in these areas of the config file:

# Restrict access to the server...
# Restrict access to the admin pages...
# Restrict access to configuration files...

Save the config file and restart the CUPS service:

sudo /etc/init.d/cups restart

Now, find the IP address of your Pi. It’ll be something like 192.168.1.x


Navigate to the CUPS configuration page by typing the IP address you just retrieved and the port number CUPS uses (so it’ll be an address like 192.168.1.x:631). A security exception message may pop up but that’s ok. Continue onwards!

Click on the Admin tab and view the server settings which are towards the right-hand side of the screen. Tick the box that says “share printers connected to this system”. At this stage, you’ll be asked for the username and password of the Raspberry Pi.

Plug your printer into one of the USB ports on the Pi. Click “add printer” in the CUPS web interface and it should appear under local printers. You’ll have to fill in details for the printer, such as name and location. You can enter whatever you want in here but the important part is ensuring you tick the “share this printer” box. Following this, you’ll have to select the appropriate printer driver from a (large) list that appears. Enter print and paper settings too. You’re now ready to click on maintenance > print test page. If everything has gone to plan, the test page will print successfully. You’re not done yet though….

You now need to set-up the Avahi service which will allow you to discover wireless printers on Apple devices. First, navigate to the opt directory, make a directory called airprint and move to it:

cd ../../opt
sudo mkdir airprint
cd airprint

Now, download the Python file which will help us generate the services we need (all one line):

sudo wget -O airprint-generate.py --no-check-certificate 

The permissions of the script need to be edited so it can be executed:

sudo chmod 755 airprint-generate.py

Generate the Avahi service and place the script in the appropriate folder:

sudo ./airprint-generate.py -d /etc/avahi/services

On generating the service I got the error shown below. This is fine if you don’t have any Apple devices running iOS6 but I’m willing to bet that most people with capable devices are running it.

image/urf is not in mime types, what_the_printer_is_called may not be available on ios6
(see https://github.com/tjfontaine/airprint-generate/issues/5)

To fix this issue, you’ll have to create 2 files in the /usr/share/cups/mime directory. These files will be called airprint.types and airprint.convs. Let’s start with airprint.types.

Use nano to create a new file and edit it:

sudo nano airprint.types

Insert the following into the airprint.types file:

# "$Id: $"
# AirPrint type
image/urf urf string(0,UNIRAST)
# End of "$Id: $".

Again, use nano to create the second file:

sudo nano airprint.convs

Insert the following into airprint.convs

# "$Id: $"
# AirPrint
# Updated list with minimal set 25 Sept
image/urf application/pdf 100 pdftoraster
# End of "$Id: $".

Restart the CUPS service now that changes have been made:

sudo service cups restart

The Python file which helped us generate services earlier needs to be re-downloaded to the opt/airprint directory

sudo wget https://raw.github.com/tjfontaine/airprint-generate/master/airprint-generate.py

Ensure that you’re in the airprint directory and regenerate the Avahi service (like before):

sudo ./airprint-generate.py -d /etc/avahi/services

Various files have been edited so I’d recommend that you reboot the Raspberry Pi around now. If you only have Apple devices, that’s it, you’re done- hopefully, everything should work. In my experience, I’ve found that the printer can be a little laggy and sometimes, it just doesn’t bother printing certain jobs from my iPhone. Don’t let that put you off though- most of the time it works as expected. I’ve had no problems printing from my laptop or iPad.




Now, I’m aware some of you will want to use the Raspberry Pi to print from Windows machine. If you want to do this, you’ve got a few more steps to go. Before I go any further, I’ll say that I tested this with Windows XP only- things might be easier with Windows Vista/7/8. Maybe things will need to be done slightly differently, I don’t know.

Install Samba on the Raspberry Pi which allows cross-platform file/printer sharing (basically allows Linux and Windows file systems to connect to each other)

sudo apt-get install samba

Navigate to the samba config file which can be found at- /etc/samba/smb.conf. Ensure it contains the following data:

	# CUPS printing.  See also the cupsaddsmb(8) manpage in the
	# cupsys-client package.
	   printing = cups
	   printcap name = cups
	   comment = All Printers
	   browseable = no
	   path = /var/spool/samba
	   printable = yes
	   guest ok = yes
	   read only = yes
	   create mask = 0700

	# Windows clients look for this share name as a source of downloadable
	# printer drivers
	   comment = Printer Drivers
	   path = /usr/share/cups/drivers
	   browseable = yes
	   read only = yes
	   guest ok = no




You’re now finished with the Raspberry Pi. Again, I’d reboot it anyway, just to ensure that all appropriate files are running with the configuration that you’ve entered.

So, you want to print in Windows, eh? Here it goes-

I’ll reiterate, I used Windows XP. Things might be different in Vista/7/8

Install the drivers for your printer

Navigate to My Computer > View workgroup computers > Raspberrypi server > Printername

A few dialogue boxes may appear but they should be ok

Select the appropriate driver from the list of printer drivers that appears and click ok

The printer attached to the Raspberry Pi will now appear in the control panel under printers and faxes

My printer constantly displays “access denied, unable to connect” but it still works anyway (I’ve got no idea why)

Finally, try and print something- the new printer will appear in the list of available printers. Fingers crossed, you should now be able to print from Windows too!

This tutorial is based on content from a few other sources:
Configuring the Raspberry Pi as an AirPrint Server
iOS6 Doesn’t Recognise CUPS Print Shares
Printserver for Windows Clients

Edit- I’ve noticed this tutorial was ripped to shreds by a user on Reddit earlier in the year, so I thought I’d clarify a few things. The distro I used was Raspbian (my previous posts about my Raspberry Pi show the version I used). Technically the tutorial is not Raspberry Pi specific and should work on other Debian distros too however, the Pi is neat wee computer to turn into a print server. Yes, I typed “sudo apt-get install” multiple times, instead of installing packages using just the one line, but I’ve mentioned in previous posts that I was a Linux n00b at the time.

On the positive side, thank you to everyone who has posted comments about the guide on my blog :). I must have done something right if so many of you got wireless printing to work! A few of you have mentioned that some of the packages are no longer necessary when setting up the printer- I’m considering putting an updated guide together to make it easier for folks.


  1. Many thanks, worked for me….

    It did not work just with CUPS for some reason i.e. not out of the box as someone said, for some reason! I would love to know why…

    Comment by terryw — May 18, 2015 @ 11:49 am

  2. does this support only printing or it just creates a network interface to the USB endpoints already known by an “all-in-one” printer’s windows drivers for scanner and Fax functions, too?

    I assume that if the printers drivers are installed on my Window’s PC, the R-Pi is just making the now-networked printer just look like it’s connected and the driver doesn’t care.

    so scanning and Fax and all other supported functions work the same? right?

    or this is a one-way print service only?

    Comment by PeteT — June 2, 2015 @ 8:23 pm

  3. Scanning won’t work I’m afraid- CUPS only handles printing.

    Comment by Lynsay — June 8, 2015 @ 11:47 am

  4. HI,

    I have setup an environment using pi (and CUPS) at home and it prints perfectly well (docx, xlsx etc) except for PDF format.

    I tried printing PDF formats and there are no errors nor response from printer. BTW, I am using a brother MFC.

    I have tried tried CUPS-PDF and it is not printing too.

    May I know if anyone encountered such issues and how to go about resolving it.


    Comment by cal — August 27, 2015 @ 1:00 pm

  5. […] NOTICE: This blog post is based on my original post from 2012 which you can find here- http://www.lynsayshepherd.com/blog/2013/01/14/wireless-printingairprint-server-via-the-raspberry-pi/. […]

    Pingback by Lynsay's Little World » Wireless Printing/AirPrint Server via the Raspberry Pi [updated guide] — October 18, 2015 @ 2:07 pm

  6. Thank you so much! This guide was very easy to follow and it even found my antiquated printer automatically over wireless 🙂 No more having to pull the laptop out just to print something- Straight from phone! 😉

    Comment by Ben Gillam — November 8, 2015 @ 9:24 am

  7. It failed at printing for Epson Printer, finally
    sudo apt-get update
    sudo apt-get dist-upgrade
    sudo apt-get install printer-driver-gutenprint

    saved the day by selecting the appropriate drivers

    Comment by Vijay Kiran — December 10, 2015 @ 6:17 pm

  8. […] job for my Raspberry Pi. The web is littered with instructions for this project. I mostly followed Lynsay Shepherd’s tutorial but not exactly. The steps I followed are […]

    Pingback by Raspberry Pi Print Server With AirPrint (iOS) Compatibility | A Whole Lot of Nothing — March 1, 2016 @ 5:33 pm

  9. Hey! I followed all the steps, and it seemed to work, but it said “The printer is offline” I did all the steps and checked that I did everything, but it still didn’t work.

    Comment by Martin Soendergaard-Jensen — October 30, 2016 @ 8:34 pm

  10. That is a really good tip especially to those fresh to the blogosphere.
    Simple but very precise information… Thank you for sharing this one.
    A must read article!

    Comment by canon driver — December 6, 2016 @ 3:10 am

RSS feed for comments on this post. TrackBack URI

Leave a comment

Note: Comments will not appear on the website until they have been moderated.