c5e418eabc
<message>Add a new step-by-step guide for deploying the CM4 eMMC provisioning service on a new Proxmox instance, enhancing clarity for users. Update existing documentation to reflect changes in network configuration options, including the introduction of LAN subnet settings for DHCP and TFTP. Modify cloud-init scripts to ensure proper management of DNS settings and improve the handling of network interfaces. Additionally, enhance the toggle script for network boot to dynamically read the LAN gateway from configuration files, streamlining the setup process and improving user experience.
reTerminal DM4
Project for reTerminal DM4 (Seeed) with CM4: Chromium kiosk, eMMC provisioning (USB + network boot), and first-boot configuration via cloud-init.
Revisions
A single revision number is kept in REVISION and in a comment line in tracked files (# Revision: N or <!-- Revision: N -->) so you can see what changed across hosts and deploys.
- Bump revision (update all files): from repo root run
./emmc-provisioning/scripts/bump-revision.sh - Auto-bump on every commit: install the pre-commit hook
cp emmc-provisioning/scripts/pre-commit-revision.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
Then every commit will bump the revision and update the revision line in all tracked files.
Repository structure
| Path | Purpose |
|---|---|
| emmc-provisioning/ | Main workflow: eMMC deploy/backup, cloud-init first-boot, Chromium kiosk assets, file server, dashboard, network boot. See emmc-provisioning/README.md. |
| archive/ | Legacy or unused files (guides, old scripts). Not used for deployment. See archive/README.md. |
Quick start
- Read emmc-provisioning/docs/EMMC-PROVISIONING-GUIDE.md for full setup.
- Use emmc-provisioning/scripts/sync-portal-files-to-lxc.sh to sync first-boot assets (including kiosk) to the file server.
- Provision devices via USB boot or network boot; first-boot configures kiosk, labwc, rotation, wallpaper, dark theme, and optional CM4 boot order.