Debian Wheezy Instructions

From odroid US
Revision as of 22:07, 20 January 2014 by Osterluk (Talk | contribs) (Adding an X Display Manager)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


This effort started before HardKernel had a supported Debian image, now they have some. At this writing the official build comes with the LXDE window manager installed -- depending on odroid board type.

There are some great full-featured user-contributed images available (GUI, XBMC and so on). For example: @robroyhall images

In order to keep this branch relevant, it has been updated to match the Hardkernel setup. It has the same bootloader, boot scripts, partition layout, kernel version, and kernel modules -- only it is headless, meaning no GUI. The approach is modular and you can follow the steps to add Gnome or XFCE as you like.

The images have full provenance, you could create the same setup starting from bootstrapping with an emulated ARM. This topic is meant to help teach about embedded Linux.


  • minimal system (base) - headless or server-style. Login with USB-UART kit or using ssh. No GUI.
  • system with visual desktop (gnome, xfce) - recommended for new users
  • root filesystem only (rootfs) image - Need special handling. Tutorial: Updating from Root File System Images

For Linux host users, see Tutorial: Step-by-step SD-Card setup on Linux host

For Windows users, see Tutorial: Step-by-step SD-card setup on Windows


Several Debian SD-Card images and root file system images are available for various odroid boards. This set of links is not complete. You can browse the download area for more.


Download Area

Note: The file arrangement is by hardkernel board names. Make sure to download from the area that matches your board.

The download area is here:


Writing the base SD-card image and booting will give you a complete, headless Debian system.
Headless, meaning only the Linux console is active -- not the HDMI display.

The network will come up automatically, using DHCP and the ssh daemon will be started so you can connect from another computer -- even without the USB-UART kit.


Version 7 Credentials

As of release 7, the login credentials are odroid/odroid and root/odroid in order to match the official Hardkernel Debian release. Specifically, this means username: odroid and password: odroid will get you in.

Or you can use username: root, password: odroid.

If you log in as user, you can use command su to become root.

Version 6 Credentials

Previous to version 7, the credentials were user/password and root/root

Revision History

See here for a complete revision history of all images

The top of the tree for these Debian images is: Notice the arrangement by hardkernel board names? Make sure you download from the area that matches your board.

You should use the standard images that support hard-floating point if possible (armhf). They will be faster than the soft-float versions -- yes, even of you are not doing floating point. The additional registers may be used to pass parameters.

Some alternate images using soft floating point are also available (armel)

You can't easily mix soft-float compiled and hard-float compiled binaries on the same system. It is possible, but the general technique is not worked out yet (as far as I know). The standard hardkernel kernels all built to support hard floating point, and that is a necessary requirement.

Security Issues and Initialization

When you use an existing image, you pick up some keys that you should change for security reasons. Once you boot your system the first time do this: (as root)

rm /etc/ssh/*.pub /etc/ssh/*_key
#images starting at debian-wheezy-base-6.1 should have openssh-server installed
# re-generate the host ssh keys
dpkg-reconfigure openssh-server

It is best to set a unique persistent MACID. This script will do it:

echo $( ifconfig | grep HWaddr | awk '{ print $5 }' ) >/etc/smsc95xx_mac_addr

Adding Native Compiler and Tools

The base, xfce and gnome images do not include tools required to build the kernel or other compile other packages. Here are steps you can do to add that capability: (as root). We get some (but not all) recommended packages too. All recommended packages add over 1GiB to the flash footprint

apt-get install build-essential ncurses-dev
apt-get install gcc-4.6-locales debian-keyring libstdc++6-4.6-dbg autoconf automake1.9 libtool flex bison gdb libmudflap0-4.6-dev 
apt-get install libgcc1-dbg libgomp1-dbg libmudflap0-dbg binutils-gold ed p7zip-full

Adding an X Display Manager

X Display Manager for odroidu2

X Display Manager for odroidxu

Debian Tips

This page is for Debian Tips Debian Tips

Image Creation Details

You can completely re-create any of these Debian root filesystem images own your own. All the instructions are here: Custom_Debian_Root_Filesystem_Image.