EXTRAS(1)

NAME
amazon-linux-extras - manage specific fresh software

EXAMPLES
amazon-linux-extras install nano amazon-linux-extras install emacs=25.3 amazon-linux-extras enable vim=8.0; yum install vim-minimal amazon-linux-extras info nano

SYNOPSIS
amazon-linux-extras [list]
    See available topics. Footnotes mark additional information is in the "info" subcommand.
amazon-linux-extras install topics...
    Make fresh packages visible and install them now.
amazon-linux-extras help
    See a short, helpful summary of usage.
amazon-linux-extras info topic
    See additional information about a topic, if any exists. If the date that support ends is known, it will be listed here. The specific packages that a topic recommends (and would be installed with "install topic") will be listed here.
amazon-linux-extras enable topics...
    Make fresh packages visible to the YUM/DNF system but do not install them. (This command is discouraged except for advanced usage.)
amazon-linux-extras disable topics...
    Make not-yet-installed packages invisible to YUM/DNF system. It does not un-install anything. Post-install "disable" is not supported. (This command is discouraged except for advanced usage.)

DESCRIPTION
In software, stability and freshness are often at odds. Sometimes you want to have a known environment with a fresh piece or two of software. Amazon Linux provides fresh software on an optional basis, which you can fetch with this tool. You can specify a version of a topic by appending to its name, an equal-sign and then the version string, in the style of topic=ver . Specifying a version is a good idea if you wish to have reproducible environments. If you do not specify a version, you will use the symbolic name "latest", which always refers to the most recent version, floating over time. That is, your software retrieval system will point to the ever-changing contemporaneous "latest", not to a point in time frozen at when you enable that topic. Future updates will fetch things that have changed. Though it exists as an option here for advanced usage, disabling software after it is installed is not recommended or supported.

SUPPORT EXPIRATION
Extras do not carry the same long-term support as the rest of Amazon Linux. When an Extra loses support, the "info" subcommand querying that topic will have an exit code of 127. Additionally, to discourage further discovery and use, it will be omitted from the topic list if it is not enabled, and asterisked if it is locally enabled.

    $ amazon-linux-extras info exampletopic ; echo code $?
    Topic exampletopic has end-of-support date of 2017-01-01
    code 127

CONFIGURATION
A amazon-linux-extras.conf file is read at invocation, if existing, from all of /etc/, /usr/local/etc/, and $HOME/.config/amazon-linux/, with later values superceding earlier-set ones. Within those files, one can change behavior by setting variables listed below to values, in the style NAME=value Note, there are no spaces around equal-sign.

•   CATALOGURL

•   AWSDOMAIN

•   AWSREGION

•   RELEASEVER

•   BASEARCH

•   PATH

•   YUMCONFIG_FILE_NAME

CONFLICTS
Not all software topics are compatible. Repositories that provide different versions of the same software probably cannot cohabitate, and so by enabling one you probably make the other impossible to enable.

SEE ALSO
yum(8), dnf(8)