OpieUserManual/Installation

= Installation =

iPAQ
To have Opie 1.2.1 on an iPAQ, you have to install a Familiar + Opie image on your iPAQ. An image is in fact a file, containing the memory image of an iPAQ with Familiar (the Linux distribution) and Opie (the graphical platform) installed. You can download it from the Internet, then load it in your iPAQ through a Compact Flash card, serial port or USB.


 * To start with, go to the Familiar download page.
 * Select the model of your iPAQ under "Please select your hardware", choose stable, v0.8.4 as the Familiar version, and Opie as the set of files, and press Download.
 * Follow the Familiar installation instructions then, to know how to upload this image file on your iPAQ.

Configuring a network connection for the iPAQ is then very useful, in order to install new packages, or upgrade existing ones (to get new features or bugfixes, for example). The Familiar site provides instructions for connecting the iPAQ to the Internet in a variety of ways. See this iPAQ networking documentation to have information on configuring PPP or USB, and masquerading (giving access to the Internet through your PC), for example.

When your iPAQ is connected to the Internet, you can (and should) do several things, in the command line, using Familiar, as noted in the Familiar post-install page, or using Opie applications.

ntpdate -b time.handhelds.org
 * For example you can synchronize the iPAQ clock with network time servers. There is a graphical way to do that through the Settings / Date/Time Opie application, or you can also run as root the following command:

ipkg update
 * To teach to your iPAQ what are the new packages or updated packages it can dowload, run the command (as root again):

Or use the Settings / Packages Opie graphical application. ipkg upgrade
 * To download and install automatically new versions, if they exist, of your installed packages,

Or use the Package Opie application again.

Zaurus
The usual way of installing Opie on Zaurus devices is to replace the default Zaurus ROM with the OpenZaurus ROM image. OpenZaurus is a openly developed Linux distribution designed to run on the Zaurus, and uses Opie as its default user interface. For more information and installation instructions, please visit the OpenZaurus.org web site.