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.
Warning: When the read-only filesystem is enabled, TinyPilot will lose any changes to the system on reboot. This includes:
To apply updates or change configuration on your TinyPilot, temporarily disable the read-only filesystem.
To set up the read-only filesystem, connect to your device over SSH and run the following commands:
sudo raspi-config nonint enable_overlayfs && \
The command may take a few moments to complete. Read-only mode slows down the boot process, so don't worry if your reboot takes 2-3x as long as normal.
To disable read-only mode, connect to your device over SSH and run the following commands:
sudo raspi-config nonint disable_overlayfs && \