silex/emacs repository overview

⁠Description

Run Emacs in docker containers!

Project page: https://github.com/Silex/docker-emacs⁠
Docker Hub: https://hub.docker.com/r/silex/emacs⁠

Wraps nix-emacs-ci⁠ in docker images.

⁠Images

⁠Tags

Full image list: https://github.com/Silex/docker-emacs#tags⁠

• master-debian, master⁠
• master-debian-ci, master-ci⁠
• master-debian-ci-cask, master-ci-cask, master-debian-cask, master-cask⁠
• master-debian-ci-eask, master-ci-eask, master-debian-eask, master-eask⁠
• master-debian-ci-eldev, master-ci-eldev, master-debian-eldev, master-eldev⁠
• master-debian-ci-keg, master-ci-keg, master-debian-keg, master-keg⁠
• master-alpine⁠
• master-alpine-ci⁠
• master-alpine-ci-cask, master-alpine-cask⁠
• master-alpine-ci-eask, master-alpine-eask⁠
• master-alpine-ci-eldev, master-alpine-eldev⁠
• master-alpine-ci-keg, master-alpine-keg⁠
• 31.1-debian, 31.1, 31-debian, 31, latest⁠
• 31.1-debian-ci, 31.1-ci, 31-debian-ci, 31-ci, ci⁠
• 31.1-debian-ci-cask, 31.1-ci-cask, 31-debian-ci-cask, 31-ci-cask, ci-cask, 31.1-debian-cask, 31.1-cask, 31-debian-cask, 31-cask, cask⁠
• 31.1-debian-ci-eask, 31.1-ci-eask, 31-debian-ci-eask, 31-ci-eask, ci-eask, 31.1-debian-eask, 31.1-eask, 31-debian-eask, 31-eask, eask⁠
• 31.1-debian-ci-eldev, 31.1-ci-eldev, 31-debian-ci-eldev, 31-ci-eldev, ci-eldev, 31.1-debian-eldev, 31.1-eldev, 31-debian-eldev, 31-eldev, eldev⁠
• 31.1-debian-ci-keg, 31.1-ci-keg, 31-debian-ci-keg, 31-ci-keg, ci-keg, 31.1-debian-keg, 31.1-keg, 31-debian-keg, 31-keg, keg⁠
• 31.1-alpine, 31-alpine, alpine⁠
• 31.1-alpine-ci, 31-alpine-ci, alpine-ci⁠
• 31.1-alpine-ci-cask, 31-alpine-ci-cask, alpine-ci-cask, 31.1-alpine-cask, 31-alpine-cask, alpine-cask⁠
• 31.1-alpine-ci-eask, 31-alpine-ci-eask, alpine-ci-eask, 31.1-alpine-eask, 31-alpine-eask, alpine-eask⁠
• 31.1-alpine-ci-eldev, 31-alpine-ci-eldev, alpine-ci-eldev, 31.1-alpine-eldev, 31-alpine-eldev, alpine-eldev⁠
• 31.1-alpine-ci-keg, 31-alpine-ci-keg, alpine-ci-keg, 31.1-alpine-keg, 31-alpine-keg, alpine-keg⁠
• 30.2-debian, 30.2, 30-debian, 30⁠
• 30.2-debian-ci, 30.2-ci, 30-debian-ci, 30-ci⁠
• 30.2-debian-ci-cask, 30.2-ci-cask, 30-debian-ci-cask, 30-ci-cask, 30.2-debian-cask, 30.2-cask, 30-debian-cask, 30-cask⁠
• 30.2-debian-ci-eask, 30.2-ci-eask, 30-debian-ci-eask, 30-ci-eask, 30.2-debian-eask, 30.2-eask, 30-debian-eask, 30-eask⁠
• 30.2-debian-ci-eldev, 30.2-ci-eldev, 30-debian-ci-eldev, 30-ci-eldev, 30.2-debian-eldev, 30.2-eldev, 30-debian-eldev, 30-eldev⁠
• 30.2-debian-ci-keg, 30.2-ci-keg, 30-debian-ci-keg, 30-ci-keg, 30.2-debian-keg, 30.2-keg, 30-debian-keg, 30-keg⁠
• 30.2-alpine, 30-alpine⁠
• 30.2-alpine-ci, 30-alpine-ci⁠
• 30.2-alpine-ci-cask, 30-alpine-ci-cask, 30.2-alpine-cask, 30-alpine-cask⁠
• 30.2-alpine-ci-eask, 30-alpine-ci-eask, 30.2-alpine-eask, 30-alpine-eask⁠
• 30.2-alpine-ci-eldev, 30-alpine-ci-eldev, 30.2-alpine-eldev, 30-alpine-eldev⁠
• 30.2-alpine-ci-keg, 30-alpine-ci-keg, 30.2-alpine-keg, 30-alpine-keg⁠
• 29.4-debian, 29.4, 29-debian, 29⁠
• 29.4-debian-ci, 29.4-ci, 29-debian-ci, 29-ci⁠
• 29.4-debian-ci-cask, 29.4-ci-cask, 29-debian-ci-cask, 29-ci-cask, 29.4-debian-cask, 29.4-cask, 29-debian-cask, 29-cask⁠
• 29.4-debian-ci-eask, 29.4-ci-eask, 29-debian-ci-eask, 29-ci-eask, 29.4-debian-eask, 29.4-eask, 29-debian-eask, 29-eask⁠
• 29.4-debian-ci-eldev, 29.4-ci-eldev, 29-debian-ci-eldev, 29-ci-eldev, 29.4-debian-eldev, 29.4-eldev, 29-debian-eldev, 29-eldev⁠
• 29.4-debian-ci-keg, 29.4-ci-keg, 29-debian-ci-keg, 29-ci-keg, 29.4-debian-keg, 29.4-keg, 29-debian-keg, 29-keg⁠
• 29.4-alpine, 29-alpine⁠
• 29.4-alpine-ci, 29-alpine-ci⁠
• 29.4-alpine-ci-cask, 29-alpine-ci-cask, 29.4-alpine-cask, 29-alpine-cask⁠
• 29.4-alpine-ci-eask, 29-alpine-ci-eask, 29.4-alpine-eask, 29-alpine-eask⁠
• 29.4-alpine-ci-eldev, 29-alpine-ci-eldev, 29.4-alpine-eldev, 29-alpine-eldev⁠
• 29.4-alpine-ci-keg, 29-alpine-ci-keg, 29.4-alpine-keg, 29-alpine-keg⁠
• 28.2-debian, 28.2, 28-debian, 28⁠
• 28.2-debian-ci, 28.2-ci, 28-debian-ci, 28-ci⁠
• 28.2-debian-ci-cask, 28.2-ci-cask, 28-debian-ci-cask, 28-ci-cask, 28.2-debian-cask, 28.2-cask, 28-debian-cask, 28-cask⁠
• 28.2-debian-ci-eask, 28.2-ci-eask, 28-debian-ci-eask, 28-ci-eask, 28.2-debian-eask, 28.2-eask, 28-debian-eask, 28-eask⁠
• 28.2-debian-ci-eldev, 28.2-ci-eldev, 28-debian-ci-eldev, 28-ci-eldev, 28.2-debian-eldev, 28.2-eldev, 28-debian-eldev, 28-eldev⁠
• 28.2-debian-ci-keg, 28.2-ci-keg, 28-debian-ci-keg, 28-ci-keg, 28.2-debian-keg, 28.2-keg, 28-debian-keg, 28-keg⁠
• 28.2-alpine, 28-alpine⁠
• 28.2-alpine-ci, 28-alpine-ci⁠
• 28.2-alpine-ci-cask, 28-alpine-ci-cask, 28.2-alpine-cask, 28-alpine-cask⁠
• 28.2-alpine-ci-eask, 28-alpine-ci-eask, 28.2-alpine-eask, 28-alpine-eask⁠
• 28.2-alpine-ci-eldev, 28-alpine-ci-eldev, 28.2-alpine-eldev, 28-alpine-eldev⁠
• 28.2-alpine-ci-keg, 28-alpine-ci-keg, 28.2-alpine-keg, 28-alpine-keg⁠
• 27.2-debian, 27.2, 27-debian, 27⁠
• 27.2-debian-ci, 27.2-ci, 27-debian-ci, 27-ci⁠
• 27.2-debian-ci-cask, 27.2-ci-cask, 27-debian-ci-cask, 27-ci-cask, 27.2-debian-cask, 27.2-cask, 27-debian-cask, 27-cask⁠
• 27.2-debian-ci-eask, 27.2-ci-eask, 27-debian-ci-eask, 27-ci-eask, 27.2-debian-eask, 27.2-eask, 27-debian-eask, 27-eask⁠
• 27.2-debian-ci-eldev, 27.2-ci-eldev, 27-debian-ci-eldev, 27-ci-eldev, 27.2-debian-eldev, 27.2-eldev, 27-debian-eldev, 27-eldev⁠
• 27.2-debian-ci-keg, 27.2-ci-keg, 27-debian-ci-keg, 27-ci-keg, 27.2-debian-keg, 27.2-keg, 27-debian-keg, 27-keg⁠
• 27.2-alpine, 27-alpine⁠
• 27.2-alpine-ci, 27-alpine-ci⁠
• 27.2-alpine-ci-cask, 27-alpine-ci-cask, 27.2-alpine-cask, 27-alpine-cask⁠
• 27.2-alpine-ci-eask, 27-alpine-ci-eask, 27.2-alpine-eask, 27-alpine-eask⁠
• 27.2-alpine-ci-eldev, 27-alpine-ci-eldev, 27.2-alpine-eldev, 27-alpine-eldev⁠
• 27.2-alpine-ci-keg, 27-alpine-ci-keg, 27.2-alpine-keg, 27-alpine-keg⁠
• 26.3-debian, 26.3, 26-debian, 26⁠
• 26.3-debian-ci, 26.3-ci, 26-debian-ci, 26-ci⁠
• 26.3-debian-ci-cask, 26.3-ci-cask, 26-debian-ci-cask, 26-ci-cask, 26.3-debian-cask, 26.3-cask, 26-debian-cask, 26-cask⁠
• 26.3-debian-ci-eask, 26.3-ci-eask, 26-debian-ci-eask, 26-ci-eask, 26.3-debian-eask, 26.3-eask, 26-debian-eask, 26-eask⁠
• 26.3-debian-ci-eldev, 26.3-ci-eldev, 26-debian-ci-eldev, 26-ci-eldev, 26.3-debian-eldev, 26.3-eldev, 26-debian-eldev, 26-eldev⁠
• 26.3-debian-ci-keg, 26.3-ci-keg, 26-debian-ci-keg, 26-ci-keg, 26.3-debian-keg, 26.3-keg, 26-debian-keg, 26-keg⁠
• 26.3-alpine, 26-alpine⁠
• 26.3-alpine-ci, 26-alpine-ci⁠
• 26.3-alpine-ci-cask, 26-alpine-ci-cask, 26.3-alpine-cask, 26-alpine-cask⁠
• 26.3-alpine-ci-eask, 26-alpine-ci-eask, 26.3-alpine-eask, 26-alpine-eask⁠
• 26.3-alpine-ci-eldev, 26-alpine-ci-eldev, 26.3-alpine-eldev, 26-alpine-eldev⁠
• 26.3-alpine-ci-keg, 26-alpine-ci-keg, 26.3-alpine-keg, 26-alpine-keg⁠
• 25.3-debian, 25.3, 25-debian, 25⁠
• 25.3-debian-ci, 25.3-ci, 25-debian-ci, 25-ci⁠
• 25.3-debian-ci-cask, 25.3-ci-cask, 25-debian-ci-cask, 25-ci-cask, 25.3-debian-cask, 25.3-cask, 25-debian-cask, 25-cask⁠
• 25.3-debian-ci-eldev, 25.3-ci-eldev, 25-debian-ci-eldev, 25-ci-eldev, 25.3-debian-eldev, 25.3-eldev, 25-debian-eldev, 25-eldev⁠
• 25.3-debian-ci-keg, 25.3-ci-keg, 25-debian-ci-keg, 25-ci-keg, 25.3-debian-keg, 25.3-keg, 25-debian-keg, 25-keg⁠
• 25.3-alpine, 25-alpine⁠
• 25.3-alpine-ci, 25-alpine-ci⁠
• 25.3-alpine-ci-cask, 25-alpine-ci-cask, 25.3-alpine-cask, 25-alpine-cask⁠
• 25.3-alpine-ci-eldev, 25-alpine-ci-eldev, 25.3-alpine-eldev, 25-alpine-eldev⁠
• 25.3-alpine-ci-keg, 25-alpine-ci-keg, 25.3-alpine-keg, 25-alpine-keg⁠
• 24.5-debian, 24.5, 24-debian, 24⁠
• 24.5-debian-ci, 24.5-ci, 24-debian-ci, 24-ci⁠
• 24.5-debian-ci-cask, 24.5-ci-cask, 24-debian-ci-cask, 24-ci-cask, 24.5-debian-cask, 24.5-cask, 24-debian-cask, 24-cask⁠
• 24.5-debian-ci-eldev, 24.5-ci-eldev, 24-debian-ci-eldev, 24-ci-eldev, 24.5-debian-eldev, 24.5-eldev, 24-debian-eldev, 24-eldev⁠
• 24.5-debian-ci-keg, 24.5-ci-keg, 24-debian-ci-keg, 24-ci-keg, 24.5-debian-keg, 24.5-keg, 24-debian-keg, 24-keg⁠
• 23.4-debian, 23.4, 23-debian, 23⁠
• 23.4-debian-ci, 23.4-ci, 23-debian-ci, 23-ci⁠

