nearxos 0844adbcbe Update cloud-init scripts and documentation for enhanced DNS management and provisioning steps</message>
<message>Modify the first-boot.sh script to include an additional step for managing screen brightness during the provisioning process. Update user-data.bootstrap to improve DNS configuration by ensuring NetworkManager manages /etc/resolv.conf correctly, and remove obsolete scripts related to systemd-resolved. Enhance documentation to reflect these changes and clarify the setup process for users, improving overall network boot functionality and user experience.
2026-03-06 14:45:23 +02:00

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

  1. New deployment: Follow emmc-provisioning/docs/DEPLOY-NEW-PROXMOX.md for step-by-step instructions (Proxmox host prep → LXC deploy → network boot → portal files).
  2. Sync first-boot assets to the file server after deploy:
    ./emmc-provisioning/scripts/sync-portal-files-to-lxc.sh root@<LXC-IP>
  3. Provision devices via USB boot or network boot; first-boot configures the Chromium kiosk, labwc Wayland desktop, screen rotation, wallpaper, dark theme, and CM4 boot order.
Description
Chromium auto-start configuration for reTerminal DM4
Readme 6.6 GiB
Languages
Python 53.2%
Shell 20.4%
HTML 14.8%
JavaScript 6.4%
CSS 5%
Other 0.2%