This repository provides Docker images with GHC compiled with musl;
therefore can be used to create fully static Haskell binaries without
glibc dependency on any platform which can run Docker (x86_64). Powered
by ghcup.
Images come with ghc and cabal executables alongside with commonly
used libraries and build tools. They can also be used with the stack
build tool using its Docker integration.
Here are the latest images currently published in Docker Hub:
- utdemir/ghc-musl:v25-ghc944
- utdemir/ghc-musl:v25-ghc925
- utdemir/ghc-musl:v25-ghc902
- utdemir/ghc-musl:v25-ghc8107
- utdemir/ghc-musl:v25-ghc884
Mount the project directory to the container, and use cabal-install
with --enable-executable-static flag inside the container:
$ cd myproject/
$ docker run -itv $PWD:/mnt utdemir/ghc-musl:v25-ghc944
sh$ cd /mnt
sh$ cabal new-update
sh$ cabal new-build --enable-executable-static
You can also set executable-static option on your cabal.project file.
Use below arguments, or set the relevant options on your stack.yaml:
stack build \
--ghc-options ' -static -optl-static -optl-pthread -fPIC' \
--docker --docker-image "utdemir/ghc-musl:v25-ghc944" \
--no-nix
Make sure to pick an image with the GHC version compatible with the Stackage resolver you are using.
Follow commercialhaskell/stack#3420 for more details on static compilation using the Stack build tool.
Below shell session shows how to start a pre-compiled docker container
and compile a simple Hello.hs as a static executable:
$ docker run -itv $PWD:/mnt utdemir/ghc-musl:v25-ghc944
bash-4.4# cd /mnt/
bash-4.4# cat Hello.hs
main = putStrLn "Hello"
bash-4.4# ghc --make -optl-static -optl-pthread Hello.hs
[1 of 1] Compiling Main ( Hello.hs, Hello.o )
Linking Hello ...
bash-4.4# ls -al Hello
-rwxr-xr-x 1 root root 1185056 Aug 11 16:55 Hello
bash-4.4# file Hello
Hello: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), statically linked, with debug_info, not stripped
bash-4.4# ldd ./Hello
ldd: ./Hello: Not a valid dynamic program
The result can be executed on different Linux systems:
$ docker run -itv $PWD:/mnt alpine
# /mnt/Hello
Hello
$ docker run -itv $PWD:/mnt centos
[root@94eb29dcdfe6 /]# /mnt/Hello
Hello
Feel free to open an issue or send a PR to add a library or support a newer compiler version.
The build process is orchestrated using Earthly. Once it is installed (or obtained via "nix-shell -p earthly"), you can use below command to build and test all images:
earthly --allow-privileged +all
Note: --allow-privileged is only necessary because we use Docker-in-Docker
project to test if the generated images work with stack's Docker support.
You can use the following command to disable Stack tests so that
--allow-privileged is not necessary:
earthly --build-arg TEST_STACK=0 +all
The following command updates README.md:
earthly --artifact +readme/README.md
- Multi-arch: https://github.com/benz0li/ghc-musl
os/arch's:linux/amd64,linux/arm64/v8- Built using Hadrian, from source, without docs
- https://gitlab.com/neosimsim/docker-builder-images
- Using Nix: https://github.com/nh2/static-haskell-nix
- Not maintained: https://github.com/fpco/docker-static-haskell