Image V6 with Repetier-Server 0.80.3 for Raspberry Pi


  • V3 introduced a new webcam system, incompatible with V2. 0.80.1 will ignore autoconfiguration from V2 image but server will still work.
  • V4 fixed a problem with network-manager preventing connections to network to work.
  • V5 improved webcam configuration. Now allows setting resolution and frame rate from printer webcam configuration.
  • V6 fixes wifi issues, adds screensaver control.

Installing the Image

After you have downloaded the image, you need to unpack the zip file. It will show you a .img file, which you need to copy to your SD card. For this you need a 4 GB SD card or bigger. On a 4 GB card you have only 2 GB free space left, so a bigger card is a good idea. Our preferred size is 32 GB, which offers a good compromise between space and price. Also bigger cards live longer as we have more blocks to write to.

To copy the file to your SD card, follow the steps described here:

First Steps

Shut down any running instance and place your newly created image in your Raspberry Pi and boot. If you have a HDMI display connected, you will already see the front end. At this point you have probably no internet connection and also no license entered (required for printer front end). So what you see is the registration page instead. Later it will directly boot into the normal front end.

The first thing to do is connecting the Raspberry Pi to your internet. The way that always works is using an ethernet connection. It will get a IP from your DHCP server and you can connect to it using http://.
If you have a working touchscreen already, you can configure your WLAN directly on the display.
The last solution is using a smartphone or laptop with WLAN. Initially the image is configured to run as access point. So check your WLAN access points and select RepetierServer and connect using the password 12345678. The server only talks once a minute with os to get latest wifi status. So it might take a few minutes for changed settings to be seen correctly. Then open http://repetierserver.local/ or if your device does not understand bonjour protocol and go to Global Settings WLAN. There you can select your WLAN access point. After the connection is established, the Raspberry Pi access point will stop working and you have to access the server with the new IP it got from your network. In case of using http://repetierserver.local/ you connection will reestablish as soon as your device is back in your home network.

Next thing you should login to your Raspberry Pi command shell using ssh. For users unfamiliar with ssh – this is a protocol to gain access to the server on a command line level like cmd.exe in windows. If you are a windows user, you will most likely not have a ssh command. You can download and use for this. So connect with user pi and password raspberry to the commandline.

Now you are logged in as user pi. For security reasons, you should change the default password to something only you know. To change the password, use the “passwd” command. When finsihed, you can log out (ctrl+D).

It is a good idea, to configure your DHCP server (normally part of your router configuration) to always assign the same IP number. This is done by assigning a static IP to the MAC address. You find the raspberry MAC address in our web front end on the home page. Scroll to the bottom and you see for every network device the matching MAC address you should use in your router.

Now plug in your printer and start configuring your first printer as described in the server manual.

Special Cases / Troubleshooting

WLAN connection problems

The automatic wlan setup is a complex issue especially if a router changes channels (automatic channel selection) or if the signal gets lost from time to time. First thing to check is what channels your router uses and what channels you can receive. By default the pi will only listen on channels 1-11. Channels 12 and 13 are only allowed in special regions, so select your region if you need them. If you live in such a region your router might also use this channel or if it automatically selects the channel even switch between visible and invisible channels so your pi might disappear from network.

The other issue is an unstable connection. The server monitors connection and when wifi signal is broken it goes to access point mode or tries to reconnect if the ssid is visible. Unfortuantely, if then the connect fails, we assume password is incorrect and delete the connection. So you would need to reenter password to connect again. You can disable this behaviour if you login using ssh and run:

sudo nano /usr/local/Repetier-Setup/bin/manageWifiAccess

and search for

        nmcli connection up "$P1" &> /dev/null
        if [ $ret == 0 ] ; then 
                echo "OK"
                nmcli connection delete "$P1" ifname $WLAN  &> /dev/null
                echo "Failed"

and put a # before the “nmcli connection delete” line and save. This will prevent loss of password and tries to reconnect everytime it sees your router until it succeeds again.

No Display

If you have no display, you should not start x environment and web browser since this only costs RAM you could better use.
So in that case, log in and edit .bashrc in your home directory:

nano /home/pi/.bashrc

Go the end of the file and comment the end like this:

#if ! pgrep "xinit" > /dev/null
#    xinit -- -nocursor &

And on next reboot the x server will not start.

Rotate Display

Depending on how you have mounted the display, you may need to rotate the screen. To do this, login and run

sudo nano /boot/config.txt

and search for a line

# Rotate screen 180°

A value of 0 is no rotation, 2 = 180°.

Non HDMI Display

There are several cheap LCD displays available, that you can simply put on the Raspberry Pi header pins instead of using
the HDMI connector. Especially small displays with resolutions up to 480×320 pixel use this way. In that case
the images need to be rendered in a frame buffer that gets send via spi to the display. If you have such
a display, follow the instructions of your display vendor to configure the display. After a final reboot the
printer front end should then start automatically.

Disable Display Power Saving

In the screensaver settings you can activate/deactivate the hardware screensaver, that turns the display off. Some users report that sometimes
the active hardware screensaver does not come back. This is a function from Linux/X11 and we only set the timeout using the xset command. If that
is the case, please disable hardware screensaver. Your image will still darken after timeout, just not try to disable the hardware light as it would
try to do with hardware screen saver. If someone has a hint what prevents linux from wakeup the screen, please let us know.

Webcam Support

The image is preconfigured to handle a USB or Raspberry Pi webcam. We have implemented an autodetect for webcams. To configure it, simply go to Printer Settings Webcam and select the webcam at the bottom and click Assign.

It will start the webcam server and fill in the correct settings. If you have unplugged the webcam, the webcam server will start automatically when you plug in the webcam. Additionally you can set webcam resolution and framerate. Consider that higher resolutions and frame rates need more bandwidth and CPU usage. If this causes any problems like delays or blank screens, reduce them.

Webcam does not work

Some users seem to have no webcam support with current settings. Send on console

/usr/bin/v4l2-ctl --list-formats-ext -d /dev/video0

to see what modes your webcam supports. Then edit /usr/local/Repetier-Setup/etc/webcam.conf to use one of the resolution/frame rate combination that your webcam supports. After that reboot the Pi so the changes take effect.

Import from USB Stick

Initially the server is preconfigured to import files from a USB stick. Just insert a USB stick and it will
auto mount the drive. If you then select the import function it will show the files on the USB stick.