XS Community Edition/5.0/Installing

Jump to: navigation, search

This IIAB XSCE content does not reflect the opinion of OLPC. These pages were created by members of a volunteer community supporting OLPC and deployments.

Pencil.png NOTE: The contents of this page are not set in stone, and are subject to change!

This page is a draft in active flux ...
Please leave suggestions on the talk page.


This is a draft pending release of XSCE 0.5 which is renamed 5.0.

Installation Overview

XSCE 5.0 is the first release to use github (https://github.com/XSCE/xsce) for source control and ansible as a means of installation.

Thank you for testing and providing feedback.

Installing on XO-4, XO-1.75, or XO-1.5

The documentation in the github repository is the best and most detailed guide to installing on an XO. Please read the section on automatic network detection as it will determine whether the XSCE server is configured as a gateway or as a standalone appliance.

The documentation may be found at https://github.com/XSCE/xsce/blob/master/docs/INSTALL.rst.

Install Recipes for Non-XO Hardware

Professional volunteers are strongly encouraged to reinforce support for other hardware platforms running Fedora 18. Each of these other platforms installs in an almost identical fashion except that there is no need for a reboot and there is usually no power management to deal with. As in the case of an XO make sure your Ethernet adapters are connected before starting the install. Simply follow each step listed for an XO.

For now we have:

Intel i386, i686, X86_64

  1. Install FC18 onto your machine or vm. The minimal install is sufficient.
  2. Ensure your Ethernet adapter(s) are connected.
  3. Ensure you are root
  4. Follow the instructions for an XO mentioned above.


  1. The internal ethernet is configured as external internet connection and wifi is enabled as lan connection, (a second USB adapter required for connection to additional wifi access points).
  2. Grab the Fedora 18 Trim-Slice image at http://fedoraproject.org/wiki/Architectures/ARM/F18/Trimslice -- use the armhfp version. (I needed to yum -y install xz to follow the xzcat <image> > <device> instructions).
  3. For a while I used a SATA hard drive adapter to initialize the hard drive. Later I have started to use the Trim-Slice kernel made for flashing the internal uboot loader, which installs on an SD card, and can write the SATA drive in place.
  4. I found it necessary, during installs, to use a serial to usb adapter, and an XO running minicom (for me this uses /dev/ttyUSB0 115200).
  5. edit the /boot/boot.scr as per instructions for USB/SATA, put the hard drive in the Trim-Slice, and boot
  6. Now follow the instructions for an XO mentioned above.

Raspberry Pi

Installation on the Raspberry Pi is experimental.

  1. Install FC18 on the raspi following instructions for Pidora at http://zenit.senecac.on.ca/wiki/index.php/Pidora_Installation.
  2. Ensure your Ethernet adapter(s) are connected.
  3. Ensure you are root
  4. Follow the instructions for an XO mentioned above.

CAVEATS: Raspberry Pi is armv6 architecture, and XO is armv7hl. Some rpm packages are not available in the required form and some functions will have incomplete support. i.e:

  1. Stats
  2. Internet-In-A-Box
  3. ejabberd