# SSH to BeagleBone Black over USB ## Overview In this tutorial, you will learn how to control your BeagleBone Black using SSH with just the USB lead supplied. ![](https://cdn-learn.adafruit.com/assets/assets/000/008/839/medium800/beaglebone_overview.png?1396875404) The BeagleBone Black is being pitched as an American (Raspberry) Pi. It has a similar feature set, including video output. However, where as the Pi is intended as a general purpose Linux machine, the BBB (as we shall call it here) is much better equipped for connecting to external electronics, with many more GPIO pins, analog inputs and fast booting into Ångström Linux. This lesson closely follows the ‘Getting Started’ documentation on the BeagleBone web site. [http://beagleboard.org/Getting%20Started](http://beagleboard.org/Getting%20Started "Link: http://beagleboard.org/Getting%20Started") # SSH to BeagleBone Black over USB ## You Will Need To try this out, all you need is a BeagleBone Black and the USB lead that is supplied with it, in the box. [http://www.adafruit.com/products/1278](http://www.adafruit.com/products/1278 "Link: http://www.adafruit.com/products/1278") ![](https://cdn-learn.adafruit.com/assets/assets/000/008/844/medium800/beaglebone_BBB.jpg?1396875541) # SSH to BeagleBone Black over USB ## Preparation The BBB ships with a USB Lead. This fits into the Mini USB socket next to the RJ45 Ethernet connector. ![](https://cdn-learn.adafruit.com/assets/assets/000/008/843/medium800/beaglebone_bone_and_usb_web.jpg?1396875514) This lead can server the dual purpose of both supplying power to the BBB and allowing the BBB to emulate a USB modem. It is this trick that allows the BBB to be accessed as if it were networked, allowing you to communicate with it using a browser or SSH client on your computer. You can plug your board in now if you like. After a while, the blue LEDs should flicker and the LED nearest the edge of the board will flash in a ‘heart beat’ pattern. # SSH to BeagleBone Black over USB ## Installing Drivers (Windows) For the BBB to be able to do ad hoc networking with your computer, there is nothing to install on the BBB itself. Its all set up and ready to go. However, to be able to run this on a PC, you will need to install some drivers. On Windows 64 bit, install this: [http://beagleboard.org/static/Drivers/Windows/BONE\_D64.exe](http://beagleboard.org/static/Drivers/Windows/BONE_D64.exe "Link: http://beagleboard.org/static/Drivers/Windows/BONE\_D64.exe") Windows 32 bit, [http://beagleboard.org/static/Drivers/Windows/BONE\_DRV.exe](http://beagleboard.org/static/Drivers/Windows/BONE_DRV.exe "Link: http://beagleboard.org/static/Drivers/Windows/BONE\_DRV.exe") ![](https://cdn-learn.adafruit.com/assets/assets/000/008/846/medium800/beaglebone_windows_driver_install.png?1396875584) Windows will probably give lots of security warnings during installation. # SSH to BeagleBone Black over USB ## Installing Drivers (Mac) For the BBB to be able to do ad hoc networking with your computer, there is nothing to install on the BBB itself. Its all set up and ready to go. However, to be able to run this on a Mac, you will need to install some drivers. There are two things to install when using a Mac, the network driver which is here: [http://beagleboard.org/static/Drivers/MacOSX/RNDIS/HoRNDIS.pkg](http://beagleboard.org/static/Drivers/MacOSX/RNDIS/HoRNDIS.pkg) and the serial driver which is here: [http://beagleboard.org/static/Drivers/MacOSX/FTDI/FTDI\_Ser.dmg](http://beagleboard.org/static/Drivers/MacOSX/FTDI/FTDI_Ser.dmg "Link: http://beagleboard.org/static/Drivers/MacOSX/FTDI/FTDI\_Ser.dmg") Once the drivers are installed open Network from System Preferences and you should see your BBB showing up as a network connection. ![](https://cdn-learn.adafruit.com/assets/assets/000/008/849/medium800/beaglebone_network_prefs.png?1396875617) # SSH to BeagleBone Black over USB ## Installing Drivers (Linux) For the BBB to be able to do ad hoc networking with your computer, there is nothing to install on the BBB itself. Its all set up and ready to go. However, to be able to run this on a Linux computer, you will need to install the udev rules found here: [http://beagleboard.org/static/Drivers/Linux/FTDI/mkudevrule.sh](http://beagleboard.org/static/Drivers/Linux/FTDI/mkudevrule.sh "Link: http://beagleboard.org/static/Drivers/Linux/FTDI/mkudevrule.sh") This script will create a new file called 73-beaglebone.rules in /etc/udev/rules.d/You will probably need to run the script as superuser. # SSH to BeagleBone Black over USB ## Browsing Your BeagleBone Before we connect using SSH, lets just test that the connection is active by trying to connect to the BBB with a browser. The BBB will have an IP address, so using Chrome or Firefox (not Internet Explorer) connect to the URL [http://192.168.7.2](http://192.168.7.2 "Link: http://192.168.7.2") You should see a helpful introductory web page served by the BeagleBoard itself. ![](https://cdn-learn.adafruit.com/assets/assets/000/008/857/medium800/beaglebone_browser.png?1396875491) # SSH to BeagleBone Black over USB ## SSH with Windows and Putty Now that we can connect to the BeagleBone, let’s get a SSH session running. To do this, you will need to use a SSH client, which is no problem if you are a Linux or Max user as these are available from a Terminal window. If you are a Windows user, then you will need to download Putty from here: [http://www.putty.org/](http://www.putty.org/). Having downloaded and installed Putty (its a single file called putty.exe), run the program. ![](https://cdn-learn.adafruit.com/assets/assets/000/008/858/medium800/beaglebone_putty.png?1396875756) Enter the IP address 192.168.7.2 and click ‘Connect’. You will then get a security warning: ![](https://cdn-learn.adafruit.com/assets/assets/000/008/859/medium800/beaglebone_putty_cert_warning.png?1396875778) .. after which you will receive the login prompt. Log in with a username of ‘root’ and no password (just hit return). ![](https://cdn-learn.adafruit.com/assets/assets/000/008/860/medium800/beaglebone_putty_loggedin.png?1396875798) # SSH to BeagleBone Black over USB ## SSH on Mac and Linux If you are using a Mac or Linux, then open a terminal window and type the following command: ```auto ssh 192.168.7.2 -l root ``` ![](https://cdn-learn.adafruit.com/assets/assets/000/008/861/medium800/beaglebone_mac_ssh_loggedin.png?1396875832) The first time that you log in, you will receive an authenticity warning. Type yes, to continue with the SSH session. # SSH to BeagleBone Black over USB ## Next Steps Now that you have command-line access to your BBB, you can browse the file system, install software, monitor processes etc, just as you would with the command line on any Linux computer. **About the Author.** As well as contributing lots of tutorials about Raspberry Pi, Arduino and now BeagleBone Black, Simon Monk writes books about open source hardware. You will find his books for sale [here](http://www.adafruit.com/index.php?main_page=adasearch&q=simon+monk) at Adafruit. ## Featured Products ### BeagleBone Black - Rev B [BeagleBone Black - Rev B](https://www.adafruit.com/product/1278) **[Adafruit is no longer shipping the BeagleBone Black Rev B, it has been replaced with the Rev C as of 5/12/14](https://www.adafruit.com/products/1876) - the Rev C now has 4G flash and also comes with Debian, it also costs slightly more. There are no exchanges or...** No Longer Stocked [Buy Now](https://www.adafruit.com/product/1278) [Related Guides to the Product](https://learn.adafruit.com/products/1278/guides) ## Related Guides - [Adafruit WebIDE](https://learn.adafruit.com/webide.md) - [Character LCD with Raspberry Pi or BeagleBone Black](https://learn.adafruit.com/character-lcd-with-raspberry-pi-or-beaglebone-black.md) - [Bone Box](https://learn.adafruit.com/bone-box.md) - [Blinking an LED with BeagleBone Black](https://learn.adafruit.com/blinking-an-led-with-beaglebone-black.md) - [User-space SPI TFT Python Library - ILI9341](https://learn.adafruit.com/user-space-spi-tft-python-library-ili9341-2-8.md) - [Setting up WiFi with BeagleBone Black](https://learn.adafruit.com/setting-up-wifi-with-beaglebone-black.md) - [Introduction to the BeagleBone Black Device Tree](https://learn.adafruit.com/introduction-to-the-beaglebone-black-device-tree.md) - [BNO055 Absolute Orientation Sensor with Raspberry Pi & BeagleBone Black](https://learn.adafruit.com/bno055-absolute-orientation-sensor-with-raspberry-pi-and-beaglebone-black.md) - [Controlling a Servo with a BeagleBone Black](https://learn.adafruit.com/controlling-a-servo-with-a-beaglebone-black.md) - [Running Programs Automatically on Your Tiny Computer](https://learn.adafruit.com/running-programs-automatically-on-your-tiny-computer.md) - [Fading a RGB LED on BeagleBone Black](https://learn.adafruit.com/fading-a-rgb-led-on-beaglebone-black.md) - [LedGames - a BeagleBone Black 64x64 LED Game](https://learn.adafruit.com/ledgames-beaglebone-black-64x64-led-game.md) - [TMP006 Temperature Sensor Python Library](https://learn.adafruit.com/tmp006-temperature-sensor-python-library.md) - [Using the BMP085/180 with Raspberry Pi or Beaglebone Black](https://learn.adafruit.com/using-the-bmp085-with-raspberry-pi.md) - [MAX31855 Thermocouple Sensor Python Library](https://learn.adafruit.com/max31855-thermocouple-python-library.md)