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 Completed!" screen:

Reset your Voyager 3

Once Balena Etcher shows "Flash Completed!", safely eject the USB drive from your computer.

1. Power off your Voyager 3.
2. Insert the newly-flashed USB drive into the Utility USB port on the front of the Voyager 3.

3. Press and hold Button 2.

4. While continuing to hold Button 2, power on the Voyager 3.
5. Keep holding Button 2 for about 10 seconds, then release it.
6. After about 30 seconds, the Voyager 3's display should show a "Recovering" screen. This confirms that recovery has started.

7. Leave the Voyager 3 powered on and the USB drive connected while recovery is in progress. Recovery may take several minutes depending on the speed of your USB drive.
8. When recovery is complete, the Voyager 3 will reboot automatically.

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