Getting started with Sailfish OS on Raspberry Pi 2

List of needs:

Raspberry Pi2
Network cable
Computer that has access through SSH
HDMI cable
Charger with a Micro USB. (Charger needs to be +2Amps..)
MicroUSB reader
Micro SD card (At least 8Gb)

Setting up the Raspberry Pi
Connect the Raspberry Pi to the network or directly to your computer. Notice that you’ll need to configure the network settings so it can stream ‘internet’ through the network cable.

Download the version ‘’ that is packed by Locusf from: Here

After you have downloaded the image.xz file, open up the terminal and cd to the directory where the downloaded image are.
Use the ls command to get the name of the image.xz in the directory.
To uncompress the image.xz file you simply write this command: unxz filename.image.xz

After the unxz command is done we will now extract the filename.image to the Micro SD card with following command: sudo dd if=filename.image of=/dev/sdf bs=2M

When you are done, unplug the Micro SD card from its slot. And plug it in the Raspberry Pi.

Connect the HDMI, Network cable and the power connection.

If you don’t know the IP address for accessing the Raspberry Pi and you are just having the Network cable connected between your computer and Raspberry Pi we suggest that you will run ifconfig/nmap to find out which IP address it use.

To connect to the Raspberry Pi: ssh root@ipAddress
Password is: root

Now you should see the Sailfish desktop.

Then you’ll need to: reboot (The last time..)


