Version 6 (modified by GNUtoo, 7 years ago) (diff)


What to install?

There is more than one way to install SHR on the openmoko phones, simply because they have:

  • A microsd slot
  • 256M of flash(freerunner/gta02) or 64M of flash(neo1973/gta01)

And also because there are more than one version of SHR:

Combined with different image versions:

  • shr-image Lite
  • shr-image Full
  • aurora image

The actual Installation

Installing on the Flash using a GUI

We're going to assume that you know how to use NeoTool.

First, determine which model of phone you have, the GTA01 (neo1973) or the GTA02 (FreeRunner).

You need to download two files from your prefered version above:

  • The kernel (uImage*.bin)
  • The root filesystem (shr*.rootfs.jffs2)

Choose if you want the lite or the complete SHR according to this page. Please note that the GTA01's internal flash only has room for the unstable version's LITE image.

Installing on the microsd from the command line

  • Download an image
  • Connect your microsd to your computer
  • format your microsd to ext2 or ext3(that loose all the data that is on it)
  • mount your microsd
  • go inside the place where your microsd is mounted
  • extract the image to the microsd:
    sudo tar xvzpf  /path/to/full-om-gta02.tar.gz --numeric-owner

Installing on the flash from the command line

Post install

Connecting your FreeRunner to your computer

For the next configuration steps, you will need to type some commands. It is much easier to type on a real keyboard than on a touch screen. So you need to connect your FR to you computer, and make a bridge to internet. Use this page

Update your system

First of all, in setting menu, put "suspend" on "off". Just type

opkg update
opkg upgrade

Setting local time

As any linux system, the UTC time is used by the system. First of all, adjust this time:

date -u -s 010220052009
 Fri Jan  2 20:05:00 UTC 2009

Then, you need to "localise?" your system. Search for the appropriate country with:

 opkg list | grep tzdata

then install the one corresponding to your area.

opkg install tzdata-europe

Then select your city (search the city availabled in /usr/share/zoneinfo/your-country)

You can fully localise your system by installing the glibc-binary-localedata corresponding to your language. Search the ones available with:

opkg list | grep glibc-binary-localedata

install with

 opkg install glibc-binary-localedata-fr-fr

(example for France)

 ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime

Changing root password

SHR is shipped without root password. This is very dangerous if you connect using wifi, or USB. You must activate the root password:


then type your selected password two times, otherwise you will not be able to get your FreeRunner connected to your pc.