BeagleBone AI-64 Setup Guide
The BeagleBone AI-64 from BeagleBoard.org is an open-source single-board computer with a Debian GNU/Linux operating system based on the Texas Instruments TDA4VM processor.
Follow this guide to set up your BeagleBone AI-64 and prepare it for viam-server
installation.

Hardware Requirements
You need the following hardware, tools, and software to install viam-server
on a BeagleBone AI-64:
- A BeagleBone AI-64
- A 5V barrel jack (recommended) and/or USB-C power supply, to power the BeagleBone
- Ethernet cable and/or WiFi dongle, to establish network connection on the BeagleBone
- (Optional) A microSD card and a way to connect the microSD card to the computer (like a microSD slot or microSD reader)
- This is required if you need to set up your BeagleBone for the first time or update your BeagleBone to the latest software image.
The following instructions mirror the instructions given in the BeagleBoard documentation at Connecting up your BeagleBone and Getting Started with your BeagleBone.
If you want additional help setting up your BeagleBone, you can follow the guides there and return to the Viam docs after SSH’ing into your BeagleBone.
Step 1: Power your BeagleBone
Power your board by plugging a 5VDC power source into the BeagleBone’s barrel jack. You can also power the BeagleBone with a USB-C cable, but a 5VDC power source is recommended for more reliable performance.
If the board has power, the LED on the board labeled PWR or ON is lit steadily.
Step 2: Enable a network connection
You need to enable a network connection on your BeagleBone to install viam-server
on it.
You can do this in multiple ways:
- Connect an ethernet cable to your BeagleBone’s ethernet port.
- If you are working on a macOS machine, use internet sharing over USB to share your connection.
After enabling the option on your machine, SSH into your BeagleBone and run
sudo dhclient usb1
. - If you are working on a Linux machine, read these tips on enabling a network connection.
- If your personal computer supports mDNS (Multicast DNS), you can check to see if your BeagleBone board has established a network connection by visiting beaglebone.local.
Step 3: SSH into your BeagleBone from your PC
You can SSH into your BeagleBone by running the following command in your terminal:
ssh <your-username>@<your-hostname>.local
By default, the hostname, username and password on a BeagleBone are:
- Hostname:
beaglebone
- Username:
debian
- Password:
temppwd
Therefore, if you are using the default settings on your BeagleBone, the command is:
ssh debian@beaglebone.local
Step 4: Update your BeagleBone
After SSH’ing into your BeagleBone, verify all packages are up to date:
sudo apt update && sudo apt dist-upgrade && sudo reboot
Step 5: Install viam-server
Now that your BeagleBone has a Viam-compatible operating system installed, continue to our viam-server installation guide to install viam-server
on the board.
Troubleshooting
If you experience any issues getting Viam working on your BeagleBone, consult the BeagleBone documentation for help updating your BeagleBone.
You can also ask questions in the Community Discord and we will be happy to help.
You can find additional assistance in the Troubleshooting section.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better:
Thank you!