⁠Usage

docker run -it --rm silex/emacs

⁠Alternatives

• flycheck/emacs-cask⁠: collection of docker images containing a minimal Emacs compiled from source with Cask.
• flycheck/emacs-travis⁠: makefile which provides targets to install Emacs stable and emacs-snapshot, Texinfo and Cask.
• jgkamat/airy-docker-emacs⁠: alpine-based docker images that have Emacs installed through the package manager.
• JAremko/docker-emacs⁠: collection of docker images with focus on GUI usage.
• rejeep/evm⁠: pre-built Emacs binaries.

⁠Contributions

They are very welcome! The basic workflow is as follow:

• Modify images.yml.
• Modify templates/README.md and the Dockerfiles in the templates directory if needed.
• Run bin/images --generate to spread the changes everywhere.
• Build the images locally, for instance for Emacs 31.1:

bin/build --os debian --version 31.1 --subdirs ci,ci/cask,ci/eask,ci/eldev,ci/keg
bin/build --os alpine --version 31.1 --subdirs ci,ci/cask,ci/eask,ci/eldev,ci/keg

bin/build runs emacs --version on every image it builds, which is the real verification of a change: the build checks are skipped for pull requests from forks, because GitHub does not pass repository secrets to them and CI cannot reach the registry mirror.