The Fast Way
Contents
What you will need
A computer (the “base station”) with an internet connection
A working Duckietown Shell (
dts) installation: Install the Duckietown ShellA microSD card (
64 GB, U3, Class 10 recommended), e.g., the one from the Duckiedrone boxA microSD card reader, e.g., the one from the Duckiedrone box
What you will get
An initialized Duckiedrone microSD card, ready for first boot
The Fast Way#
This procedure consists of downloading a preset image and burning it to the microSD card using Balena Etcher. The advantages of going the “fast” way are that:
Balena Etcher runs on any operating system; only the step that sets the
duckieaccount password requiresdtsmost important configuration parameters are pre-set; set the
duckieaccount password before the first boot
The disadvantages of this procedure are:
the Duckiedrone has default parameters, listed in the “cheatsheet” below. The
robotnamecan be changed only on Ubuntu before the first boot.Since every robot on the network needs a unique
robotname, do not use this procedure for several Duckiedrones on the same network at the same time.
Cheatsheet
Default robot name: amelia02
Default ssh user name: duckie
ssh account password: set in step 4; there is no default account password
Default network configuration (robot will connect to this network after the first boot)
SSID:
duckietownPassword:
quackquack
1. Install Balena Etcher#
Balena Etcher is a program to flash disk images to drives.
Download and install the version appropriate for the base station operating system from Balena Etcher’s website.
2. Download the Duckietown image#
Legalities
Downloading this image means accepting the Duckietown Software License, Terms and Conditions and Privacy Policy, as well as robot configuration-specific licenses due to the presence of third-party software on the microSD card.
Download the latest Duckiedrone ente image to the base station:
3. Flash the image to the microSD card#
Connect the microSD card to the base station. Use the microSD-to-USB card reader if the base station does not have a microSD slot.
Open Balena Etcher and select the downloaded Duckiedrone image, then select the microSD card as the drive to flash. Finally, click the Flash button.
Warning
Double-check that the “drive” is the microSD card.
Balena Etcher may ask for the base station password to proceed. This is normal: flashing a microSD card deletes everything that is on it, so Etcher asks for confirmation before erasing its contents.
Note
Flashing will take 15-20 min.
4. Set the duckie account password#
Before the first boot, use dts sd_card update to set the password for the duckie account:
dts sd_card update --type duckiedrone --configuration DD24 --password
DTS prompts for the password and for its confirmation. It must contain at least eight characters and cannot contain colons or line breaks. The characters typed are not displayed. The password update takes effect when the Duckiedrone next boots. There is no default account password.
5. (Ubuntu only) Customize the country, Wi-Fi and hostname#
Attention
This option works only prior to the first boot.
On Ubuntu, the microSD card will mount three partitions after flashing:
bootfs: this partition contains important system files. Do not touch it.rootfs: this partition contains important system files. Do not touch it at this stage.configfs: this partition contains configuration files that can be edited to customize important features of the Duckiedrone.
The configfs partition includes:
hostname.txt: this is therobotname, which defaults toamelia. There are constraints on the naming.country.txt: contains the two-letter country ISO 3166-1 alpha-2 code. The default isUS; change it to the country where the Duckiedrone will fly if needed.wififolder: contains several files that allow for Wi-Fi network customization. Edit00-user.yamlto add a custom Wi-Fi network. Networks can also be edited at any time after the first boot. For more information, see Network management.
Fig. 48 Image configuration partition accessible through Ubuntu.#
6. Proceed to the first boot#
Safely eject the microSD card from the base station, then insert it into the Raspberry Pi’s microSD card slot.
The Duckiedrone is now ready for the first boot.
Note
Through this approach, the Duckiedrone will boot and search for the default network. It is recommended to set up a duckietown:quackquack network before the first boot, or to connect the Duckiedrone to the router with an Ethernet cable. Once the first boot is complete, networks can be added or removed by following Network management.
Troubleshooting#
Troubleshooting
SYMPTOM
On macOS, the flashing step fails for lack of permissions.
RESOLUTION
Go to Apple menu > System Settings > Privacy & Security > Files & Folders, then enable Balena Etcher’s access to Removable Volumes.

Troubleshooting
SYMPTOM
The Duckiedrone does not join the Wi-Fi network after the first boot.
RESOLUTION
Re-insert the microSD card into the base station and open the
configfspartition.Check
country.txt. Wi-Fi is disabled when the regulatory domain is unset, so it must contain the correct two-letter country code.Inspect
wifi/00-user.yaml. Confirm that the network name and password are correct and that its YAML indentation uses spaces, not tabs.If
configfscannot be accessed from Ubuntu or the problem persists, use The complete way to flash the card with the network credentials.