haskell-devcontainer

This is a ready-to-use environment with GHC + Stackage + HLS.

Common Usage Patterns

Simple: GitHub Codespaces + prebuilt image

Suitable for teaching and testing. Works with just a browser. No Docker knowledge required.

Please refer to HaskellSpace.

Advanced: VS Code + prebuilt image

Can serve as the foundation for a project development environment. New team members can quickly get a consistent development environment.

Develop and test in an isolated environment without worrying about conflicts between internal and external dependencies. Even if AI makes a mistake, it won't delete your entire hard drive.

Please refer to here.

Advanced: VS Code + local-built image

Prefer to build your own image? Just review a few simple files and you can build it yourself.

Please refer to here.

Supported Platforms

amd64 and arm64.

Registries

The same images are available from two registries, under the same tags:

• GHCR: ghcr.io/lcamel/haskell-devcontainer
• Docker Hub: lcamel/haskell-devcontainer

docker pull ghcr.io/lcamel/haskell-devcontainer:latest
# or
docker pull lcamel/haskell-devcontainer:latest

GHCR is the primary registry; Docker Hub is a mirror and may lag shortly behind a fresh release.

Image Tags

• Floating tags
  • latest: Latest recommended version.
  • ghc-m.n.p: Latest version using a specific GHC, e.g. ghc-9.10.2
  • stackage-lts-m.n: Latest version using a specific Stackage snapshot, e.g. stackage-lts-24.11
• Fixed tags
  • {GHC}__{STACKAGE}__{HLS}__{TIMESTAMP}: Fixed version, never deleted, e.g. 9.10.2__lts-24.11__2.11.0.0__20251229-1435

For a detailed image list, see GHCR or Docker Hub.

Version Info

Inside the container, you can find the Stackage version at:

~/.haskell-devcontainer/stackage-version