Raspberry Pi Image

Notice: The contained Repetier-Server is optiized for armv7l chips used on bigger Raspberry-Pis. It will not work on Pi Zero and Pi 1. To make it work for these boards, login over ssh und run “installLatestServer”. This will detect your board and install the latest version for your board.

Notice: If touchscreen registry does not show your WLAN, please change language to force reload, then it should appear.

Hint: Read Prepare Prusa MK3 if you use the image with a Pi ZeroW. It contains useful informations how to conect to it headless and how to secure your image.

Show Changelog
  • V3 introduced a new webcam system, incompatible with V2. 0.80.1 will ignore auto configuration 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.
  • V7 wifi management improved, packages updated
  • V8 based on stretch, first Raspberry Pi 3+ compatible image.
  • V9 improved webcam handling. Assigns ports now by webcam name so multiple webcams get always the same port. Disable printer GUI with config file.
  • V10 Fixed problems with raspi cam not starting.
  • V11 Ready for Raspberry Pi ZeroW on a Prusa MK 3 (or any Rambo Einsy board), wifi improvements.
  • V12 Fixes usb automount problems added with stretch.
  • V13 removed dtoverlay dwc2 from /boot/config.txt as that seemed to make problems with bandwidth.
  • V14 Added remote desktop server.
  • V15 Now based on Raspbian buster, Raspberry Pi 4 support, fixed USB stick mounting, chinese chars working.
  • V16 Fixed webcam scripts to new V4L format.
  • V17 Fixed wifi problem, 0.92.1 server version.
  • V18 Access point handling changed, 0.92.2 server version.
  • V19 Fixed setting static routes for wired connection.
  • V20 Increased boot partition to fit Raspberry Pi 4 image as well.
  • V21 New wifi management, more checks, armhf server as default.
  • V22 New linux kernel 5.4.51, detect wifi driver crash, up to 3 usb sticks will automount.
  • V24 New kernel 5.4.79, better wifi handling, Chromium 86.0.4240.197
  • V25 Allows manual override of wifi configuration. See /boot/wpa_supplicant-wlan0.conf.sample
  • V26 Add duet control server and duet web server, kernel 5.10.17-v7+
  • V27 Modified chromium call to prevent incognito warning with latest chromium version
  • V28 Fixed problem with new chromium stucking in incognito dialog, autoclose splash screen

Notice for Raspberry Pi users

The Pi is very power sensitive. If it does not receive stable 5V, you may experience stability issues like bad connections or temperature errors. Use a solid 3A power supply, best with 5.1 V output. Also a cheap usb cable with thin wires can cause voltage loss. We recommend an AWG20 USB cable.

Installing the Image

After you have downloaded the image, you need to download the balenaEtcher to flash the image to the SD card. 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.

Download balenaEtcher:


Flashing ist really easy:

  1. Start balenaEtcher.
  2. Clicke Flash from file and select the downloaded Repetier-Server image as ZIP file.
  3. Select your SD card as target.
  4. Click Flash! and wait, until it’s finished.

First Steps

If you have no screen on your pi, you can already disable that. On windows you see only the /boot directory. Edit the file “repetier-image-setup.txt” to disable GUI.

If you have a screen connected, also check config.txt. Search the line


And set the rotation value: 0 is no rotation, 2 = 180°, 1 = 90°, 3 = 270°.

Starting with image V26 repetier-image-setup.txt allows also enabling duet control server and duet web server. So you do not need to install it manually. Since Repetier-Server 1.1.0 we support direct connection to the duet control server.

Tip: You can also set the wifi connection parameter in windows, see https://www.repetier-server.com/knowledgebase/wlan-configuration-on-sd-card/

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://repetierserver.local/  (http://repetier-server.local/ on older images).
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://repetier-server.local/ or if your device does not understand bonjour protocol and go to    Global Settings   Network/Time. 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://repetier-server.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 https://www.putty.org  for this. So connect with user pi and password raspberry to the commandline. Starting with V14 you do not need putty any more. You can start remote desktop connection on windows, enter IP and accept the unsigned certificate. Login and open with a right click a terminal. If you enter commands in that terminal or over a ssh connection makes no difference.

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.

WLAN manual override

Starting with image version 25 you can simply define your wpa wifi configuartion in the /boot directory and it will be activated on next boot. This will also prevent the Repetier-Server from changing wifi. It will only query current state to show it. Check the file wpa_supplicant-wlan0.conf.sample – it contains all instructions as comments.

No Display

If you have no screen on your pi, you can disable the start of x server and chrome. This reduces CPU and RAM usage. Especially if you have sometimes the problem that the printer disconnects from low power – this might help reduce or even remove the problem.

Change in Windows

On windows you see only the /boot directory. Edit the file “repetier-image-setup.txt” to disable GUI.

Linux solution

Log in and edit /boot/repetier-image-setup.txt

nano /boot/repetier-image-setup.txt

Edit the disable GUI option to our like and safe using Ctrl+X.
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.