• Čeština
  • Español
  • Italiano
  • Deutsch
  • Polski
  • Français
  • 日本語

PrusaLink Troubleshooting

Last updated 7 days ago
This article is also available in following languages: 

This guide will help you solve the most common issues with the PrusaLink and Prusa Connect installed on MK4 MK3.9, MK3.5, MINI/+, XL, MK3/S/+, and MK2.5/S.

Original Prusa MK4, MK3.9, MK3.5, XL, MINI+, MINI

The browser login does not work

Attempt the login using another browser, some browsers might have issues with the PrusaLink login. 

The printer does not establish a connection (8+ minutes)

Double-check the credentials in the prusa_printer_settings.ini file, and load them again in the USB drive. On each field, ensure that there is no space before and after the = character. Having the following special characters as part of the SSID would also cause the connection to not be established, make sure they are not part of the SSID: 

  • - (Dash)
  • _ (Underscore)
  • ' (Apostrophe)
  • . (Dot)


On the MINI/+ with firmware version 4.4x and older, the prusa_printer_settings.ini file might show an extra row, ensure that this is not changed (key_mgmt=WPA)


Original Prusa i3 MK3/S/+, MK2.5/S

Bad X-Api-Key

If PrusaLink is selected in PrusaSlicer, it is necessary to enter an API key. For PrusaLink 0.7.0 or higher, the API key can be found in Prusa Connect, in the Settings tab, on older versions it is shown during the PrusaLink Wizard. Alternatively, select HTTP digest for authentication and add your PrusaLink username and password.

500 internal server error

This error is caused by the printer serial number not being written properly on the printer Einsy board EEPROM. The solution is copying the serial number to the Einsy EEPROM, with the following procedure: 

  1. Connect a power bank, a USB charger, or another source of power (excluding a computer) to the printer USB type B port.
  2. With the printer switched on, press the reset button. 

Some options in printer detail are not available

  • Make sure the printer is online and ready
  • If you do not see any options at all, make sure you have the correct version 0.6.1 of the PrusaLink SD card image flashed to your RPi. In case of doubt, download the PrusaLink SD card image again.


  • Wait for up to 5 minutes, sometimes it shows the IP later.
  • Make sure you have Wi-Fi within reach and in 2.4 GHz.
    5GHz Wi-Fi is not supported.
  • Set up the SD card in Pi Imager again, making sure you have the name and password entered correctly in Pi Imager settings.

The IP address is not shown

  • Make sure the RPi port option in LCD menu -> Settings -> RPi port is ON. 
  • Check that the green LED is on or flashing at the bottom right corner of the RPi.
    If the green LED is not on or flashing, the RPi is not working. Review the soldering of the pins, and make sure the pins are long enough. You can test the Pi by connecting it to USB power, but make sure it is not connected via pins to the Einsy board in that case!
  • Check that the SD card can be accessed on your computer. Try a different computer if possible, or set up the SD card in Pi Imager again.

Credentials cannot be saved on RPi Imager

Ensure that the network has a password. A network without a password cannot be saved on the RPi Imager.

White/blank screen after finishing the Wizard

Make sure you are logged in on connect.prusa3d.com.

Forgotten login/password to the Link’s website or printer accidentally removed from Connect

It will be necessary to go through the wizard again. Remove the prusa_printer_settings.ini file from the folder /home/pi, and set up the SD card in Pi Imager again.

Flashing takes a long amount of time (20+ minutes)

  • Make sure you are using a Class10 micro SD card or better. Slow microSD cards affect the speed of the flashing.
  • Some computers, especially old ones, may have a slow SD card reader. Try the USB reader, if available.

The wizard is slow (2+ minutes to load the next page)

  • PrusaLink might be still loading. Wait for a few minutes and try again.
  • Make sure your computer and your printer are connected to the very same network. For example, if your computer is connected by cable and your printer is connected via WiFi, it can cause this issue.

The LCD shows “Starting PrusaLink” after 5+ minutes (MK3/S/+)

Slow uploading of the G-code to PrusaLink

The upload speed is limited while printing to prevent slowing down the print.

The Wizard can’t get the serial number from the printer (Err obtaining SN)

Make sure you are using the latest firmware version

Contact our Customer Support if the previous step is not solving the issue. 

Error bad token

This may occur if you use PrusaLink on a different printer than the one it was set up with. In this case, make a fresh PrusaLink installation.

Err unsupported FW

Upgrade the printer to the latest firmware.

Was this article helpful?


Still have questions?

Still have questions?

If you have a question about something that isn't covered here, check out our additional resources.
And if that doesn't do the trick, you can send an inquiry to [email protected] or through the button below.

Contact us