asdf/manage/configuration.html
2024-10-07 13:52:36 +00:00

32 lines
59 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Configuration | asdf</title>
<meta name="description" content="Manage multiple runtime versions with a single CLI tool">
<meta name="generator" content="VitePress v1.3.4">
<link rel="preload stylesheet" href="/assets/style.p0L2iRKi.css" as="style">
<script type="module" src="/assets/app.2_UJsjMp.js"></script>
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/assets/chunks/theme.BQKOjM6g.js">
<link rel="modulepreload" href="/assets/chunks/framework.C9NVOr0y.js">
<link rel="modulepreload" href="/assets/manage_configuration.md.BTxM-Kga.lean.js">
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-c8291ffa></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-c8291ffa> Skip to content </a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-0ad69264><a class="title" href="/" data-v-0ad69264><!--[--><!--]--><!----><span data-v-0ad69264>asdf</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guide/getting-started.html" tabindex="0" data-v-afb2845e data-v-08fbf4b6><!--[--><span data-v-08fbf4b6>Guide</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/manage/configuration.html" tabindex="0" data-v-afb2845e data-v-08fbf4b6><!--[--><span data-v-08fbf4b6>Reference</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-afb2845e data-v-af5898d3><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-af5898d3><span class="text" data-v-af5898d3><!----><span data-v-af5898d3>0.14.1</span><span class="vpi-chevron-down text-icon" data-v-af5898d3></span></span></button><div class="menu" data-v-af5898d3><div class="VPMenu" data-v-af5898d3 data-v-20ed86d6><div class="items" data-v-20ed86d6><!--[--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-f51f088d><a class="VPLink link vp-external-link-icon" href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer" data-v-f51f088d><!--[-->Changelog<!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-f51f088d><a class="VPLink link" href="/contribute/core.html" data-v-f51f088d><!--[-->Contribute<!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><div class="VPFlyout VPNavBarTranslations translations" data-v-9fd4d1dd data-v-acee064b data-v-af5898d3><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="Change language" data-v-af5898d3><span class="text" data-v-af5898d3><span class="vpi-languages option-icon" data-v-af5898d3></span><!----><span class="vpi-chevron-down text-icon" data-v-af5898d3></span></span></button><div class="menu" data-v-af5898d3><div class="VPMenu" data-v-af5898d3 data-v-20ed86d6><!----><!--[--><!--[--><div class="items" data-v-acee064b><p class="title" data-v-acee064b>English</p><!--[--><div class="VPMenuLink" data-v-acee064b data-v-f51f088d><a class="VPLink link" href="/ja-jp/manage/configuration.html" data-v-f51f088d><!--[-->日本語<!--]--></a></div><div class="VPMenuLink" data-v-acee064b data-v-f51f088d><a class="VPLink link" href="/pt-br/manage/configuration.html" data-v-f51f088d><!--[-->Brazilian Portuguese<!--]--></a></div><div class="VPMenuLink" data-v-acee064b data-v-f51f088d><a class="VPLink link" href="/zh-hans/manage/configuration.html" data-v-f51f088d><!--[-->简体中文<!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/asdf-vm/asdf" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-358b6670><span class="vpi-social-github" /></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-af5898d3><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-af5898d3><span class="vpi-more-horizontal icon" data-v-af5898d3></span></button><div class="menu" data-v-af5898d3><div class="VPMenu" data-v-af5898d3 data-v-20ed86d6><!----><!--[--><!--[--><div class="group translations" data-v-f953d92f><p class="trans-title" data-v-f953d92f>English</p><!--[--><div class="VPMenuLink" data-v-f953d92f data-v-f51f088d><a class="VPLink link" href="/ja-jp/manage/configuration.html" data-v-f51f088d><!--[-->日本語<!--]--></a></div><div class="VPMenuLink" data-v-f953d92f data-v-f51f088d><a class="VPLink link" href="/pt-br/manage/configuration.html" data-v-f51f088d><!--[-->Brazilian Portuguese<!--]--></a></div><div class="VPMenuLink" data-v-f953d92f data-v-f51f088d><a class="VPLink link" href="/zh-hans/manage/configuration.html" data-v-f51f088d><!--[-->简体中文<!--]--></a></div><!--]--></div><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>Appearance</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/asdf-vm/asdf" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-358b6670><span class="vpi-social-github" /></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-883964e0><button data-v-883964e0>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h2 class="text" data-v-edd2eed8>Guide</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-edd2eed8><span class="vpi-chevron-right caret-icon" data-v-edd2eed8></span></div></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/guide/introduction.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>What is asdf?</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/guide/getting-started.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Getting Started</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h2 class="text" data-v-edd2eed8>Usage</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-edd2eed8><span class="vpi-chevron-right caret-icon" data-v-edd2eed8></span></div></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/manage/core.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Core</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/manage/plugins.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Plugins</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/manage/versions.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Versions</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible has-active" data-v-51288d80 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h2 class="text" data-v-edd2eed8>Reference</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-edd2eed8><span class="vpi-chevron-right caret-icon" data-v-edd2eed8></span></div></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/manage/configuration.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/manage/commands.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>All Commands</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Plugin Shortname Index</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h2 class="text" data-v-edd2eed8>Plugins</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-edd2eed8><span class="vpi-chevron-right caret-icon" data-v-edd2eed8></span></div></div><div class="items" data-v-edd2eed8><!--[--><section class="VPSidebarItem level-1" data-v-edd2eed8 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h3 class="text" data-v-edd2eed8>Authors</h3><!----></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/plugins/create.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Create a Plugin</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf-plugin-template" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>GitHub Plugin Template</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-edd2eed8 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h3 class="text" data-v-edd2eed8>First Party Plugins</h3><!----></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Elixir</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Erlang</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Node.js</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Ruby</p><!--]--></a><!----></div><!----></div><!--]--></div></section><section class="VPSidebarItem level-1" data-v-edd2eed8 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h3 class="text" data-v-edd2eed8>Community Plugins</h3><!----></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-community" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>asdf-community</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>GitHub Topics Search</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h2 class="text" data-v-edd2eed8>Questions</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-edd2eed8><span class="vpi-chevron-right caret-icon" data-v-edd2eed8></span></div></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/more/faq.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>FAQ</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://github.com/asdf-vm/asdf/issues" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>GitHub Issues</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link vp-external-link-icon link" href="https://stackoverflow.com/questions/tagged/asdf-vm" target="_blank" rel="noreferrer" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Stack Overflow Tag</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible collapsed" data-v-51288d80 data-v-edd2eed8><div class="item" role="button" tabindex="0" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><h2 class="text" data-v-edd2eed8>Contribute</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-edd2eed8><span class="vpi-chevron-right caret-icon" data-v-edd2eed8></span></div></div><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/contribute/core.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Core asdf</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/contribute/documentation.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Documentation</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/contribute/first-party-plugins.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>First-Party Plugins</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/contribute/github-actions.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>GitHub Actions</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0" data-v-51288d80 data-v-edd2eed8><!----><div class="items" data-v-edd2eed8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/more/community-projects.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Community Projects</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-edd2eed8 data-v-edd2eed8><div class="item" data-v-edd2eed8><div class="indicator" data-v-edd2eed8></div><a class="VPLink link link" href="/more/thanks.html" data-v-edd2eed8><!--[--><p class="text" data-v-edd2eed8>Thanks</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>On this page</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _manage_configuration" data-v-e6f2a212><div><h1 id="configuration" tabindex="-1">Configuration <a class="header-anchor" href="#configuration" aria-label="Permalink to &quot;Configuration&quot;"></a></h1><p>Configuration of <code>asdf</code> encompasses both the sharable <code>.tool-versions</code> files as well as user specific customisations with <code>.asdfrc</code> and Environment Variables.</p><h2 id="tool-versions" tabindex="-1"><code>.tool-versions</code> <a class="header-anchor" href="#tool-versions" aria-label="Permalink to &quot;`.tool-versions`&quot;"></a></h2><p>Whenever <code>.tool-versions</code> file is present in a directory, the tool versions it declares will be used in that directory and any subdirectories.</p><div class="warning custom-block"><p class="custom-block-title">Note</p><p>Global defaults can be set in the file <code>$HOME/.tool-versions</code></p></div><p>This is what a <code>.tool-versions</code> file looks like:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>ruby 2.5.3</span></span>
<span class="line"><span>nodejs 10.15.0</span></span></code></pre></div><p>You can also include comments:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>ruby 2.5.3 # This is a comment</span></span>
<span class="line"><span># This is another comment</span></span>
<span class="line"><span>nodejs 10.15.0</span></span></code></pre></div><p>The versions can be in the following format:</p><ul><li><code>10.15.0</code> - an actual version. Plugins that support downloading binaries, will download binaries.</li><li><code>ref:v1.0.2-a</code> or <code>ref:39cb398vb39</code> - tag/commit/branch to download from github and compile</li><li><code>path:~/src/elixir</code> - a path to custom compiled version of a tool to use. For use by language developers and such.</li><li><code>system</code> - this keyword causes asdf to passthrough to the version of the tool on the system that is not managed by asdf.</li></ul><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>Multiple versions can be set by separating them with a space. For example, to use Python <code>3.7.2</code>, fallback to Python <code>2.7.15</code> and finally to the <code>system</code> Python, the following line can be added to <code>.tool-versions</code>.</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>python 3.7.2 2.7.15 system</span></span></code></pre></div></div><p>To install all the tools defined in a <code>.tool-versions</code> file run <code>asdf install</code> with no other arguments in the directory containing the <code>.tool-versions</code> file.</p><p>To install a single tool defined in a <code>.tool-versions</code> file run <code>asdf install &lt;name&gt;</code> in the directory containing the <code>.tool-versions</code> file. The tool will be installed at the version specified in the <code>.tool-versions</code> file.</p><p>Edit the file directly or use <code>asdf local</code> (or <code>asdf global</code>) which updates it.</p><h2 id="asdfrc" tabindex="-1"><code>.asdfrc</code> <a class="header-anchor" href="#asdfrc" aria-label="Permalink to &quot;`.asdfrc`&quot;"></a></h2><p>The <code>.asdfrc</code> file defines the user&#39;s machine specific configuration.</p><p><code>${HOME}/.asdfrc</code> is the default location used by asdf. This can be set with the <a href="#asdfconfigfile">Environment Variable <code>ASDF_CONFIG_FILE</code></a>.</p><p>The below file shows the required format with the default values:</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>legacy_version_file = no</span></span>
<span class="line"><span>use_release_candidates = no</span></span>
<span class="line"><span>always_keep_download = no</span></span>
<span class="line"><span>plugin_repository_last_check_duration = 60</span></span>
<span class="line"><span>disable_plugin_short_name_repository = no</span></span>
<span class="line"><span>concurrency = auto</span></span></code></pre></div><h3 id="legacy-version-file" tabindex="-1"><code>legacy_version_file</code> <a class="header-anchor" href="#legacy-version-file" aria-label="Permalink to &quot;`legacy_version_file`&quot;"></a></h3><p>Plugins <strong>with support</strong> can read the versions files used by other version managers, for example, <code>.ruby-version</code> in the case of Ruby&#39;s <code>rbenv</code>.</p><table tabindex="0"><thead><tr><th style="text-align:left;">Options</th><th style="text-align:left;">Description</th></tr></thead><tbody><tr><td style="text-align:left;"><code>no</code> <span class="VPBadge tip" vertical="middle"><!--[-->default<!--]--></span></td><td style="text-align:left;">Use <code>.tool-versions</code> to read versions</td></tr><tr><td style="text-align:left;"><code>yes</code></td><td style="text-align:left;">Use plugin fallback to legacy version files (<code>.ruby-version</code>) if available</td></tr></tbody></table><h3 id="use-release-candidates" tabindex="-1"><code>use_release_candidates</code> <a class="header-anchor" href="#use-release-candidates" aria-label="Permalink to &quot;`use_release_candidates`&quot;"></a></h3><p>Configure the <code>asdf update</code> command to upgrade to the latest Release Candidate instead of the latest Semantic Version.</p><table tabindex="0"><thead><tr><th style="text-align:left;">Options</th><th style="text-align:left;">Description</th></tr></thead><tbody><tr><td style="text-align:left;"><code>no</code> <span class="VPBadge tip" vertical="middle"><!--[-->default<!--]--></span></td><td style="text-align:left;">Semantic Version is used</td></tr><tr><td style="text-align:left;"><code>yes</code></td><td style="text-align:left;">Release Candidate is used</td></tr></tbody></table><h3 id="always-keep-download" tabindex="-1"><code>always_keep_download</code> <a class="header-anchor" href="#always-keep-download" aria-label="Permalink to &quot;`always_keep_download`&quot;"></a></h3><p>Configure the <code>asdf install</code> command to keep or delete the source code or binary it downloads.</p><table tabindex="0"><thead><tr><th style="text-align:left;">Options</th><th style="text-align:left;">Description</th></tr></thead><tbody><tr><td style="text-align:left;"><code>no</code> <span class="VPBadge tip" vertical="middle"><!--[-->default<!--]--></span></td><td style="text-align:left;">Delete source code or binary after successful install</td></tr><tr><td style="text-align:left;"><code>yes</code></td><td style="text-align:left;">Keep source code or binary after install</td></tr></tbody></table><h3 id="plugin-repository-last-check-duration" tabindex="-1"><code>plugin_repository_last_check_duration</code> <a class="header-anchor" href="#plugin-repository-last-check-duration" aria-label="Permalink to &quot;`plugin_repository_last_check_duration`&quot;"></a></h3><p>Configure the duration (in minutes) between asdf plugin repository syncs. Trigger events result in a check of the duration. If more time has elapsed since the last sync than specified in the duration, a new sync occurs.</p><table tabindex="0"><thead><tr><th style="text-align:left;">Options</th><th style="text-align:left;">Description</th></tr></thead><tbody><tr><td style="text-align:left;">integer in range <code>1</code> to <code>999999999</code> <br> <code>60</code> is <span class="VPBadge tip" vertical="middle"><!--[-->default<!--]--></span></td><td style="text-align:left;">Sync on trigger event if duration (in minutes) since last sync has been exceeded</td></tr><tr><td style="text-align:left;"><code>0</code></td><td style="text-align:left;">Sync on each trigger event</td></tr><tr><td style="text-align:left;"><code>never</code></td><td style="text-align:left;">Never sync</td></tr></tbody></table><p>Sync events occur when the following commands are executed:</p><ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul><p><code>asdf plugin add &lt;name&gt; &lt;git-url&gt;</code> does NOT trigger a plugin sync.</p><div class="warning custom-block"><p class="custom-block-title">Note</p><p>Setting the value to <code>never</code> does not stop the plugin repository from being initially synced, for that behaviour see <code>disable_plugin_short_name_repository</code>.</p></div><h3 id="disable-plugin-short-name-repository" tabindex="-1"><code>disable_plugin_short_name_repository</code> <a class="header-anchor" href="#disable-plugin-short-name-repository" aria-label="Permalink to &quot;`disable_plugin_short_name_repository`&quot;"></a></h3><p>Disable synchronization of the asdf plugin short-name repository. Sync events will exit early if the short-name repository is disabled.</p><table tabindex="0"><thead><tr><th style="text-align:left;">Options</th><th style="text-align:left;">Description</th></tr></thead><tbody><tr><td style="text-align:left;"><code>no</code> <span class="VPBadge tip" vertical="middle"><!--[-->default<!--]--></span></td><td style="text-align:left;">Clone or update the asdf plugin repository on sync events</td></tr><tr><td style="text-align:left;"><code>yes</code></td><td style="text-align:left;">Disable the plugin short-name repository</td></tr></tbody></table><p>Sync events occur when the following commands are executed:</p><ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul><p><code>asdf plugin add &lt;name&gt; &lt;git-url&gt;</code> does NOT trigger a plugin sync.</p><div class="warning custom-block"><p class="custom-block-title">Note</p><p>Disabling the plugin short-name repository does not remove the repository if it has already synced. Remove the plugin repo with <code>rm --recursive --trash $ASDF_DATA_DIR/repository</code>.</p><p>Disabling the plugin short-name repository does not remove plugins previously installed from this source. Plugins can be removed with <code>asdf plugin remove &lt;name&gt;</code>. Removing a plugin will remove all installed versions of the managed tool.</p></div><h3 id="concurrency" tabindex="-1"><code>concurrency</code> <a class="header-anchor" href="#concurrency" aria-label="Permalink to &quot;`concurrency`&quot;"></a></h3><p>The default number of cores to use during compilation.</p><table tabindex="0"><thead><tr><th style="text-align:left;">Options</th><th style="text-align:left;">Description</th></tr></thead><tbody><tr><td style="text-align:left;">integer</td><td style="text-align:left;">Number of cores to use when compiling the source code</td></tr><tr><td style="text-align:left;"><code>auto</code></td><td style="text-align:left;">Calculate the number of cores using <code>nproc</code>, then <code>sysctl hw.ncpu</code>, then <code>/proc/cpuinfo</code> or else <code>1</code></td></tr></tbody></table><p>Note: the environment variable <code>ASDF_CONCURRENCY</code> take precedence if set.</p><h3 id="plugin-hooks" tabindex="-1">Plugin Hooks <a class="header-anchor" href="#plugin-hooks" aria-label="Permalink to &quot;Plugin Hooks&quot;"></a></h3><p>It is possible to execute custom code:</p><ul><li>Before or after a plugin is installed, reshimed, updated, or uninstalled</li><li>Before or after a plugin command is executed</li></ul><p>For example, if a plugin called <code>foo</code> is installed and provides a <code>bar</code> executable, then the following hooks can be used to execute custom code first:</p><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>pre_foo_bar = echo Executing with args: $@</span></span></code></pre></div><p>The following patterns are supported:</p><ul><li><code>pre_&lt;plugin_name&gt;_&lt;command&gt;</code></li><li><code>pre_asdf_download_&lt;plugin_name&gt;</code></li><li><code>{pre,post}_asdf_{install,reshim,uninstall}_&lt;plugin_name&gt;</code><ul><li><code>$1</code>: full version</li></ul></li><li><code>{pre,post}_asdf_plugin_{add,update,remove,reshim}</code><ul><li><code>$1</code>: plugin name</li></ul></li><li><code>{pre,post}_asdf_plugin_{add,update,remove}_&lt;plugin_name&gt;</code></li></ul><p>See <a href="./../plugins/create.html">Create a Plugin</a> for specifics on what command hooks are ran before or after what commands.</p><h2 id="environment-variables" tabindex="-1">Environment Variables <a class="header-anchor" href="#environment-variables" aria-label="Permalink to &quot;Environment Variables&quot;"></a></h2><p>Setting environment variables varies depending on your system and Shell. Default locations depend upon your installation location and method (Git clone, Homebrew, AUR).</p><p>Environment variables should generally be set before sourcing <code>asdf.sh</code>/<code>asdf.fish</code> etc. For Elvish set above <code>use asdf</code>.</p><p>The following describe usage with a Bash Shell.</p><h3 id="asdf-config-file" tabindex="-1"><code>ASDF_CONFIG_FILE</code> <a class="header-anchor" href="#asdf-config-file" aria-label="Permalink to &quot;`ASDF_CONFIG_FILE`&quot;"></a></h3><p>Path to the <code>.asdfrc</code> configuration file. Can be set to any location. Must be an absolute path.</p><ul><li>If Unset: <code>$HOME/.asdfrc</code> will be used.</li><li>Usage: <code>export ASDF_CONFIG_FILE=/home/john_doe/.config/asdf/.asdfrc</code></li></ul><h3 id="asdf-default-tool-versions-filename" tabindex="-1"><code>ASDF_DEFAULT_TOOL_VERSIONS_FILENAME</code> <a class="header-anchor" href="#asdf-default-tool-versions-filename" aria-label="Permalink to &quot;`ASDF_DEFAULT_TOOL_VERSIONS_FILENAME`&quot;"></a></h3><p>The filename of the file storing the tool names and versions. Can be any valid filename. Typically, you should not set this value unless you want to ignore <code>.tool-versions</code> files.</p><ul><li>If Unset: <code>.tool-versions</code> will be used.</li><li>Usage: <code>export ASDF_DEFAULT_TOOL_VERSIONS_FILENAME=tool_versions</code></li></ul><h3 id="asdf-dir" tabindex="-1"><code>ASDF_DIR</code> <a class="header-anchor" href="#asdf-dir" aria-label="Permalink to &quot;`ASDF_DIR`&quot;"></a></h3><p>The location of <code>asdf</code> core scripts. Can be set to any location. Must be an absolute path.</p><ul><li>If Unset: the parent directory of the <code>bin/asdf</code> executable is used.</li><li>Usage: <code>export ASDF_DIR=/home/john_doe/.config/asdf</code></li></ul><h3 id="asdf-data-dir" tabindex="-1"><code>ASDF_DATA_DIR</code> <a class="header-anchor" href="#asdf-data-dir" aria-label="Permalink to &quot;`ASDF_DATA_DIR`&quot;"></a></h3><p>The location where <code>asdf</code> will install plugins, shims and tool versions. Can be set to any location. Must be an absolute path.</p><ul><li>If Unset: <code>$HOME/.asdf</code> if it exists, or else the value of <code>ASDF_DIR</code></li><li>Usage: <code>export ASDF_DATA_DIR=/home/john_doe/.asdf</code></li></ul><h3 id="asdf-concurrency" tabindex="-1"><code>ASDF_CONCURRENCY</code> <a class="header-anchor" href="#asdf-concurrency" aria-label="Permalink to &quot;`ASDF_CONCURRENCY`&quot;"></a></h3><p>Number of cores to use when compiling the source code. If set, this value takes precedence over the asdf config <code>concurrency</code> value.</p><ul><li>If Unset: the asdf config <code>concurrency</code> value is used.</li><li>Usage: <code>export ASDF_CONCURRENCY=32</code></li></ul><h3 id="asdf-force-prepend" tabindex="-1"><code>ASDF_FORCE_PREPEND</code> <a class="header-anchor" href="#asdf-force-prepend" aria-label="Permalink to &quot;`ASDF_FORCE_PREPEND`&quot;"></a></h3><p>Whether or not to prepend the <code>asdf</code> shims and path directories to the front-most (highest-priority) part of the <code>PATH</code>.</p><ul><li>If Unset: On macOS, defaults to <code>yes</code>; but on other systems, defaults to <code>no</code></li><li>If <code>yes</code>: Force <code>asdf</code> directories to the front of the <code>PATH</code></li><li>If set to any string <em>other</em> than <code>yes</code>: Do <em>not</em> force <code>asdf</code> directories to the front of the <code>PATH</code></li><li>Usage: <code>ASDF_FORCE_PREPEND=no . &quot;&lt;path-to-asdf-directory&gt;/asdf.sh&quot;</code></li></ul><h2 id="full-configuration-example" tabindex="-1">Full Configuration Example <a class="header-anchor" href="#full-configuration-example" aria-label="Permalink to &quot;Full Configuration Example&quot;"></a></h2><p>Following a simple asdf setup with:</p><ul><li>a Bash Shell</li><li>an installation location of <code>$HOME/.asdf</code></li><li>installed via Git</li><li>NO environment variables set</li><li>NO custom <code>.asdfrc</code> file</li></ul><p>would result in the following outcomes:</p><table tabindex="0"><thead><tr><th style="text-align:left;">Configuration</th><th style="text-align:left;">Value</th><th style="text-align:left;">Calculated by</th></tr></thead><tbody><tr><td style="text-align:left;">config file location</td><td style="text-align:left;"><code>$HOME/.asdfrc</code></td><td style="text-align:left;"><code>ASDF_CONFIG_FILE</code> is empty, so use <code>$HOME/.asdfrc</code></td></tr><tr><td style="text-align:left;">default tool versions filename</td><td style="text-align:left;"><code>.tool-versions</code></td><td style="text-align:left;"><code>ASDF_DEFAULT_TOOL_VERSIONS_FILENAME</code> is empty, so use <code>.tool-versions</code></td></tr><tr><td style="text-align:left;">asdf dir</td><td style="text-align:left;"><code>$HOME/.asdf</code></td><td style="text-align:left;"><code>ASDF_DIR</code> is empty, so use parent dir of <code>bin/asdf</code></td></tr><tr><td style="text-align:left;">asdf data dir</td><td style="text-align:left;"><code>$HOME/.asdf</code></td><td style="text-align:left;"><code>ASDF_DATA_DIR</code> is empty so use <code>$HOME/.asdf</code> as <code>$HOME</code> exists.</td></tr><tr><td style="text-align:left;">concurrency</td><td style="text-align:left;"><code>auto</code></td><td style="text-align:left;"><code>ASDF_CONCURRENCY</code> is empty, so rely on <code>concurrency</code> value from the <a href="https://github.com/asdf-vm/asdf/blob/master/defaults" target="_blank" rel="noreferrer">default configuration</a></td></tr><tr><td style="text-align:left;">legacy_version_file</td><td style="text-align:left;"><code>no</code></td><td style="text-align:left;">No custom <code>.asdfrc</code>, so use the <a href="https://github.com/asdf-vm/asdf/blob/master/defaults" target="_blank" rel="noreferrer">default configuration</a></td></tr><tr><td style="text-align:left;">use_release_candidates</td><td style="text-align:left;"><code>no</code></td><td style="text-align:left;">No custom <code>.asdfrc</code>, so use the <a href="https://github.com/asdf-vm/asdf/blob/master/defaults" target="_blank" rel="noreferrer">default configuration</a></td></tr><tr><td style="text-align:left;">always_keep_download</td><td style="text-align:left;"><code>no</code></td><td style="text-align:left;">No custom <code>.asdfrc</code>, so use the <a href="https://github.com/asdf-vm/asdf/blob/master/defaults" target="_blank" rel="noreferrer">default configuration</a></td></tr><tr><td style="text-align:left;">plugin_repository_last_check_duration</td><td style="text-align:left;"><code>60</code></td><td style="text-align:left;">No custom <code>.asdfrc</code>, so use the <a href="https://github.com/asdf-vm/asdf/blob/master/defaults" target="_blank" rel="noreferrer">default configuration</a></td></tr><tr><td style="text-align:left;">disable_plugin_short_name_repository</td><td style="text-align:left;"><code>no</code></td><td style="text-align:left;">No custom <code>.asdfrc</code>, so use the <a href="https://github.com/asdf-vm/asdf/blob/master/defaults" target="_blank" rel="noreferrer">default configuration</a></td></tr></tbody></table><h2 id="internal-configuration" tabindex="-1">Internal Configuration <a class="header-anchor" href="#internal-configuration" aria-label="Permalink to &quot;Internal Configuration&quot;"></a></h2><p>Users should not worry about this section as it describes configuration internal to <code>asdf</code> useful for Package Managers and integrators.</p><ul><li><code>$ASDF_DIR/asdf_updates_disabled</code>: Updates via the <code>asdf update</code> command are disabled when this file is present (content irrelevant). This is used by package managers like Pacman or Homebrew to ensure the correct update method is used for the particular installation.</li></ul></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><div class="edit-info" data-v-1bcd8184><!----><div class="last-updated" data-v-1bcd8184><p class="VPLastUpdated" data-v-1bcd8184 data-v-1bb0c8a8>Last updated: <time datetime="2023-11-09T00:25:04.000Z" data-v-1bb0c8a8></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-1bcd8184><span class="visually-hidden" id="doc-footer-aria-label" data-v-1bcd8184>Pager</span><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link prev" href="/manage/versions.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Previous page</span><span class="title" data-v-1bcd8184>Versions</span><!--]--></a></div><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link next" href="/manage/commands.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>Next page</span><span class="title" data-v-1bcd8184>All Commands</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
<script>window.__VP_HASH_MAP__=JSON.parse("{\"contribute_core.md\":\"BABeyVan\",\"contribute_documentation.md\":\"BYyBOKz0\",\"contribute_first-party-plugins.md\":\"CpFWKmHh\",\"contribute_github-actions.md\":\"CA9Mkw8-\",\"guide_getting-started.md\":\"C3BDv6cZ\",\"guide_introduction.md\":\"D7TZl5Xp\",\"index.md\":\"CX4EfemI\",\"ja-jp_contribute_core.md\":\"Dl6llQ1K\",\"ja-jp_contribute_documentation.md\":\"DFrK7QhV\",\"ja-jp_contribute_first-party-plugins.md\":\"C-K_bFJd\",\"ja-jp_contribute_github-actions.md\":\"vwGbnpnK\",\"ja-jp_guide_getting-started.md\":\"BOrg7Hf7\",\"ja-jp_guide_introduction.md\":\"BiCZxaSp\",\"ja-jp_index.md\":\"Nw2yHZ3B\",\"ja-jp_manage_commands.md\":\"VPBtL-Un\",\"ja-jp_manage_configuration.md\":\"BoE7Ge6N\",\"ja-jp_manage_core.md\":\"B1eqmXXm\",\"ja-jp_manage_plugins.md\":\"Cbru-sBo\",\"ja-jp_manage_versions.md\":\"Dxk0G51J\",\"ja-jp_more_community-projects.md\":\"Drt5Trip\",\"ja-jp_more_faq.md\":\"DWV2Lkfg\",\"ja-jp_more_thanks.md\":\"DgZpeSyP\",\"ja-jp_plugins_create.md\":\"CF7Jmvco\",\"manage_commands.md\":\"BSbw1HQ9\",\"manage_configuration.md\":\"BTxM-Kga\",\"manage_core.md\":\"BUHLaRG4\",\"manage_plugins.md\":\"BOsG6k4O\",\"manage_versions.md\":\"CAp-N8AZ\",\"more_community-projects.md\":\"B9Jb3CEv\",\"more_faq.md\":\"BjmX8xoH\",\"more_thanks.md\":\"C4xnnmzS\",\"plugins_create.md\":\"Ba4Peca-\",\"pt-br_contribute_core.md\":\"BB7joZcW\",\"pt-br_contribute_documentation.md\":\"D_CeZJ9y\",\"pt-br_contribute_first-party-plugins.md\":\"TUKlMnR4\",\"pt-br_contribute_github-actions.md\":\"BpD2TMaX\",\"pt-br_guide_getting-started.md\":\"Bxtluukf\",\"pt-br_guide_introduction.md\":\"C231JBSG\",\"pt-br_index.md\":\"B18T-HnP\",\"pt-br_manage_commands.md\":\"C9u0wbDc\",\"pt-br_manage_configuration.md\":\"Bo5UByU1\",\"pt-br_manage_core.md\":\"CTnvZ9A5\",\"pt-br_manage_plugins.md\":\"CuNF9gHf\",\"pt-br_manage_versions.md\":\"Ctc109hL\",\"pt-br_more_community-projects.md\":\"C3m600b2\",\"pt-br_more_faq.md\":\"Bch3gpm2\",\"pt-br_more_thanks.md\":\"BziNXVH9\",\"pt-br_plugins_create.md\":\"CnPY6mOB\",\"zh-hans_contribute_core.md\":\"oF4_zk5Q\",\"zh-hans_contribute_documentation.md\":\"DL3_2XKG\",\"zh-hans_contribute_first-party-plugins.md\":\"CaobaPwV\",\"zh-hans_contribute_github-actions.md\":\"BMOvSElT\",\"zh-hans_guide_getting-started.md\":\"neLGUZQV\",\"zh-hans_guide_introduction.md\":\"4qLfdOnh\",\"zh-hans_index.md\":\"DQ8VBECv\",\"zh-hans_manage_commands.md\":\"BJVPpY77\",\"zh-hans_manage_configuration.md\":\"DckznVe9\",\"zh-hans_manage_core.md\":\"_3uzcWzu\",\"zh-hans_manage_plugins.md\":\"DY_Xuyjn\",\"zh-hans_manage_versions.md\":\"BOLJYZ7r\",\"zh-hans_more_community-projects.md\":\"yE4Odlba\",\"zh-hans_more_faq.md\":\"CgpfvsMk\",\"zh-hans_more_thanks.md\":\"Dyz87Q2k\",\"zh-hans_plugins_create.md\":\"P38AmJ4g\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"asdf\",\"description\":\"Manage multiple runtime versions with a single CLI tool\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/asdf-vm/asdf\"}]},\"locales\":{\"root\":{\"label\":\"English\",\"lang\":\"en-US\",\"themeConfig\":{\"nav\":[{\"text\":\"Guide\",\"link\":\"/guide/getting-started\"},{\"text\":\"Reference\",\"link\":\"/manage/configuration\"},{\"text\":\"0.14.1\",\"items\":[{\"text\":\"Changelog\",\"link\":\"https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md\"},{\"text\":\"Contribute\",\"link\":\"/contribute/core\"}]}],\"sidebar\":[{\"text\":\"Guide\",\"collapsed\":false,\"items\":[{\"text\":\"What is asdf?\",\"link\":\"/guide/introduction\"},{\"text\":\"Getting Started\",\"link\":\"/guide/getting-started\"}]},{\"text\":\"Usage\",\"collapsed\":false,\"items\":[{\"text\":\"Core\",\"link\":\"/manage/core\"},{\"text\":\"Plugins\",\"link\":\"/manage/plugins\"},{\"text\":\"Versions\",\"link\":\"/manage/versions\"}]},{\"text\":\"Reference\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/manage/configuration\"},{\"text\":\"All Commands\",\"link\":\"/manage/commands\"},{\"text\":\"Plugin Shortname Index\",\"link\":\"https://github.com/asdf-vm/asdf-plugins\"}]},{\"text\":\"Plugins\",\"collapsed\":true,\"items\":[{\"text\":\"Authors\",\"items\":[{\"text\":\"Create a Plugin\",\"link\":\"/plugins/create\"},{\"text\":\"GitHub Plugin Template\",\"link\":\"https://github.com/asdf-vm/asdf-plugin-template\"}]},{\"text\":\"First Party Plugins\",\"items\":[{\"text\":\"Elixir\",\"link\":\"https://github.com/asdf-vm/asdf-elixir\"},{\"text\":\"Erlang\",\"link\":\"https://github.com/asdf-vm/asdf-erlang\"},{\"text\":\"Node.js\",\"link\":\"https://github.com/asdf-vm/asdf-nodejs\"},{\"text\":\"Ruby\",\"link\":\"https://github.com/asdf-vm/asdf-ruby\"}]},{\"text\":\"Community Plugins\",\"items\":[{\"text\":\"asdf-community\",\"link\":\"https://github.com/asdf-community\"},{\"text\":\"GitHub Topics Search\",\"link\":\"https://github.com/topics/asdf-plugin\"}]}]},{\"text\":\"Questions\",\"collapsed\":true,\"items\":[{\"text\":\"FAQ\",\"link\":\"/more/faq\"},{\"text\":\"GitHub Issues\",\"link\":\"https://github.com/asdf-vm/asdf/issues\"},{\"text\":\"Stack Overflow Tag\",\"link\":\"https://stackoverflow.com/questions/tagged/asdf-vm\"}]},{\"text\":\"Contribute\",\"collapsed\":true,\"items\":[{\"text\":\"Core asdf\",\"link\":\"/contribute/core\"},{\"text\":\"Documentation\",\"link\":\"/contribute/documentation\"},{\"text\":\"First-Party Plugins\",\"link\":\"/contribute/first-party-plugins\"},{\"text\":\"GitHub Actions\",\"link\":\"/contribute/github-actions\"}]},{\"text\":\"Community Projects\",\"link\":\"/more/community-projects\"},{\"text\":\"Thanks\",\"link\":\"/more/thanks\"}]}},\"ja-jp\":{\"label\":\"日本語\",\"lang\":\"ja-jp\",\"themeConfig\":{\"nav\":[{\"text\":\"ガイド\",\"link\":\"/ja-jp/guide/getting-started\"},{\"text\":\"リファレンス\",\"link\":\"/ja-jp/manage/configuration\"},{\"text\":\"0.14.1\",\"items\":[{\"text\":\"変更履歴\",\"link\":\"https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md\"},{\"text\":\"コントリビューション\",\"link\":\"/ja-jp/contribute/core\"}]}],\"sidebar\":[{\"text\":\"ガイド\",\"collapsed\":false,\"items\":[{\"text\":\"asdfってなに?\",\"link\":\"/ja-jp/guide/introduction\"},{\"text\":\"はじめよう\",\"link\":\"/ja-jp/guide/getting-started\"}]},{\"text\":\"使い方\",\"collapsed\":false,\"items\":[{\"text\":\"コア\",\"link\":\"/ja-jp/manage/core\"},{\"text\":\"プラグイン\",\"link\":\"/ja-jp/manage/plugins\"},{\"text\":\"バージョン\",\"link\":\"/ja-jp/manage/versions\"}]},{\"text\":\"リファレンス\",\"collapsed\":false,\"items\":[{\"text\":\"構成設定\",\"link\":\"/ja-jp/manage/configuration\"},{\"text\":\"すべてのコマンド\",\"link\":\"/ja-jp/manage/commands\"},{\"text\":\"プラグインショートネームの一覧\",\"link\":\"https://github.com/asdf-vm/asdf-plugins\"}]},{\"text\":\"プラグイン\",\"collapsed\":true,\"items\":[{\"text\":\"開発者向け\",\"items\":[{\"text\":\"プラグインの作成\",\"link\":\"/ja-jp/plugins/create\"},{\"text\":\"GitHubプラグインテンプレート\",\"link\":\"https://github.com/asdf-vm/asdf-plugin-template\"}]},{\"text\":\"公式プラグイン\",\"items\":[{\"text\":\"Elixir\",\"link\":\"https://github.com/asdf-vm/asdf-elixir\"},{\"text\":\"Erlang\",\"link\":\"https://github.com/asdf-vm/asdf-erlang\"},{\"text\":\"Node.js\",\"link\":\"https://github.com/asdf-vm/asdf-nodejs\"},{\"text\":\"Ruby\",\"link\":\"https://github.com/asdf-vm/asdf-ruby\"}]},{\"text\":\"コミュニティプラグイン\",\"items\":[{\"text\":\"asdf-community\",\"link\":\"https://github.com/asdf-community\"},{\"text\":\"GitHubトピック検索\",\"link\":\"https://github.com/topics/asdf-plugin\"}]}]},{\"text\":\"困ったときは\",\"collapsed\":true,\"items\":[{\"text\":\"FAQ\",\"link\":\"/ja-jp/more/faq\"},{\"text\":\"GitHub イシュー\",\"link\":\"https://github.com/asdf-vm/asdf/issues\"},{\"text\":\"Stack Overflow タグ\",\"link\":\"https://stackoverflow.com/questions/tagged/asdf-vm\"}]},{\"text\":\"コントリビューション\",\"collapsed\":true,\"items\":[{\"text\":\"asdf コア\",\"link\":\"/ja-jp/contribute/core\"},{\"text\":\"ドキュメント\",\"link\":\"/ja-jp/contribute/documentation\"},{\"text\":\"公式プラグイン\",\"link\":\"/ja-jp/contribute/first-party-plugins\"},{\"text\":\"GitHub Actions\",\"link\":\"/ja-jp/contribute/github-actions\"}]},{\"text\":\"コミュニティプロジェクト\",\"link\":\"/ja-jp/more/community-projects\"},{\"text\":\"謝辞\",\"link\":\"/ja-jp/more/thanks\"}]}},\"pt-br\":{\"label\":\"Brazilian Portuguese\",\"lang\":\"pr-br\",\"themeConfig\":{\"nav\":[{\"text\":\"Guia\",\"link\":\"/pt-br/guide/getting-started\"},{\"text\":\"Referência\",\"link\":\"/pt-br/manage/configuration\"},{\"text\":\"0.14.1\",\"items\":[{\"text\":\"Changelog\",\"link\":\"https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md\"},{\"text\":\"Contribute\",\"link\":\"/pt-br/contribute/core\"}]}],\"sidebar\":[{\"text\":\"Guia\",\"collapsed\":false,\"items\":[{\"text\":\"O que é asdf?\",\"link\":\"/pt-br/guide/introduction\"},{\"text\":\"Começar\",\"link\":\"/pt-br/guide/getting-started\"}]},{\"text\":\"Uso\",\"collapsed\":false,\"items\":[{\"text\":\"Essencial\",\"link\":\"/pt-br/manage/core\"},{\"text\":\"Plugins\",\"link\":\"/pt-br/manage/plugins\"},{\"text\":\"Versões\",\"link\":\"/pt-br/manage/versions\"}]},{\"text\":\"Referência\",\"collapsed\":false,\"items\":[{\"text\":\"Configuração\",\"link\":\"/pt-br/manage/configuration\"},{\"text\":\"Todos os comandos\",\"link\":\"/pt-br/manage/commands\"},{\"text\":\"Plugin Shortname Index\",\"link\":\"https://github.com/asdf-vm/asdf-plugins\"}]},{\"text\":\"Plugins\",\"collapsed\":true,\"items\":[{\"text\":\"Autoria\",\"items\":[{\"text\":\"Criar um plug-in\",\"link\":\"/pt-br/plugins/create\"},{\"text\":\"GitHub Plugin Template\",\"link\":\"https://github.com/asdf-vm/asdf-plugin-template\"}]},{\"text\":\"Plug-ins Próprios\",\"items\":[{\"text\":\"Elixir\",\"link\":\"https://github.com/asdf-vm/asdf-elixir\"},{\"text\":\"Erlang\",\"link\":\"https://github.com/asdf-vm/asdf-erlang\"},{\"text\":\"Node.js\",\"link\":\"https://github.com/asdf-vm/asdf-nodejs\"},{\"text\":\"Ruby\",\"link\":\"https://github.com/asdf-vm/asdf-ruby\"}]},{\"text\":\"Plug-ins da Comunidade\",\"items\":[{\"text\":\"asdf-community\",\"link\":\"https://github.com/asdf-community\"},{\"text\":\"GitHub Topics Search\",\"link\":\"https://github.com/topics/asdf-plugin\"}]}]},{\"text\":\"Questões\",\"collapsed\":true,\"items\":[{\"text\":\"Perguntas Frequentes\",\"link\":\"/pt-br/more/faq\"},{\"text\":\"GitHub Issues\",\"link\":\"https://github.com/asdf-vm/asdf/issues\"},{\"text\":\"Stack Overflow Tag\",\"link\":\"https://stackoverflow.com/questions/tagged/asdf-vm\"}]},{\"text\":\"Contribute\",\"collapsed\":true,\"items\":[{\"text\":\"Essencial asdf\",\"link\":\"/pt-br/contribute/core\"},{\"text\":\"Documentação\",\"link\":\"/pt-br/contribute/documentation\"},{\"text\":\"Plug-ins Próprios\",\"link\":\"/pt-br/contribute/first-party-plugins\"},{\"text\":\"GitHub Actions\",\"link\":\"/pt-br/contribute/github-actions\"}]},{\"text\":\"Projetos Comunitários\",\"link\":\"/pt-br/more/community-projects\"},{\"text\":\"Créditos\",\"link\":\"/pt-br/more/thanks\"}]}},\"zh-hans\":{\"label\":\"简体中文\",\"lang\":\"zh-hans\",\"themeConfig\":{\"nav\":[{\"text\":\"指导\",\"link\":\"/zh-hans/guide/getting-started\"},{\"text\":\"参考\",\"link\":\"/zh-hans/manage/configuration\"},{\"text\":\"0.14.1\",\"items\":[{\"text\":\"Changelog\",\"link\":\"https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md\"},{\"text\":\"如何贡献\",\"link\":\"/zh-hans/contribute/core\"}]}],\"sidebar\":[{\"text\":\"指导\",\"collapsed\":false,\"items\":[{\"text\":\"什么是asdf\",\"link\":\"/zh-hans/guide/introduction\"},{\"text\":\"快速入门\",\"link\":\"/zh-hans/guide/getting-started\"}]},{\"text\":\"用法\",\"collapsed\":false,\"items\":[{\"text\":\"核心\",\"link\":\"/zh-hans/manage/core\"},{\"text\":\"插件\",\"link\":\"/zh-hans/manage/plugins\"},{\"text\":\"版本\",\"link\":\"/zh-hans/manage/versions\"}]},{\"text\":\"参考\",\"collapsed\":false,\"items\":[{\"text\":\"配置\",\"link\":\"/zh-hans/manage/configuration\"},{\"text\":\"所有命令\",\"link\":\"/zh-hans/manage/commands\"},{\"text\":\"插件缩写索引\",\"link\":\"https://github.com/asdf-vm/asdf-plugins\"}]},{\"text\":\"插件\",\"collapsed\":true,\"items\":[{\"text\":\"成为作者\",\"items\":[{\"text\":\"创建插件\",\"link\":\"/zh-hans/plugins/create\"},{\"text\":\"GitHub 插件模板\",\"link\":\"https://github.com/asdf-vm/asdf-plugin-template\"}]},{\"text\":\"官方插件\",\"items\":[{\"text\":\"Elixir\",\"link\":\"https://github.com/asdf-vm/asdf-elixir\"},{\"text\":\"Erlang\",\"link\":\"https://github.com/asdf-vm/asdf-erlang\"},{\"text\":\"Node.js\",\"link\":\"https://github.com/asdf-vm/asdf-nodejs\"},{\"text\":\"Ruby\",\"link\":\"https://github.com/asdf-vm/asdf-ruby\"}]},{\"text\":\"社区插件\",\"items\":[{\"text\":\"asdf-community\",\"link\":\"https://github.com/asdf-community\"},{\"text\":\"GitHub 主题搜索\",\"link\":\"https://github.com/topics/asdf-plugin\"}]}]},{\"text\":\"问题\",\"collapsed\":true,\"items\":[{\"text\":\"经常问的问题\",\"link\":\"/zh-hans/more/faq\"},{\"text\":\"GitHub Issues\",\"link\":\"https://github.com/asdf-vm/asdf/issues\"},{\"text\":\"Stack Overflow Tag\",\"link\":\"https://stackoverflow.com/questions/tagged/asdf-vm\"}]},{\"text\":\"如何贡献\",\"collapsed\":true,\"items\":[{\"text\":\"核心\",\"link\":\"/zh-hans/contribute/core\"},{\"text\":\"文档\",\"link\":\"/zh-hans/contribute/documentation\"},{\"text\":\"官方插件\",\"link\":\"/zh-hans/contribute/first-party-plugins\"},{\"text\":\"GitHub Actions\",\"link\":\"/zh-hans/contribute/github-actions\"}]},{\"text\":\"社区项目\",\"link\":\"/zh-hans/more/community-projects\"},{\"text\":\"致谢\",\"link\":\"/zh-hans/more/thanks\"}]}}},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
</body>
</html>