<scriptsrc="/js/carbon.js"async></script><titledata-rh="true">Installation | Task</title><metadata-rh="true"name="twitter:card"content="summary_large_image"><metadata-rh="true"property="og:url"content="https://taskfile.dev/installation/"><metadata-rh="true"name="docusaurus_locale"content="en"><metadata-rh="true"name="docsearch:language"content="en"><metadata-rh="true"name="og:image"content="https://taskfile.dev/img/og-image.png"><metadata-rh="true"name="docusaurus_version"content="current"><metadata-rh="true"name="docusaurus_tag"content="docs-default-current"><metadata-rh="true"name="docsearch:version"content="current"><metadata-rh="true"name="docsearch:docusaurus_tag"content="docs-default-current"><metadata-rh="true"property="og:title"content="Installation | Task"><metadata-rh="true"name="description"content="Task offers many installation methods. Check out the available methods below."><metadata-rh="true"property="og:description"content="Task offers many installation methods. Check out the available methods below."><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://taskfile.dev/installation/"><linkdata-rh="true"rel="alternate"href="https://taskfile.dev/installation/"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://taskfile.dev/installation/"hreflang="x-default"><linkdata-rh="true"rel="preconnect"href="https://7IZIJ13AI7-dsn.algolia.net"crossorigin="anonymous"><linkrel="stylesheet"href="/assets/css/styles.a21cea15.css">
Task is as simple as running:</p><divclass="language-bash codeBlockContainer_MPoW theme-code-block"style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><divclass="codeBlockContent_B9tL"><pretabindex="0"class="prism-code language-bash codeBlock__0OG thin-scrollbar"><codeclass="codeBlockLines_gEuF"><spanclass="token-line"style="color:#393A34"><spanclass="token plain">brew </span><spanclass="token function"style="color:#d73a49">install</span><spanclass="token plain"> go-task/tap/go-task</span><br></span></code></pre><divclass="buttonGroup_hRr1"><buttontype="button"aria-label="Copy code to clipboard"title="Copy"class="clean-btn"><spanclass="copyButtonIcons_W9eQ"aria-hidden="true"><svgclass="copyButtonIcon_XEyF"viewBox="0 0 24 24"><pathd="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svgclass="copyButtonSuccessIcon_i9w9"viewBox="0 0 24 24"><pathd="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h3class="anchor anchorWithStickyNavbar_mojV"id="snap">Snap<aclass="hash-link"href="#snap"title="Direct link to heading"></a></h3><p>Task is available in <ahref="https://snapcraft.io/task"target="_blank"rel="noopener noreferrer">Snapcraft</a>, but keep in mind that your
Task is as simple as running:</p><divclass="language-bash codeBlockContainer_MPoW theme-code-block"style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><divclass="codeBlockContent_B9tL"><pretabindex="0"class="prism-code language-bash codeBlock__0OG thin-scrollbar"><codeclass="codeBlockLines_gEuF"><spanclass="token-line"style="color:#393A34"><spanclass="token plain">choco </span><spanclass="token function"style="color:#d73a49">install</span><spanclass="token plain"> go-task</span><br></span></code></pre><divclass="buttonGroup_hRr1"><buttontype="button"aria-label="Copy code to clipboard"title="Copy"class="clean-btn"><spanclass="copyButtonIcons_W9eQ"aria-hidden="true"><svgclass="copyButtonIcon_XEyF"viewBox="0 0 24 24"><pathd="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svgclass="copyButtonSuccessIcon_i9w9"viewBox="0 0 24 24"><pathd="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>This installation method is community owned.</p><h3class="anchor anchorWithStickyNavbar_mojV"id="scoop">Scoop<aclass="hash-link"href="#scoop"title="Direct link to heading"></a></h3><p>If you're on Windows and have <ahref="https://scoop.sh/"target="_blank"rel="noopener noreferrer">Scoop</a> installed, getting
Task is as simple as running:</p><divclass="language-cmd codeBlockContainer_MPoW theme-code-block"style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><divclass="codeBlockContent_B9tL"><pretabindex="0"class="prism-code language-cmd codeBlock__0OG thin-scrollbar"><codeclass="codeBlockLines_gEuF"><spanclass="token-line"style="color:#393A34"><spanclass="token plain">scoop install task</span><br></span></code></pre><divclass="buttonGroup_hRr1"><buttontype="button"aria-label="Copy code to clipboard"title="Copy"class="clean-btn"><spanclass="copyButtonIcons_W9eQ"aria-hidden="true"><svgclass="copyButtonIcon_XEyF"viewBox="0 0 24 24"><pathd="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svgclass="copyButtonSuccessIcon_i9w9"viewBox="0 0 24 24"><pathd="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>This installation method is community owned. After a new release of Task, it
may take some time until it's available on Scoop.</p><h3class="anchor anchorWithStickyNavbar_mojV"id="aur">AUR<aclass="hash-link"href="#aur"title="Direct link to heading"></a></h3><p>If you're on Arch Linux you can install Task from
the package, it's always latest available version based on the Git repository.</p><h3class="anchor anchorWithStickyNavbar_mojV"id="fedora">Fedora<aclass="hash-link"href="#fedora"title="Direct link to heading"></a></h3><p>If you're on Fedora Linux you can install Task from the official
may take some time until it's available in <ahref="https://packages.fedoraproject.org/pkgs/golang-github-task/go-task/"target="_blank"rel="noopener noreferrer">Fedora</a>.</p><h3class="anchor anchorWithStickyNavbar_mojV"id="nix">Nix<aclass="hash-link"href="#nix"title="Direct link to heading"></a></h3><p>If you're on NixOS or have Nix installed
you can install Task from <ahref="https://github.com/NixOS/nixpkgs"target="_blank"rel="noopener noreferrer">nixpkgs</a>:</p><divclass="language-cmd codeBlockContainer_MPoW theme-code-block"style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><divclass="codeBlockContent_B9tL"><pretabindex="0"class="prism-code language-cmd codeBlock__0OG thin-scrollbar"><codeclass="codeBlockLines_gEuF"><spanclass="token-line"style="color:#393A34"><spanclass="token plain">nix-env -iA nixpkgs.go-task</span><br></span></code></pre><divclass="buttonGroup_hRr1"><buttontype="button"aria-label="Copy code to clipboard"title="Copy"class="clean-btn"><spanclass="copyButtonIcons_W9eQ"aria-hidden="true"><svgclass="copyButtonIcon_XEyF"viewBox="0 0 24 24"><pathd="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svgclass="copyButtonSuccessIcon_i9w9"viewBox="0 0 24 24"><pathd="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>This installation method is community owned. After a new release of Task, it
may take some time until it's available in <ahref="https://github.com/NixOS/nixpkgs"target="_blank"rel="noopener noreferrer">nixpkgs</a>.</p><h2class="anchor anchorWithStickyNavbar_mojV"id="get-the-binary">Get The Binary<aclass="hash-link"href="#get-the-binary"title="Direct link to heading"></a></h2><h3class="anchor anchorWithStickyNavbar_mojV"id="binary">Binary<aclass="hash-link"href="#binary"title="Direct link to heading"></a></h3><p>You can download the binary from the <ahref="https://github.com/go-task/task/releases"target="_blank"rel="noopener noreferrer">releases page on GitHub</a> and
add to your <code>$PATH</code>.</p><p>DEB and RPM packages are also available.</p><p>The <code>task_checksums.txt</code> file contains the SHA-256 checksum for each file.</p><h3class="anchor anchorWithStickyNavbar_mojV"id="install-script">Install Script<aclass="hash-link"href="#install-script"title="Direct link to heading"></a></h3><p>We also have an <ahref="https://github.com/go-task/task/blob/master/install-task.sh"target="_blank"rel="noopener noreferrer">install script</a> which is very useful in
scenarios like CI. Many thanks to <ahref="https://github.com/goreleaser/godownloader"target="_blank"rel="noopener noreferrer">GoDownloader</a> for enabling the
easy generation of this script.</p><p>By default, it installs on the <code>./bin</code> directory relative to the working
directory:</p><divclass="language-bash codeBlockContainer_MPoW theme-code-block"style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><divclass="codeBlockContent_B9tL"><pretabindex="0"class="prism-code language-bash codeBlock__0OG thin-scrollbar"><codeclass="codeBlockLines_gEuF"><spanclass="token-line"style="color:#393A34"><spanclass="token function"style="color:#d73a49">sh</span><spanclass="token plain"> -c </span><spanclass="token string"style="color:#e3116c">"</span><spanclass="token string variable"style="color:#36acaa">$(</span><spanclass="token string variable function"style="color:#d73a49">curl</span><spanclass="token string variable"style="color:#36acaa"> --location https://taskfile.dev/install.sh</span><spanclass="token string variable"style="color:#36acaa">)</span><spanclass="token string"style="color:#e3116c">"</span><spanclass="token plain"> -- -d</span><br></span></code></pre><divclass="buttonGroup_hRr1"><buttontype="button"aria-label="Copy code to clipboard"title="Copy"class="clean-btn"><spanclass="copyButtonIcons_W9eQ"aria-hidden="true"><svgclass="copyButtonIcon_XEyF"viewBox="0 0 24 24"><pathd="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svgclass="copyButtonSuccessIcon_i9w9"viewBox="0 0 24 24"><pathd="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>It is possible to override the installation directory with the <code>-b</code> parameter.
On Linux, common choices are <code>~/.local/bin</code> and <code>~/bin</code> to install for the
current user or <code>/usr/local/bin</code> to install for all users:</p><divclass="language-bash codeBlockContainer_MPoW theme-code-block"style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><divclass="codeBlockContent_B9tL"><pretabindex="0"class="prism-code language-bash codeBlock__0OG thin-scrollbar"><codeclass="codeBlockLines_gEuF"><spanclass="token-line"style="color:#393A34"><spanclass="token function"style="color:#d73a49">sh</span><spanclass="token plain"> -c </span><spanclass="token string"style="color:#e3116c">"</span><spanclass="token string variable"style="color:#36acaa">$(</span><spanclass="token string variable function"style="color:#d73a49">curl</span><spanclass="token string variable"style="color:#36acaa"> --location https://taskfile.dev/install.sh</span><spanclass="token string variable"style="color:#36acaa">)</span><spanclass="token string"style="color:#e3116c">"</span><spanclass="token plain"> -- -d -b ~/.local/bin</span><br></span></code></pre><divclass="buttonGroup_hRr1"><buttontype="button"aria-label="Copy code to clipboard"title="Copy"class="clean-btn"><spanclass="copyButtonIcons_W9eQ"aria-hidden="true"><svgclass="copyButtonIcon_XEyF"viewBox="0 0 24 24"><pathd="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svgclass="copyButtonSuccessIcon_i9w9"viewBox="0 0 24 24"><pathd="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><divclass="admonition admonition-caution alert alert--warning"><divclass="admonition-heading"><h5><spanclass="admonition-icon"><svgxmlns="http://www.w3.org/2000/svg"width="16"height="16"viewBox="0 0 16 16"><pathfill-rule="evenodd"d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>caution</h5></div><divclass="admonition-content"><p>On macOS and Windows, <code>~/.local/bin</code> and <code>~/bin</code> are not added to <code>$PATH</code> by
default.</p></div></div><h3class="anchor anchorWithStickyNavbar_mojV"id="github-actions">GitHub Actions<aclass="hash-link"href="#github-actions"title="Direct link to heading"></a></h3><p>If you want to install Task in GitHub Actions you can try using
