Feature: _autoinstall
Description
Enables automatic, non-interactive installation of Garden Linux to disk on first boot.
What it does
_autoinstall adds a systemd service (gl-autoinstall.service) that triggers on first boot and installs Garden Linux to disk without user input. The service invokes the wrapper script gl-autoinstall, which auto-detects the first suitable block device (or reads the target from the gl.install.target kernel parameter) and delegates to the _install feature's /opt/install/install.sh. The system reboots into the installed image once installation completes.
The service runs only when /opt/install/install.sh is present and skips silently if the /.installed marker already exists, preventing accidental re-installation on subsequent boots.
Combine _autoinstall with _iso or _pxe to produce a bootable image that installs itself to disk on first boot.
Files
Files present in this feature and their purpose. See the feature file reference for the semantics of each file type.
| File | Purpose |
|---|---|
exec.config (ref) | Configures the image at build time to enable the autoinstall service. |
info.yaml (ref) | Declares type: flag and included/excluded features. |
requirements.mod | Declares kernel module requirements for the autoinstall environment. |
file.include/etc/systemd/system/gl-autoinstall.service (file.include) | Systemd unit that runs gl-autoinstall on first boot to trigger unattended disk installation. |
file.include/usr/local/sbin/gl-autoinstall (file.include) | Wrapper script that detects the target block device, calls install.sh, and reboots the system. |
Related features
Includes:
_install— Provides the core installation script (install.sh) that_autoinstalldelegates to.