TINY-CLOUD.CONF(5)

# NAME

tiny-cloud.conf - configuration for tiny-cloud

# DESCRIPTION

*tiny-cloud.conf* configures *tiny-cloud*(8). The file is sourced by the
tiny-cloud shell code during startup and therefore uses shell-style variable
assignments.

The default system configuration file is _/etc/tiny-cloud.conf_.

# FORMAT

The file consists of shell variable assignments of the form:

	NAME=value

Blank lines and shell comments are ignored.

# VARIABLES

*CLOUD*=<provider>
	Select the cloud provider. The default is *auto*, which enables provider
	autodetection.

	Supported values currently include *aws*, *azure*, *gcp*, *hetzner*,
	*incus*, *nocloud*, *oci*, and *scaleway*.

*CLOUD_USER*=<user>
	Default user account for instance SSH keys and default-user setup. The default
	is *alpine*.

*IMDS_API_VERSION*=<version>
	Provider's API version to use. Providers that have versioned APIs have
	built-in default values.

*IMDS_ENDPOINT*=<ip_address[:port]>
	Provider endpoint IP address to use. Defaults to 169.254.169.254 for many
	providers.

*IMDS_ENDPOINTS*=<endpoint> ...
	Whitespace-separated provider endpoint list. Defaults to *IMDS_ENDPOINT*.
	Endpoints are tried in order, with the most recently working endpoint tried
	first on later queries. IPv6 endpoints must use brackets, for example
	*[fd00:ec2::254]* or *[fd00:ec2::254]:80*.

*IMDS_ENDPOINT_WAIT_ATTEMPTS*=<number>
	Number of times to check for routes to any IMDS endpoint before trying
	metadata requests anyway. The default is *10*.

*IMDS_TOKEN_TTL*=<seconds>
	Metadata token lifetime in seconds for AWS metadata access. This is only used
	by the AWS provider. The default is *5*.

*TINY_CLOUD_VAR*=<path>
	State directory used by tiny-cloud. The default is _/var/lib/cloud_.

*TINY_CLOUD_LOGS*=<path>
	Log directory used by tiny-cloud. The default is _/var/log_.

*TINY_CLOUD_LV_ALLOCATE*=<percentage>
	How much space to allocate when expanding the "/" LVM logical volume in
	percentage. The default is 85 percent of the volume group's space.

*SKIP_INIT_ACTIONS*=<action> ...
	Whitespace-separated list of init actions to skip during phase execution.

	Common action names include *expand_root*, *set_hostname*, *set_ssh_keys*,
	*save_userdata*, *decompress_userdata*, and *run_userdata*.

# EXAMPLES

Force the AWS provider:

	CLOUD=aws

Use a different default login account:

	CLOUD_USER=ec2-user

Skip hostname and SSH key setup:

	SKIP_INIT_ACTIONS="set_hostname set_ssh_keys"

# SEE ALSO

*tiny-cloud*(8), *imds*(1)