Beagle Board -


Getting Started with BeagleBone

Beagle boards are tiny computers with all the capability of today’s desktop machines, without the bulk, expense, or noise. Read the step-by-step getting started tutorial below to begin developing with your BeagleBone or BeagleBone Black in minutes.

For additional getting started information, visit the suport wiki pages:

Original BeagleBone users: update to the latest software image to use the instructions below.

Plug in your Beagle via USB

Use the provided USB cable to plug your Beagle into your computer. This will both power the board and provide a development interface. BeagleBone Black will boot Linux from the on-board 2GB or 4GB eMMC. Either BeagleBone Black or original BeagleBone may also boot from a microSD card. Original BeagleBone is provided with a pre-configured 4GB microSD card.

BeagleBone or BeagleBone Black will operate as a flash drive providing you with a local copy of the documentation and drivers. Note that this interface may not be used to re-configure the microSD card with a new image, but may be used to update the boot parameters using the uEnv.txt file.

You'll see the PWR LED lit steadily. Within 10 seconds, you should see the other LEDs blinking in their default configurations.

  • USR0 is configured at boot to blink in a heartbeat pattern
  • USR1 is configured at boot to light during microSD card accesses
  • USR2 is configured at boot to light during CPU activity
  • USR3 is configured at boot to light during eMMC accesses

Install drivers

Install the drivers for your operating system to give you network-over-USB access to your Beagle. Additional drivers give you serial access to your board.

Operating System USB Drivers Comments
Windows (64-bit) 64-bit installer

If in doubt, try the 64-bit installer first.

  • Note #1: Windows Driver Certification warning may pop up two or three times. Click "Ignore", "Install" or "Run"
  • Note #2: To check if you're running 32 or 64-bit Windows see this:
  • Note #3: On systems without the latest service release, you may get an error (0xc000007b). In that case, please install the following and retry:
  • Note #4: You may need to reboot Windows.
  • Note #5: These drivers have been tested to work up to Windows 10
Windows (32-bit) 32-bit installer
Mac OS X Network
Install both sets of drivers.
Linux Driver installation isn't required, but you might find a few udev rules helpful.

Note: Additional FTDI USB to serial/JTAG information and drivers are available from

Note: Additional USB to virtual Ethernet information and drivers are available from and

Browse to your Beagle

Using either Chrome or Firefox (Internet Explorer will NOT work), browse to the web server running on your board. It will load a presentation showing you the capabilities of the board. Use the arrow keys on your keyboard to navigate the presentation.

  • Click here to launch:
    Older software images require you to EJECT the BEAGLE_BONE drive to start the network. With the latest software image, that step is no longer required.


Do not use Internet Explorer.

One option to browse your board is to use this node-webkit based application (currently limited to Windows machines):

Virtual machines are not recommended when using the direct USB connection. It is recommended you use only network connections to your board if you are using a virtual machine.

When using 'ssh' with the provided image, the username is 'root' and the password is blank.

Visit for additional debugging tips.

Update board with latest software

Step #1: Download the latest software image

Download the desired image from

Note: Due to sizing necessities, this download may take 30 minutes or more.

The file you download will have an .img.xz extention. This is a compressed sector-by-sector image of the SD card.

Step #2: Install compression utility

Download and install 7-zip.

Step #3: Decompress the image

Use 7-zip to decompress the SD card .img file

Step #4: Install SD card programming utility

Download and install Image Writer for Windows. Be sure to download the binary distribution.

Some general help on programming SD cards can be found on the Ubuntu Image Writer page.

Step #5: Connect SD card to your computer

Use the provided microSD card to SD adapter or a USB adapter to connect the SD card to your computer.

Step #6: Write the image to your SD card

Use either the Ubuntu Image Writer or instructions on its page to write the decompressed image to your SD card.

Note: You may see a warning about damaging your device. This is fine to accept as long as you are pointing to your SD card for writing.

Note: You should not have your BeagleBone connected to your computer at this time.

Step #7: Eject the SD card

Eject the newly programmed SD card.

Step #8: Boot your board off of the SD card

Insert SD card into your (powered-down) board, hold down the USER/BOOT button (if using Black) and apply power, either by the USB cable or 5V adapter.

If using an original BeagleBone, you are done.

If using BeagleBone Black and desire to write the image to your on-board eMMC, you'll need to follow the instructions at When the flashing is complete, all 4 USRx LEDs will be steady on or off. The latest Debian flasher images automatically power down the board upon completion. This can take up to 45 minutes. Power-down your board, remove the SD card and apply power again to be complete.

Other currently available software images

Some of the starting images below involve multiple steps to produce an SD card image or otherwise change some of the steps above, so be sure to read all the instructions on their pages. Choose the starting point you want, download or produce the SD card image and follow the steps above.

At the time of release, not all of these distributions support BeagleBone Black, but should soon.

Hardware documentation

The BeagleBoneBlack wiki page documents all of the known hardware issues, as well as the latest available software, hardware hardware documentation and design materials.

Time to read that manual and check out the design materials: BeagleBone, BeagleBone Black, BeagleBone Black, and BeagleBone Blue.

Other links to design materials for various releases can be found at


For a complete list of books on BeagleBone, see

Bad to the Bone

Perfect for high-school seniors or freshman univerisity level text, consider using "Bad to the Bone"

BeagleBone Cookbook

A lighter treatment suitable for a bit broader audience without the backgrounders on programming and electronics, consider "BeagleBone Cookbook"

Exploring BeagleBone and Embedded Linux Primer

To take things to the next level of detail, consider "Exploring BeagleBone" which can be considered the missing software manual and utilize "Embedded Linux Primer" as a companion textbook to provide a strong base on embedded Linux suitable for working with any hardware that will run Linux.

Last updated by on Mon Mar 27 2017 17:34:01 GMT-0000 (UTC).