The following tutorial shows my first step setting up my GuruPlug Server Plus. In these few steps, I will start my GuruPlug the first time, install required software and do some configuration for the network. I assume that a JTAG-board is available as well.

Since I have a GuruPlug, I will be talking about the GuruPlug in the following tutorial but everything should also work on a Sheevaplug or on any other Plugcomputer.



Before you start, make sure the computer which is used for configuration meets the following requirements:

  • minicom is installed (how to install minicom)
  • SSH is installed (how to install SSH)
  • vim
  • the FTDI device driver for communication with the JTAG-board are installed
    • On many operating systems, the driver is installed by default. Otherwise, check the FTDI-Chip website for drivers
  • A netork connection (you could also do it over wireless, but I am using the wired network in this tutorial)


Hardware setup

Connect the JTAG-board to your computer which you will use for configuration and make sure it is recognized as USB-device. Now you should be able to start minicom as described here: Connecting with minicom. If minicom works, connect your GuruPlug to your Homenetwork and connect the power. The GuruPlug will start up and minicom should show the boot process by displaying some boot messages.


If your GuruPlug is booting and the boot messages show up, you are almost ready to play ;) Just let it run until it asks you for the username and password. The initial username of the GuruPlug Server Plus was "root" and the password "nosoup4u". I guess that's the same for all Sheeva-/Guru-Plugs.


Initial configuration

The most important things are that the network is configured right and that SSH is installed on the GuruPlug. As far as I remember, SSH was not installed on my GuruPlug, but even though it is already installed on yours (which actually would make sense, otherwise you could not use the GuruPlug without the JTAG-board), it will not break anything if you follow the installation steps.

Hint: After resetting my GuruPlug, SSH is installed so I guess it is also installed on a new GuruPlug.


Installing SSH

If SSH is not installed: Installing SSH is quite easy since it is withing the repository. Connect with minicom and type

# apt-get install ssh

And it will download SSH and install it (if it asks if you really want to install it, just type "y"). Now you are ready to connect to your GuruPlug over SSH (maybe a restart is required).


Configuration of the network interfaces

The reason that I configured the network interface (initially, it will get an IP-address assigned by your routers DHCP) is that I want a fixed IP-address which definitely does not change. The DHCP-address will usually stay the same once assigned, but if there is another computer with the same address, it might change. So here are the network settings of my GuruPlug Server Plus (with two network interfaces). I only configured the two wired networks since wireless is disable (I don't need it at the moment, take a look at this article for more information).


Open the file /etc/network/interfaces on your GuruPlug, for example with the terminal text-editor vim.

vim /etc/network/interfaces

It will show you the initial interfaces file with looks probably like this:

# Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or

# /usr/share/doc/ifupdown/examples for more information.
auto lo
iface lo inet loopback

Now add the network configuration. To get into the edit-mode of vim type "a" which will be confirmed by showing the message "-- INSERT --" at the bottom of the terminal. Finally, the file will look like this:

# Used by ifup(8) and ifdown(8). See the interfaces(5) manpage or
# /usr/share/doc/ifupdown/examples for more information.
auto lo
iface lo inet loopback

auto eth0
iface eth0 inet static

auto eth1
iface eth1 inet static

To save and close the file, hit "ESC" which will bring you into the command mode of vim. Type ":w" to save the file and then ":q" to exit vim.


Hint: If you don't want to disable wireless but your router is your gateway at, you also have to add the wireless (uap0) configuration to the interfaces configuration (or change the ifconfig-line in the file


One more step is required to make your new settings the default ones whenever the GuruPlug starts up. The GuruPlug is set to start a DHCP-client which will mess with your configuration. Type

update-rc.d -f ifplugd remove

to solve the problem. If you need a DHCP-client later, you can start it again but that's not the topic of this tutorial...

Now restart your GuruPlug (simply by unplugging and plugging it in again, or type # reboot into the terminal). After the GuruPlug has started up, connect with SSH again and run the command


which shows you all your network interfaces and their configuration, and

route -n

to see the routing table with the default gateway.


Hint: the IP-addresses which I used are not within the range of my routers DHCP. This is neccessary that the router does not assign the IP-address to another computer. Most likely, you can get your routers DHCP range through your router configuration (type your routers IP into your web browser and it should show the login for the router config)


Now, your GuruPlug is ready and as long as you don't mess up the network interfaces, you can connect with SSH. From now on, you will only need the JTAG-board for special purposes.