Run a PaperCut NG or MF Release Station from a Raspberry Pi
Obtain the latest Raspberry Pi Release Station image
The Raspberry Pi is a great little low-cost educational computer platform that some people use as a low power consumption PaperCut release station.
Please download the PaperCut Release station image built on top of Raspbian GNU/Linux below:
- This image requires a 16GB SD Card.
- This image is based on log4j v2.17.1.
Setup instructions for the Raspberry Pi Release Station
The instructions assume some basic understanding of managing Raspberry Pis and using the Linux command line. It is very unlikely that a Pi Zero or a Raspberry Pi model A will be suitable because of a lack of network and USB connections.
- On a workstation (Mac, Windows or Linux) download and unzip the PaperCut Raspberry PI Release Station image from the above link.
- Copy the image to a suitable SD card (NB the current image will fit on a 4GB card). A class 10 SD card is recommended. Instructions to do this can be found at the following links.
- With the SD card still mounted (it may be need to re-inserted to force a re-mount) in the workstation edit the following files in
pc-config.properties. Follow the standard release station documentation
pc-connection.properties. It contains the IP address of the PaperCut application server and the port number to use for communication.
- Unmount the SD card from the workstation.
- Insert the SD card into your Pi and power it up. It should (eventually) boot up into the release station display or display an error message that it cannot contact the PaperCut application server. On newer versions (16.3 and above) of the release station image you will be reminded to configure the keyboard, timezone and locale (see below).
- From a workstation on the same network use ssh to connect to release station.
- Login as the admin account, currently username
password. On images before release 16.3 it’s username
- Make sure the operating system is fully up to date with the command:
sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get dist-upgrade -y
- Run the command:
sudo raspi-configSee http://elinux.org/RPi_raspi-config#Running_raspi-config_another_time for more information.
- Set the options options for your region (i.e. timezone, locales, keyboard). Note that in order to configure a keyboard you will need a USB keyboard connected to the Pi, even if you are connected across a network
- Configure other options if required.
- Exit raspi-config.
- Delete the file
- Run the command
sudo init 6to reboot the Pi
- On the current image password for
password. This should be changed.
- On the current image password for
papercutuser is secure and unknown.
- To shut the release station down or perform system maintenance:
From a workstation on the same network use ssh to connect to release station.Login as user admin and do whatever you need to do. e.g.
sudo init 0to shutdown or
sudo init 6to reboot.
- All these commands are executed on the command line unless otherwise stated.
- Use a good quality class 10 SD card.
- Each connection of the release station requires a PaperCut release station license (one connection license is included in the base product for testing).
- Every time the Raspberry Pi reboots it will automatically perform a file system check and repair.
Q Can I use a card reader for authentication on a Raspberry Pi Release Station?
Yes you can! The compatibility of each card reader would need to be tested but it is possible to authenticate on a PaperCut Raspberry Pi Release Station via a card reader!
Q How do I install a custom logo for the release station?
- Mount the SD card into the desktop workstation. This means you should be able to edit the config.properties file (located on in the partition that get’s mounted as /boot on the Pi).
- Copy over the image file to the SD card. Let’s pretend it is called
- Edit the config.properties file on the SD card. Specifically you need a property that says
logo-image=/boot/myimage.png— make sure you use the correct filename for your image file. Note that the text
- Unmount the SD card.
- Test to make sure the custom logo is installed.
Q When I start up my Raspberry Pi Release station, it stops at
Press any key to continue; how do I remove this prompt?
Please Wait screen displays the IP/Hostname so that the Admin can SSH in with their Admin User to make changes. By removing this screen, we must then assume that the admin knows the: IP, Hostname, Admin Username & Password. To remove this message:
- SSH into the Raspberry Pi Release Station as the Admin User.
- Edit the following file with root privileges:
- For example:
sudo nano /usr/local/papercut/.profile
- For example:
- On line 28, comment it out with a
#at the start of the line and then save the file.
- Reboot the Pi.
The screen should only flash on the screen and then afterwards it should boot into the PaperCut Release Station as per usual.
Categories: How-to Articles, Releasing Print Jobs
Keywords: installer, image, linux, usb