view · edit · print · history

This page described how to install UpSlug2 on MacOS X. For basic information about UpSlug2, see its wiki page.

UpSlug2 and OSX

UpSlug2 works well with Mac OS X. The easiest way to install it on a Mac is using MacPorts, Fink(approve sites) or HomeBrew(approve sites); all of them will automatically handle all dependencies.

If you need the source or want to compile by yourself, the source can be find here https://github.com/carlesso/upslug2

Installing with MacPorts (version r41, latest from svn):

1.1 Download and install the MacPorts software.

1.2 Install UpSlug2 sudo port install upslug2

If you have an ObeseSlug the command to install UpSlug2 will be sudo port install upslug2 +flashmod16

Installing with Fink (version 0.11):

1.1 fink install upslug2

Installing with HomeBrew? (see page)

1.1 brew install https://raw.github.com/carlesso/upslug2/master/brew_formula/upslug2.rb(approve sites)

Using UpSlug2 to Flash your NSLU2

If your system MTU is not 1500, UpSlug2 may fail with the following error message: Message too long: transmit error N12NSLU2Upgrade9SendErrorE. Therefore, temporarily change your MTU size to 1500. I was using 1492. - Farhan Yousaf

The default factory assigned IP address of the NSLU2 is . Use the following steps if you have not changed the default address of your NSLU2. If your NSLU2 is currently on your network and accessable via its Web interface then skip step 3 below and go straight to step 4.

3.1 Connect your NSLU2 directly to your computer's ethernet port [be sure you have downloaded the flash file for reflashing]

3.1.1 If you have not already done so, Duplicate Network Port Configuration:
goto System Preferences > Network Port Configurations.
Select built in ethernet and hit "duplicate" and rename the configuration
Select the new configuration and click the "TCP/IP" tab
Select "Using DHCP with manual address,"
Enter the manual IP of the form
3.1.2 Discover NSLU2 Address:
Open Terminal and type arp -a
Find the address for the NSLU2 under

4.1 Put your NSLU2 into upgrade mode by restarting it with only the ethernet cable connected while holding a paperclip in the reset hole in the back of the NSLU2. When the ready/status light on the front turns red, remove the paperclip. The NSLU2 should now be blinking red.

4.2 Run upslug2 with a command line option to specify your ethernet device, sudo upslug2 -d en0 It should find your NLSU2 and tell you it is ready for upgrade and display its MAC address. If this doesn't find your Slug it means that either you have not put it in upgrade mode successfully, or the network connection between the PC and the Slug is not working.

4.3 Open a new Terminal window and type the following command:

sudo upslug2 -d en0 -t [the NSLU2 address] -i [the path to the flash file]
where -d en0 specifies that you wish to use the "en0" ethernet port, the default on Macintosh computers
-t [the NSLU2 address] specifies the MAC address of the NSLU2 you wish to upgrade
-i [the path to the flash file] specifies the flash image you wish to use.

So, for example, the command would be typed as:

sudo upslug2 -d en0 -t 00:0f:66:89:19:69 -i ~/Desktop/NSLU2_V23R63.bin

4.4 Let the command run and let the NSLU2 reboot

4.5 You can now access the NSLU2 via SSH e.g. ssh -v root@ You can find the default password here.

Page last modified on February 20, 2013, at 01:29 AM