ALPINE-CONFIG(5)

# NAME

alpine-config - Alpine-specific tiny-cloud user-data format

# DESCRIPTION

*alpine-config* extends the tiny-cloud-supported *cloud-config*(5) subset with
Alpine-specific package repository and autoinstall features.

The user-data document must begin with the header:

	#alpine-config

All keys documented in *cloud-config*(5) are also supported in
*alpine-config*.

# ALPINE EXTENSIONS

*apk.cache*
	Set the APK cache directory. tiny-cloud creates the directory and points
	_/etc/apk/cache_ at it.

*apk.repositories*
	Define repository entries to write to _/etc/apk/repositories_. Supported
	fields are *base_url*, *repos*, and *version*.

	If *version* is omitted, tiny-cloud derives it from the running Alpine
	version when possible. When *apk* is absent and no repository file exists,
	tiny-cloud falls back to *setup-apkrepos -1 -c*.

*autoinstall*
	Control unattended Alpine installation.

	If set to *true*, tiny-cloud selects the largest empty disk automatically and
	reboots after installation.

	When expressed as a mapping, supported keys are:

	*disk*
		Target disk path, or *auto*.

	*reboot*
		Whether to reboot after installation. Defaults to *true*.

	*swapsize*
		Swap size in megabytes or gigabytes using *M* or *G* suffixes.

	*lvm*
		When set to *true*, request LVM mode for *setup-disk*.

# NOTES

Because *alpine-config* includes the *cloud-config*(5) subset, you should use
*cloud-config*(5) for shared keys such as *users*, *write_files*, *packages*,
and *runcmd*, and this page for Alpine-specific additions.

# EXAMPLES

A more complete example:

```
#alpine-config
user:
  name: alpine
ssh_authorized_keys:
  - ssh-ed25519 AAAA... user@example.com
apk:
  cache: /var/cache/apk
  repositories:
    - base_url: https://dl-cdn.alpinelinux.org/alpine
      version: edge
      repos: [ "main", "community" ]
package_update: true
packages:
  - curl
  - jq
autoinstall:
  disk: auto
  reboot: false
```

This example combines shared *cloud-config*(5) keys with Alpine-specific APK
repository configuration and unattended installation settings.

# SEE ALSO

*cloud-config*(5), *tiny-cloud*(8)