Skip to content

Commit 20f3822

Browse files
committed
Update install documentation
1 parent a6f0429 commit 20f3822

File tree

1 file changed

+65
-22
lines changed

1 file changed

+65
-22
lines changed

doc/install_and_upgrade.md

Lines changed: 65 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -118,50 +118,94 @@ GitHub repository.
118118
sudo apt-get install g++ gcc libc6-dev libffi-dev libgmp-dev make xz-utils zlib1g-dev git gnupg netbase
119119
~~~
120120

121+
=== "AArch64"
122+
123+
* Click
124+
[:material-cloud-download-outline:](https://get.haskellstack.org/stable/linux-aarch64.tar.gz)
125+
to download an archive file with the latest release.
126+
127+
* Extract the archive and place the `stack` executable somewhere on your
128+
PATH (see the [Path](#path) section below).
129+
130+
* Ensure you have the required system dependencies installed. These
131+
include GCC, GNU Make, xz, perl, libgmp, libffi, and zlib. We also
132+
recommend Git and GPG.
133+
134+
The installation of system dependencies will depend on the package
135+
manager for your Linux distribution. Notes are provided for Arch Linux,
136+
CentOS, Debian, Fedora, Gentoo and Ubuntu.
137+
138+
=== "Arch Linux"
139+
140+
~~~text
141+
sudo pacman -S make gcc ncurses git gnupg xz zlib gmp libffi zlib
142+
~~~
143+
144+
=== "CentOS"
145+
146+
~~~text
147+
sudo yum install perl make automake gcc gmp-devel libffi zlib zlib-devel xz tar git gnupg
148+
~~~
149+
150+
=== "Debian"
151+
152+
~~~text
153+
sudo apt-get install g++ gcc libc6-dev libffi-dev libgmp-dev make xz-utils zlib1g-dev git gnupg netbase
154+
~~~
155+
156+
=== "Fedora"
157+
158+
~~~text
159+
sudo dnf install perl make automake gcc gmp-devel libffi zlib zlib-devel xz tar git gnupg
160+
~~~
161+
162+
=== "Gentoo"
163+
164+
Ensure you have the `ncurses` package with `USE=tinfo`. Without it,
165+
Stack will not be able to install GHC.
166+
167+
=== "Ubuntu"
168+
169+
~~~text
170+
sudo apt-get install g++ gcc libc6-dev libffi-dev libgmp-dev make xz-utils zlib1g-dev git gnupg netbase
171+
~~~
172+
121173
### Linux packages
122174

123175
Some Linux distributions have official or unofficial packages for Stack,
124176
including Arch Linux, Debian, Fedora, NixOS, openSUSE/SUSE Linux Enterprise,
125-
and Ubuntu.
177+
and Ubuntu. However, the Stack version available as a Linux package may lag
178+
behind Stack's current version and, in some cases, the lag may be
179+
significant.
126180

127181
!!! info "Linux packages that lag behind Stack's current version"
128182

129-
The Stack version available as a Linux package may lag behind Stack's
130-
current version. If so, using `stack upgrade --binary-only` is
131-
recommended after installing it. For Stack versions before 1.3.0 which
132-
do not support `--binary-only`, just `stack upgrade` may work too.
183+
If Stack version available as a Linux package lags behind Stack's
184+
current version, using `stack upgrade --binary-only` is recommended
185+
after installing it.
133186

134187
=== "Arch Linux"
135188

136-
The Arch extra package repository provides an official
189+
The Arch extra package repository provides an official x86_64
137190
[package](https://www.archlinux.org/packages/extra/x86_64/stack/).
138191
You can install it with the command:
139192

140193
~~~text
141194
sudo pacman -S stack
142195
~~~
143196

144-
This version may slightly lag behind, but it should be updated within
145-
the day. The package is also always rebuilt and updated when one of its
146-
dependencies gets an update.
197+
The Arch User Repository (AUR) also provides:
147198

148-
The Arch User Repository (AUR) also provides a
149-
[package](https://aur.archlinux.org/packages/haskell-stack-git).
150-
However, its Stack version lags behind, so running
151-
`stack upgrade --binary-only` is recommended after installing it. For
152-
older Stack versions which do not support `--binary-only`, just
153-
`stack upgrade` may work too.
199+
* a [`stack-bin` package](https://aur.archlinux.org/packages/stack-bin);
200+
and
154201

155-
To use `stack setup` with versions of GHC before 7.10.3 or on a
156-
32-bit system, you may need the AUR
157-
[ncurses5-compat-libs](https://aur.archlinux.org/packages/ncurses5-compat-libs/)
158-
package installed.
202+
* a [`stack-static` package](https://aur.archlinux.org/packages/stack-static)
159203

160204
=== "Debian"
161205

162206
There are Debian
163207
[packages](https://packages.debian.org/search?keywords=haskell-stack&searchon=names&suite=all&section=all)
164-
for Stretch and up. However, the distribution's Stack version lags
208+
for Buster and up. However, the distribution's Stack version lags
165209
behind.
166210

167211
=== "Fedora"
@@ -234,8 +278,7 @@ GitHub repository.
234278

235279
There are Ubuntu
236280
[packages](http://packages.ubuntu.com/search?keywords=haskell-stack&searchon=names&suite=all&section=all)
237-
for Ubuntu 18.04 and up. However, the distribution's Stack version lags
238-
behind.
281+
for Ubuntu 20.04 and up.
239282

240283
It is possible to set up auto-completion of Stack commands. For further
241284
information, see the [shell auto-completion](shell_autocompletion.md)

0 commit comments

Comments
 (0)