Setup - Software#

This chapter describes how to install software needed to work with Duckietown.

What you will need

What you will get

A computer set up to use Duckietown and interact with Duckiebots.

Attention

Every time you read DUCKIEBOT_NAME or ROBOT_NAME, replace it with your Duckiebot’s HOSTNAME, (omitting .local at the end).

Note

Key indicates a keyboard key.

Native Ubuntu installation and Virtual Machines (VM)#

Running Ubuntu natively is strongly recommended but not strictly required.

If you are running Ubuntu in a VM (Virtual Machine), make sure that your computer and Duckiebot appear as physical entities on the same network. This is achieved by selecting the “bridged network adapter” (e.g., VirtualBox uses NAT by default), which will allow you to be on the same subnetwork as your Duckiebot.

Note

When running a VMware machine on a macOS host, it may be necessary to have the following network adapters:

  • Share with my Mac (for connecting to the Internet).

  • Bridged Networking (for connecting to your Duckiebot).

If using a M-series Mac (ARM architecture), some success has been achieved by emulating a x86 architecture using UTM.

Attention

While VMs on different host OS might work:

  1. We strongly reccomend using a native (or, dual boot) Ubuntu installation, especially if it is your first run with Duckietown

  2. Only native Ubuntu setups are officially supported by the Duckietown team (community resources are still available for other setups).

In this Section#