Run a PaperCut NG or MF Release Station from a Raspberry Pi
KB Home | 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 PaperCutrelease station.
Go to our download page to download the PaperCut Release station image built on top of Raspian GNU/Linux.
In addition to this, we have a PaperCut GitHub repository for our Raspberry Pi Release Station with more recent changes and developments.
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.
1. On a workstation (Mac, Windows or Linux) download and unzip the PaperCut Raspberry PI Release Station image from the above link.
2. 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.
10. 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
11. Configure other options if required.
12. Exit raspi-config.
13. Delete the file /boot/prompt4Locale
14. Run the command sudo init 6 to reboot the Pi
On the current image password for pcadmin user is password. This should be changed.
On the current image password for papercut user 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 pcadmin and do whatever you need to do. e.g. sudo init 0 to shutdown or sudo init 6 to 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.
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!
How to install a custom logo for the release station
1. 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).
2. Copy over the image file to the SD card. Let’s pretend it is called myimage.png
3. 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 "logo-image=/boot/" is fixed.
4. Unmount the SD card.
5. Test to make sure the custom logo is installed.
When I start up my Raspberry Pi Release station, it stops at Press any key to continue; how do I remove this prompt?
The 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: /usr/local/papercut/.profile
For example: sudo nano /usr/local/papercut/.profile
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.
This release contains an updated Java version which no longer supports 32-bit workstations. If you have any 32-bit users launching the User Client or Release Station from a network share, see this Knowledge Base article for more information.