2026.11.09 2026.11.09-trixie 2026.11.09-trixie-amd64 2026.11.09-trixie-arm64 2026.11.09-trixie-slim 2026.11.09-trixie-slim-amd64 2026.11.09-trixie-slim-arm64latest
2026.11.09miricl Home Page
https://github.com/ak-coram/miricl
Where to file Docker image related issues
https://gitlab.common-lisp.net/cl-docker-images/miricl
Where to file issues for miricl itself
https://github.com/ak-coram/miricl/issues
Maintained by
CL Docker Images
Project
Supported platforms
linux/amd64 and linux/arm64 for every tag
miricl, by Ákos Kiss, is Common Lisp on WebAssembly: an interpreter, a self-hosted native Wasm compiler and a whole-program optimizer, for browsers, Node.js and Wasmtime, with ASDF as an optional library.
miricl publishes no releases. A tag here is the date of the commit of
miricl's main branch that the image was built from; the image names that
commit in MIRICL_COMMIT.
\$ docker run -it --rm clfoundation/miricl:latest
:quit leaves it.
The miricl command reads forms on standard input; it takes no file
argument. Lisp sees the current directory as its /, so a script and
the files it loads are mounted and made the working directory:
\$ docker run -i --rm -v "\$PWD":/usr/src/app -w /usr/src/app clfoundation/miricl:latest < your-script.lisp
Three things differ from the other Common Lisp images:
/: the working
directory, or the one --directory names. With --directory /, or
when the working directory is /, that is the whole container.--bundle and --optimize write their output to disk.Error: and a backtrace, and the next form is read.ASDF is a separate file, /opt/miricl/miricl-asdf.wasm. Where Lisp sees
the whole container:
(load "/opt/miricl/miricl-asdf.wasm")
(asdf:load-asd #P"/usr/src/app/app.asd")
(asdf:load-system "app")
Where it sees one directory, link or copy the file into it first.
--bundle compiles an ASDF system and its dependencies into one
loadable file. It looks for miricl-asdf.wasm in the directory it
serves:
\$ docker run --rm -v "\$PWD":/usr/src/app -w /usr/src/app clfoundation/miricl:latest \
sh -c 'cp /opt/miricl/miricl-asdf.wasm . && miricl --bundle app --output dist/app.wasm'
A web page then needs three static files, from any web server:
miricl.js and miricl-precompiled.wasm (or the smaller miricl.wasm)
out of /opt/miricl, and the bundle. See
Usage in miricl's README for
the page's script.
The five files of miricl's distribution, built from source, in
/opt/miricl, with miricl's license:
miricl.js, the adapter for browsers and Nodemiricl.wasm, the interpreter and compilermiricl-precompiled.wasm, the same with the native compiler ready at
startupmiricl-repl.wasm, the terminal command for Wasmtimemiricl-asdf.wasm, ASDF and UIOPmiricl, on the PATH, runs miricl.js under Node with
miricl-precompiled.wasm, and passes its arguments on (miricl --help lists them). Set MIRICL_IMAGE to choose another image:
/opt/miricl/miricl.wasm evaluates with the interpreter.
clfoundation/miricl:<version>This is the defacto image. It is based on Node's full Debian image, which carries the common build tools.
clfoundation/miricl:<version>-slimThis image is based on Node's slim Debian image and carries only what is
needed to run miricl.
For information on building these images and contributing, please see the repository at https://gitlab.common-lisp.net/cl-docker-images/miricl.
miricl itself is licensed under the GNU Lesser General Public License,
version 3 or later; its text is in the image at /opt/miricl/LICENSE
and its source at the commit MIRICL_COMMIT names. The Dockerfiles and
build infrastructure are licensed under the BSD 2-Clause License. See
the LICENSE file in the repository for details.
Content type
Image
Digest
sha256:c1e766946…
Size
425.4 MB
Last updated
8 days ago
docker pull clfoundation/miricl