Skip to content

Creating a League SD Image

Many times teams will not have the time to build their own image during the time allocated for an event. It typically takes 2-4 hours to create a DonkeyCar image that is ready to drive. To get around this problem, leagues frequently create their own "reference image" that are given to teams.

Checklist for the League Image

  1. Bookmark bar in the browser is visible (check Show Bookmarks Bar)
  2. Bookmark bar is populated with:
  3. You League Homepage (use GitHub Pages and mkdocs for best pratices)
  4. Links to Team pages with sample files for each team's car
  5. Link to the AI Racing League site (
  6. Links to the DonkeyCar site
  7. Links to the Raspberry Pi or NVIDIA Nano site
  8. All operating system files updates before match
  9. Auto-update disabled - you don't what gigabyte uploads when people insert their image
  10. All Python libraries Updates
  11. Verify Python release such as Python 3.7 using python --version
  12. Run "pip freeze" to get a list of the libraries you have tested on
  13. All DonkeyCar libraries updated
  14. In the "donkeycar" repo run a "git pull" to update the latest code
  15. Make sure you ONLY change the - changes to will be lost

## Things to Remove from your Image

  1. Personal information (from your github file in .gitinfo)
  2. Change Hostname to be Generic (arl)
  3. Remove your home or school default wifi settings

Burning an League Reference Image

  1. Take the image out of your car
  2. Take it to a Mac/PC and copy the image to your harddrive using the dd Command
  3. Insert a black MicroSD card
  4. Copy the image on your PC's Harddrive to the new MicroSD Using DD or a GUI tool like belana Etcher

Using the GNome Partition Editor (gpartd)


  1. DonkeyCar Release Process