Home

Jump to bottom

Tetsuya1126 edited this page Dec 3, 2025 · 4 revisions

Welcome to the raspi_overlay-auto-update wiki!

OverlayFS Safe Auto Update

This project provides a safe, fault-tolerant update mechanism for Raspberry Pi / Debian systems using OverlayFS and systemd.

Key Features

Atomic 2-stage update flow
Overlay write protection
Scheduled auto updates (systemd timer)
Cooldown protection
LED and watchdog status monitoring
Dry-run simulation mode

Quick Install

git clone https://github.com/Tetsuya1126/raspi_overlay-auto-update.git

cd raspi_overlay-auto-update

sudo bash install.sh

Dry-run

sudo overlay-auto-update.sh --dry-run

##　How It Works (Overview) Boot with OverlayFS enabled (read-only protection)

Systemd timer triggers update job

Overlay is temporarily disabled
System updates using apt
System reboots
Overlay is re-enabled
System returns to protected mode

Tested Environment

Raspberry Pi OS / Raspbian GNU/Linux 13 (trixie)
Debian 13 compatible

Documentation Index

Maintenance Notes