Skip to content

Fix/pi fast boot - #98

Merged
Tanchouteur merged 4 commits into
mainfrom
fix/pi-fast-boot
Aug 24, 2026
Merged

Fix/pi fast boot#98
Tanchouteur merged 4 commits into
mainfrom
fix/pi-fast-boot

Conversation

@Tanchouteur

Copy link
Copy Markdown
Owner

This pull request implements significant improvements to the fast boot optimization process and the application startup sequence, with a focus on making systemd integration more robust and startup health reporting more precise. The changes also enhance documentation and clarify best practices for Raspberry Pi 5 boot optimization. The most important changes are grouped below:

Fast Boot Optimization and Systemd Integration:

  • Refactored the fast boot step in install.sh to present each optimization (background services, kiosk mode without LightDM, and cloud-init disabling) as separate, reversible options, with explicit tracking of which optimizations were applied or skipped. Added helper functions to safely disable systemd units only if present, and improved user messaging for each step. Summary of applied/skipped optimizations is shown at the end, along with restoration instructions. [1][2][3][4][5]
  • Updated clios.service systemd unit to use Type=notify, enabling reliable notification to systemd when the application is fully ready. Increased startup timeout and set NotifyAccess=all.

Application Startup Health and Notification:

  • Added precise startup phase reporting and health marker writing in main.py, including atomic file writes, elapsed time measurement, and phase logging. Integrated systemd READY=1 notification using a custom socket implementation, ensuring systemd only marks the service as ready after the first QML frame is displayed. [1][2][3][4][5][6][7][8]

Frontend Service Initialization:

  • Deferred initialization of non-critical background tasks (network, system state, updater checks) in qt_bridge.py until after the first QML frame, to ensure the fastest possible visible startup and accurate health reporting. [1][2]

Documentation and Best Practices:

  • Updated the Raspberry Pi 5 boot optimization guide to reflect the new fast boot process, clarify which services are affected, and discourage unvalidated overclocking. Added clear instructions for reversible changes and precise startup time measurement. [1][2][3][4][5]

Testing:

  • Updated the test launcher to import the new startup phase tracking logic.

@TanchouteurTanchouteur self-assigned this Aug 24, 2026
CopilotAI lite review requested due to automatic review settings August 24, 2026 12:30
@TanchouteurTanchouteur added documentation Improvements or additions to documentation enhancement New feature or request labels Aug 24, 2026

CopilotAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@Tanchouteur
Tanchouteur merged commit f6b9383 into mainAug 24, 2026
7 checks passed
@Tanchouteur
Tanchouteur deleted the fix/pi-fast-boot branch August 24, 2026 12:42
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationenhancementNew feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@Tanchouteur