Skip to content

install.md

Latest commit

 

History

History
81 lines (54 loc) · 3.22 KB

install.md

File metadata and controls

81 lines (54 loc) · 3.22 KB

Install Stack

Scripted Install for CI/Test on a VM

This script captures the install/setup of stack and its prerequisites on a fresh Ubuntu 24 VM.

WARNING: always review scripts prior to running them so that you know what is happening on your machine.

User Install

For any other installation, follow along below and adapt these instructions based on the specifics of your system.

Ensure that the following are already installed:

  • Python3: python3 --version >= 3.12 (the Python3 shipped in Ubuntu 24.04 is good to go)
  • Docker: docker --version >= 20.10.21 or podman podman --version >= 3.4.4
  • jq: jq --version >= 1.5
  • git: git --version >= 2.10.3

Note: if installing docker-compose via package manager on Linux (as opposed to Docker Desktop), you must install the plugin, e.g. :

mkdir -p ~/.docker/cli-plugins
curl -SL https://github.com/docker/compose/releases/download/v2.11.2/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
chmod +x ~/.docker/cli-plugins/docker-compose

Install with uv (recommended)

If you have uv installed, you can install stack directly from the git repository:

uv tool install --from git+https://github.com/bozemanpass/stack stack

This installs stack into an isolated environment and adds it to your PATH. To update to the latest version:

uv tool upgrade stack

Install from a downloaded release

Decide on a directory where you would like to put the stack program. Typically, this would be a "user" binary directory such as ~/bin or perhaps /usr/local/bin/stack or possibly just the current working directory.

Now, having selected that directory, download the latest release from this page into it (we're using ~/bin below for concreteness but edit to suit if you selected a different directory). Also be sure that the destination directory exists and is writable:

curl -L -o ~/bin/stack https://github.com/bozemanpass/stack/releases/latest/download/stack

Give it execute permissions:

chmod +x ~/bin/stack

Ensure stack is on the PATH

Verify operation (your version will probably be different, just check here that you see some version output and not an error):

stack version
Version: 2.0.0-fb86d3c-202503251632

Update

If stack was installed using the process above, it is able to self-update to the current latest version by running:

stack update

Alternate Update Locations (e.g., a fork)

If you want to update from a different location (e.g., a fork), you can do so setting the distribution URL to use:

Save the alternate distribution URL in ~/.config/stack/config.yml:

stack config set distribution-url https://github.com/example-org/my-stack-fork/releases/latest/download/stack