How do I factory reset my TinyPilot device?

Select your device:

• Voyager 3
• Voyager 2a

Overview

If things go haywire with your TinyPilot device, you can factory reset it back to the original settings by performing a re-flash.

Voyager 3

Requirements

For these instructions, you'll need:

• A USB drive (at least 8 GB)
• Balena Etcher, a free, open-source tool for writing disk images

Download the TinyPilot Voyager 3 recovery image

Download the TinyPilot Voyager 3 recovery image from our download page.

Flash the image

1. Insert a USB drive into your computer.
2. Open Balena Etcher.
3. Click "Flash from File."

4. Select the Voyager 3 recovery .img     file you downloaded previously. 

5. Click "Select target." 

6. Check the box next to your USB drive and hit "Select." 

7. Finally, click the "Flash" button. 

When the flash is complete, you'll see this screen "Flash Complete!" screen:

Insert your newly-flashed USB drive into your TinyPilot Voyager 3's "Utility" USB port on the front of the device. Press and hold down Button 2, power on your device, and wait around 10 seconds. Your device will boot and perform a recovery, this may take a few minutes depending on your USB drive's transfer speed.

Voyager 2a

Requirements

For these instructions, you'll need:

• A microSD writer

  • There are many different brands, but Anker's model is reliable

    A microSD card (at least 8 GB)

  • Can be the same microSD that shipped with your TinyPilot as long as there's no physical damage

    Balena Etcher, a free, open-source tool for writing microSD images

Download the TinyPilot microSD image

First, download the TinyPilot microSD image from our download page.

Flash the image

1. Insert a microSD card into your microSD writer.
2. Insert the microSD writer into your computer.
3. Open Balena Etcher.
4. Click "Flash from File." 

5. Select the TinyPilot Pro .img            file you downloaded previously. 

6. Click "Select target." 

7. Check the box next to your microSD card drive and hit "Select." 

8. Finally, click the "Flash" button. 

When the flash is complete, you'll see this screen "Flash Complete!" screen:

Insert your newly-flashed microSD into your TinyPilot device, and then power it on. The first boot will take 3-5 minutes to complete.

(Optional) Purge old SSH records

If you used SSH to access your TinyPilot device before resetting it, you may see the following error when you connect in the future:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.

Your computer remembers the devices you connect to and will warn you if their properties change. Factory resetting your TinyPilot device causes it to generate a new SSH configuration, so the error message is alerting you of this change.

You can fix the error above by purging the information your computer saved about your TinyPilot device prior to the reset. To do this, run the following commands:

ssh-keygen -R tinypilot
ssh-keygen -R tinypilot.local
ssh-keygen -R tinypilot.localdomain