The stack setup
command¶
stack setup [GHC_VERSION] [--[no-]reinstall] [--ghc-bindist URL]
[--ghcjs-boot-options GHCJS_BOOT] [--[no-]ghcjs-boot-clean]
stack setup
attempts to install a version of GHC.
By default:
-
the version of GHC is the one required by the project. Specify the version of GHC as an argument to attempt to install a different version of GHC. For example
stack setup 9.4.4
will attempt to install GHC 9.4.4; and -
an attempt to install is made only if the version of GHC is not already available to Stack. Pass the flag
--reinstall
(disabled by default) to attempt to install the version of GHC regardless of whether it is already available to Stack.
Pass the option --ghc-bindist <url>
to specify the URL of the GHC to be
downloaded and installed. This option requires the use of the --ghc-variant
option specifying a custom GHC variant. For further information about the
--ghc-variant
option, see the see the
YAML configuration documentation.
If Stack is configured not to install GHC (install-ghc: false
or passing the
--no-install-ghc
flag) then stack setup
will warn that the flag and the
command are inconsistent and take no action.
A particular binary distribution of GHC will depend on certain libraries, which need to be available.
There are many different Linux distributions and different versions of a particular Linux distribution. One Linux distribution/version may make available different libraries to another Linux distribution/version.
In attempting to identify the particular binary distribution of GHC that is required on Linux, Stack will refer to the presence or absence of certain libraries or the versions of those libraries.
For example, Stack 2.15.1 considers:
-
If
libc.musl-x86_64.so.1
is present. This file is provided by the musl libc. -
The version of
libc6
(if musl libc is not applicable), the GNU C Library (glibc), that is present. The GNU C Library is designed to be backwards compatible. -
If
libgmp.so.3
orlibgmp.so.10
is present. These files are provided by different versions of the GNU Multiple Precision Arithmetic Library. -
If
libncursesw.so.6
is present. This file is provided by a shared library for terminal handling with wide character support. -
If
libtinfo.so.5
orlibtinfo.so.6
is present. These files are provided by different versions of a shared low-level terminfo library for terminal handling.
Stack 2.15.1 uses ghc-build
:
musl
to indicatelibc.musl-x86_64.so.1
is present and Stack should use the GHC binary distribution for Alpine Linux.tinfo6
to indicatelibgmp.so.10
andlibtinfo.so.6
are present andlibc6
is compatible withlibc6
2.32.tinfo6-libc6-pre232
to indicatelibgmp.so.10
andlibtinfo.so.6
are present andlibc6
is not compatible withlibc6
2.32.ncurses6
to indicatelibgmp.so.10
andlibncursesw.so.6
are presentgmp4
to indicatelibgmp.so.3
is present
By default, Stack associates:
-
the
tinfo6
build with the 'Fedora 33' binary distribution of GHC 9.4.1 to 9.4.4. Those binary distributions require versions oflibc6
that are compatible withlibc6
2.32; and -
the
tinfo6-libc6-pre232
build with the 'Debian 10' binary distribution of GHC 9.4.1 to 9.4.4. Those binary distributions require versions oflibc6
that are compatible withlibc6
2.28.