1
0
mirror of https://gitlab.alpinelinux.org/alpine/cloud/tiny-cloud.git synced 2026-06-21 00:07:16 +03:00
tiny-cloud/docs/tiny-cloud.conf.5.scd
2026-05-18 12:56:13 +02:00

81 lines
2.0 KiB
Markdown

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>
Provider endpoint IP address to use. Defaults to 169.254.169.254 for many
providers.
*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)