How do I enable the read-only filesystem?

Overview

Read-only mode is an OS setting on the TinyPilot that can increase the lifetime of your microSD card and reduce the risk of filesystem corruption from unplanned shutdowns.

As the name implies, the read-only filesystem loads the TinyPilot's file system in read-only mode so that writes to the disk stay in memory and don't affect the physical microSD card.

Enabling the read-only filesystem

Connect to your device over SSH, and then do the following:

1. sudo raspi-config
2. Choose 4 - Performance Options
3. Choose P3 - Overlay File System
4. When prompted, "Would you like the overlay file system to be enabled?" choose "Yes"
5. When prompted "Would you like the boot partition to be write-protected?" choose "No"
6. Choose "Finish"
7. When prompted "Would you like to reboot now?" choose "Yes"

Read-only mode slows down the boot process, so don't worry if your reboot takes 2-3x as long as normal.

Disabling the read-only filesystem

To apply updates or make permanent changes to your TinyPilot, you'll need to temporarily disable the read-only filesystem.

To disable read-only mode, follow the same steps as above, but when prompted, "Would you like the overlay file system to be enabled?" choose "No".