view · edit · print · history

Puppy End User install instructions.


  1. That you've just purchased a Linksys NSLU2 and want to run puppy on it to connect to your Toppy.
  2. That you havn't done anything else to the NSLU2 apart from maybe turn it on and used it as Linksys expected ;)
  3. You have a USB disk that you can format and not have to worry about the contents of (it doesn't have to be that big, but it must be larger than 1GB). You can also use a 256MB or larger flash key (you must plug it into the Disk1 USB port on the back of the NSLU2 if you are using a flash key as the unslung disk).
  4. That you're not that familiar with Linux but have some general computer proficiency.


  1. Some form of a net connection.
  2. "unslung 5.5beta" firmware package".

Pre install.

  • Get the unslung 5.5-beta firmware from sourceforge.
  • Ensure you have read the readme that comes with the unslung firmware and ensure you have tested your ability to TelnetIntoRedBoot, this is crucial should a mistake be made and you make the NSLU2 temporarily unbootable as I did. Once you can get to a RedBoot prompt you can type upgrade and then using the SerComm Upgrade Utility you can take your firmware back to the linksys original or re flash with an uNSLUng package. Ensure at the very least you are familiar with this process
  • Get the NSLU2 on the local network. It is generally better to attach it to a home network that has a net connection as it will be much easier to download and install the packages later.
However it is still possible to do it without a direct net connection. I was using a crossover cable to install puppy.
Below are the extra tasks I had to do to use a cross over cable instead of a real network connection.
  • Use the Linksys CD setup utility to set the IP address of the NSLU2.
  • Set the NSLU2 IP address to IP, subnet, gateway
  • Set my PC IP address to IP:, subnet :, gateway :
  • Connect to the web interface of the slug. The default address assuming you set it to is
    • Make sure that your DNS server is set in the web interface.
    • Connect a USB 2.0 disk to the slug.
    • Format the disk under the admin tools/disk page.
    • Test that you can sucessfully use the disk. Copy a file over the network to it.
    • This ensures that we have a known good disk before installing unslung packages on it.

New firmware install.

  1. Shutdown the slug.
  2. Remove any disks (including flash keys) connected to the slug.
  3. Power on the slug and wait for the beep.
  4. Upload the new unslung 5.5beta firmware via the web interface install page. The update process can take a few minutes so be patient!

(if you get a message that you don't have enough memory and you are running Windows you can use the SerComm Upgrade Utility

  1. The slug will reboot at the end of the upgrade.
  2. Enable telnet access via the telnet.cgi script.
  3. Telnet to the slug. From a Windows machine you can type "telnet"
  4. At the username prompt type "root" and at the password prompt type "uNSLUng".
  5. Plug the disk back into the slug.
  6. Wait for a minute or so while the slug recognises it.
  7. Check and see if your disk is formated via the web interface. If not format it :)
  8. Run /sbin/unsling disk1 in the telnet session which you have kept open.
  9. When the process is finished, you should reboot the slug.
  10. This time around you should have your USB disk connected during the boot process.
  11. After a reboot, you will need to re-enable telnet access again using
  12. Telnet back into the slug. From a Windows machine you can type "telnet"

You're now running an unslung on your nslu2. Now onto getting some extra software (and most importantly puppy) installed.

Updating and install extra software packages.

Now there are two ways to install packages onto the newly unslung nslu2.

NSLU2 that is directly connected to the net.

1. Direct from the net if your nslu2 has access to the internet.

Simply Type :

 ipkg update

This will update the list of available packages and the following commands will download and install them from the net.

 ipkg install openssl
 ipkg install openssh
This package will start the SSH (secure shell) daemon when the NSLU2 starts each time. You can get a free SSH client here
 ipkg install puppy

The package below is optional:

 ipkg install bash 

If you've tried the above and get an error its normally because your NSLU2 can't grab the packages direct from the net. This situation will occur if you only have proxy access to the net. Don't fret however as you can manually download the packages and install sucessfully. You might like to check if you have the gateway set on the NSLU2, this is often the cause of not being able to get the NSLU2 connected to the internet.

The manual install involving downloading to another machine and copying over the files. These instructions are found on the ManualPuppyInstall page.

That's it now you are finished!

Connecting to the slug

Once you have installed the above packages, you should reboot your slug with the USB disk attached and powered on. Since we have installed the openssh package, you no longer need to enable telnet. Instead, you can use your SSH client to connect to the slug and login as root with the default password uNSLUng (you can always follow generic unslung instructions for changing passwords, if you wish)

Now you can run your puppy commands... AFTER you've connected your Topfield to the NSLU2.

Basic puppy usage.

See PuppyUsage for some examples of how to use puppy.

Using puppy is from the command line. There are several different parameters you can pass to it. Type puppy and press "Enter" and it will show you all the options that it can take.

In general you'll be interested in using the "-c" flag which sends commands to the Topfield TF5000PVRt.

A simple test would be to type puppy -c dir to list the contents of the Topfield disk.

The other commands are : "size, dir, get, put, rename, delete, reboot, cancel".

You will need to have a big disk connected to the NSLU2 if you want to transfer files.

view · edit · print · history · Last edited by John.
Based on work by odvdveer, tman, Koops, camthecameraman, Olga D van de Veer, peteru, and rwhitby.
Originally by Koops.
Page last modified on December 05, 2005, at 11:48 PM