38 thoughts on “Installation

  1. After booting the pi for first time i get a freeze with the spinning startup thingy… after pulling the plug and restart i get a spinning thingy again and after a while a frozen sailfish startup screen which reboots after every 2 minutes…


    1. I have the same problem. Can SSH to raspberry pi to reboot, but get stuck again on that same loading screen. any progress?


      1. found out what the problem was. hadn’t installed glacier. new problem though: after a few seconds of working gui the screen just goes black. Its also no longer possible to move the mouse.

        The official raspberry pi touchscreen is also not showing anything, but external monitor is.

        (I’m using the sailpi build)


    1. I don’t know how you managed to not get it working. But both locusf and I can assure you that it’s working on our Raspberry Pi2’s!



  2. Hi, what is the purpose of the gparted/format part of the instructions? IMHO the new image will overwrite whatever partition table and partitions/content the SD card had. After writing the image to SD card, rootfs filesystem was a bit broken (corrupted orphan linked list etc.). I also wonder why rpi-update is needed, in rasbpian it is really bleeding edge and generally not needed, and it also overwrites files from other (stable) packages (just try debsums -c after running rpi-update). Killing rpi-update does not sound like a great idea to me. After first boot I did not see sailfish desktop, whole screen is just lightgrey/white and mouse is stuck in upper left corner of the screen. Will try to run rpi-update and reboot now.


    1. Hi, you’re right, gparted/format is not needed. Rpi-update should not be needed now as I’ve done that now. It was needed when the system was clean in the previous image.

      As for killing rpi-update it is indeed not a good idea to kill it. But there is a hack in the image which puts a symlink for /opt/vc -> /usr so thats why the rpi-update script gets stuck at first.

      If you ssh into the raspberry pi you can issue:

      su nemo
      systemctl –user stop voicecall-ui-prestart

      to regain control of your sailfish desktop.

      I’ll update the guide to match this, thanks for your comment!


      1. Hi, and thanks for quick reply!

        I did su nemo and systemctl –user stop voicecall-ui-prestart (double dash before user, no errors from systemctl) and since nothing happaned I rebooted but the whole screen is still lightgrey/white, and mouse is stuck. Ctrl-alt-del from the keyboard/mouse combo restarts the raspi so I guess it works. Mouse was working with the previous Image I tested, and then I was able to see sailfish desktop (but could not install glacier).

        Anything else I can do? I’m new to Jolla but have been using other distros a lot, mainly rasbian in raspi, but also a bit of pidora and osmc.


      2. Hi,

        I forgot that you also need to doubleclick on your mouse in order to “unlock” the screen, this should work out for you now.

        On Sat, Mar 14, 2015 at 11:23 AM, Sailfish on Raspberry Pi2 wrote:



      3. I had an error
        [nemo@Jolla root]$ systemctl –user stop voicecall-ui-prestart
        Unknown operation ‘–user’.

        I tried with both single dash and double dash still the same. What did I do wrong?


  3. I am having similar problems as Paavo.

    Here is a picture showing the screen where it gets stuck.

    What is the best way to get news and updates about Sailfish OS on Raspberry Pi 2?


    1. Hello,

      Sorry that you are havIng trouble with this. The current installation instructions don’t provide a clear way to troubleshoot issues. I suggest you follow me on twitter to get updates on the project status.

      In the meanwhile, if you can still ssh into the pi, you can issue a command which disables the screen lock altogether:

      mcetool -j enabled

      This is the cause for the screen to get stuck.


  4. Hi guys! That is awesome for running an new OS on rpi 2 ! May i ask you whether the RCA port will works or not on the Sailpi OS? 


  5. Hi guys, I run the Glacier on Berryboot (I’m still retaining access to multiple distros). I managed to change the orientation to landscape. However the mouse cursor is still invisible. Any way to overcome the issue?

    Liked by 1 person

  6. pkcon upgrade is give me this:
    Päivitetään paketteja
    Odotetaan tunnistautumista
    Ratkaistaan riippuvuuksia
    Asennetaan päivityksiä
    Ladataan paketteja
    Vakava virhe: Tiedostoa “./qt/armv7hl/qt5-default-5.2.1+git14-1.22.2.armv7hl.rpm” ei löydy tietovälineeltä “”


    1. Morjens,

      Kannattaa root-käyttäjänä laitella:

      ssu re
      zypper ref

      Ota yhteyttä twitterissä jos ei lähde pelittämään, teen jossain vaiheessa täysin imagen jossa on first-run tutoriaalit ja muut.


  7. Hello, When I boot I get to a language selection screen, but I cannot select the language via my keyboard. I can scroll through the list but nothing else. Is there a solution to this problem?
    Thanks, Stephen


    1. Sorry, this is quite awkward, but Sailfish is not really designed to be controlled with a keyboard.

      Make sure you create the following files to /home/nemo via ssh and change their owner/group as such:

      -rw-r–r– 1 nemo nemo 0 Jul 11 2014 .jolla-startupwizard-done
      -rw-r–r– 1 nemo privileged 0 Sep 9 19:21 .jolla-startupwizard-sfos2-tutorial
      -rw-r–r– 1 nemo privileged 0 Sep 9 19:21 .jolla-startupwizard-usersession-done

      This way the first run tutorial is skipped.

      Liked by 1 person

  8. Hallo,
    I tried but stuck after the first boot and the selection of language and so on (the circle stopps turning after ~30sec).
    I connected via ssh and did a reboot (tried it several times) but it is always the same.
    Any clues?

    I am also interested in using the original RPi display as Mario pointed out and would love to use a RPi3.
    Any progress on that? It seems that it got really quiet concerning SailPi.

    BR HoWil


      1. Thanks locusf. I will copy the whole /lib/firmware folder from the Raspbian SD-Card to the SailfishOS SD-Card. I hope the wifi will work afterwars. How it looks like with OTA Updates. can i ssu re or and version –dup afterwards?

        Do i need special adaptation0 repo after each update?


        PS: Maybe you are somewhere on XMPP / IRC, where we can talk about sailpi port. Maybe IRC freenote #sailfish-porters ?

        Thanks again



  9. I was able to get v1.1.9.28 this working on my pi2, but get no graphics on official 7″ touch screen. I ran dmesg and it had an error saying something like:
    [number] rpi_tf5406 rpi-ft5406: Touchscreen not detected.
    Any ideas?


  10. Olhem bem para o prédio, os sinais. Que porcaria, que desleixo! E no entanto, podia ser bem dieefentr. Apenas em Lisboa, ou alguma cidade em guerra civil, se podem ver estes cenários!


  11. This site is just gret. I’ve search these details a long
    time and I realised that is good written, easy to understand.
    I congratulate you for this research that I am going to tell to people friends.
    I ask you to visit the site where each college student or college student can calculate results
    grade point average marks. Success!


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s