This is the repository for the official Docker image for Clojure. It is automatically pulled and built by Stackbrew into the Docker registry. This image runs on OpenJDK 8 and includes Leiningen or boot (see below for tags and building instructions).
The version tags on these images look like lein-N.N.N(-alpine) and boot-N.N.N(-alpine). These refer to which version of leiningen or boot is packaged in the image (because they can then install and use any version of Clojure at runtime). The default latest (or lein, lein-alpine) images will always have a recent version of leiningen installed. If you want boot, specify either clojure:boot, clojure:boot-alpine, or clojure:boot-N.N.N / clojure:boot-N.N.N-alpine (where N.N.N is the version of boot you want installed).
In an effort to minimize the size of Docker images, the Docker community is migrating from traditional Linux distributions (like Debian) to the Alpine Linux distribution. It is a very minimal distribution specifically designed for container applications.
The traditional Debian-based Clojure images are still provided under the original tags, but you are encouraged to try running your applications in the new alpine variants. Since Clojure runs on the JVM anyway, chances are everything will just work and you'll save yourself some time and bandwidth.
Run an interactive shell from this image.
docker run -i -t clojure /bin/bash
Then within the shell, create a new Leiningen project and start a Clojure REPL.
lein new hello-world
cd hello-world
lein repl
This image makes building derivative images easier. For most use cases, creating a Dockerfile in the base of your project directory with the line FROM clojure:onbuild will be enough to create a stand-alone image for your project.
These images are based on the minimalist Alpine Linux distribution and are much smaller than the default (Debian-based) images. If your app can run in them, they will be much faster to transfer and take up much less space.
docker build -t clojure:onbuild debian/lein/onbuild
FROM clojure:onbuild
CMD ["lein", "run"]
Put this file in the root of your app.
This image includes multiple ONBUILD triggers which should be all you need to bootstrap most applications. The build will COPY . /usr/src/app and RUN lein deps
You can then build and run the CLojure image:
docker build -t my-clojure-app .
docker run -it --rm --name running-clojure-app my-clojure-app
NOTE: The onbuild image is designed to get you up and running quickly in a development environment. You probably do not want to deploy your applications to production servers using the onbuild image. Compiling an uberjar and running it via java -jar or using lein run trampoline would be much more memory-efficient.
ClojureScript Development with Figwheel
Run Figwheel to automatically load your ClojureScript changes into your running browser window.
docker run --rm -it \
-w /w -v "$PWD":/w \
-v "$HOME"/.m2:/root/.m2 \
-p 3449:3449 \
clojure \
lein figwheel
Notes:
- Mounts $HOME/.m2 for caching Maven jars.
- Exposes port 3449 (the default port for Figwheel) so the client code running in your browser can connect to it.
- If you're using a virtual machine, be sure to set Figwheel's
:websocket-urloption in your project.clj to something that makes sense (e.g.,ws://192.168.99.100:3449/figwheel-ws).
Except for the onbuild variants, the Dockerfiles are generated from the Dockerfile-lein.template and Dockerfile-boot.template files by the update.sh script.
If you want to modify them (for example, to build in a different version of lein or boot), edit the template(s) and then run ./update.sh. Then the example docker build ... commands below will do what you want.
Note that the update.sh script requires bash version 4+ to run.
docker build -t clojure:lein-2.7.1 debian/lein
docker build -t clojure:boot-2.7.1 debian/boot
docker build -t clojure:lein-2.7.1-alpine alpine/lein
docker build -t clojure:boot-2.7.1-alpine alpine/boot