Kernel Templates for AdaLab

Starter Containerfiles for building custom Jupyter kernel images compatible with AdaLab.

Available templates

File	Language	Base image
Containerfile.python312	Python 3.12	python:3.12-slim
Containerfile.python314	Python 3.14	python:3.14-slim
Containerfile.r	R 4.4	rocker/r-ver:4.4

Each file is a minimal, working kernel image. Open it, add your packages where indicated by the comments, build with podman, and publish through the AdaLab UI.

Quick start

# copy a template
cp Containerfile.python312 Containerfile

# add your packages, then build
podman build -f Containerfile -t my-kernel:v1.0 .

# test
podman run --rm -it my-kernel:v1.0 bash
python3 -c "import ipykernel; print('ok')"

Rules for AdaLab kernels

• Do not add USER, useradd, or chown instructions
• CMD must launch the kernel process, not JupyterLab
• Use one ENV statement per variable
• Always install ipykernel (Python) or IRkernel (R)

See the comments inside each Containerfile for details.

License

MIT