Initial commit

Author: kkrick-sdsu

.gitignore

@@ -0,0 +1,32 @@
+# Coder Images
+
+Container images for use with [Coder](https://github.com/coder/coder)
+
+## Jupyter Docker Stacks Images
+
+We repackage several of the [Jupyter Docker Stacks](https://github.com/jupyter/docker-stacks) images with necessary changes to work with Coder.
+
+### Manual Build Instructions
+
+Some images may need to be built locally due to container image size limitations in GitHub Actions.
+As of writing, this limitation is currently 10GB.
+
+In order to build the Jupyter Docker Stack-based images locally, we need to specify the build target of `notebook-image`, i.e.:
+
+```
+docker build . -f Dockerfile -t [your-dockerhub-username]/[image-name]:v[x.x] --target notebook-image
+```
+
+#### Local Testing
+
+In order to test these images locally, we need to include the second build stage `local-testing` which installs and runs coder in the container image.
+This includes a custom script for use as the container's entrypoint `run-coder.sh`.
+The manual configuration in the `local-testing` target is typically handled by Coder via template, so as to install the latest version at runtime as opposed to manually installing a version at build time.
+
+*Note*: The `local-testing` targets should **NOT** be used with Coder due to the increased container image size and potentially conflicting installations of coder.
+
+Due to the location of `run-coder.sh`, Jupyter images should be built from the root of the repository, for example:
+
+```
+docker build . -f /image/jupyter/minimal/Dockerfile -t [your-dockerhub-username]/coder-minimal-notebook:v[x.x] --target local-testing
+```

README.md

@@ -0,0 +1,69 @@
+ARG BASE_IMAGE=quay.io/jupyter/minimal-notebook:2025-07-07
+
+FROM ${BASE_IMAGE} AS notebook-image
+
+USER root
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    bash \
+    ca-certificates \
+    curl \
+    git \
+    jq \
+    locales \
+    sudo \
+    rclone \
+    && rm -rf /var/lib/apt/lists/*
+
+# Generate the desired locale (en_US.UTF-8)
+RUN locale-gen en_US.UTF-8
+
+# Make typing unicode characters in the terminal work.
+ENV LANG=en_US.UTF-8
+ENV LANGUAGE=en_US.UTF-8
+ENV LC_ALL=en_US.UTF-8
+
+# Remove the `jovyan` user and add a user `coder` so that you're not developing as the `root` user
+RUN userdel -r ${NB_USER} \
+ && useradd coder \
+    --create-home \
+    --shell=/bin/bash \
+    --uid=1000 \
+    --user-group \
+ && echo "coder ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers.d/nopasswd \
+ && chown -R coder:coder /home/coder
+
+# Switch to coder user, override env vars from Jupyter base image
+USER coder
+WORKDIR /home/coder
+ENV HOME=/home/coder
+ENV NB_USER=coder
+
+FROM notebook-image AS local-testing
+
+USER root
+WORKDIR /root
+
+# Fix permissions for coder home directory
+RUN chown -R coder:coder /home/coder
+
+# Add directory for coder install for local testing in Docker; transer owner to coder user & group
+RUN mkdir -p /opt/code-server \
+ && chown -R coder:coder /opt/code-server
+
+USER coder
+WORKDIR /home/coder
+
+# Install coder/code-server for local testing in Docker -- coder will install its own version at runtime
+RUN curl -fsSL https://code-server.dev/install.sh | sh -s -- --method=standalone --prefix=/opt/code-server
+
+# Override entrypoint and healthcheck from Jupyter base image for local testing in Docker
+COPY run-coder.sh /opt/run-coder.sh
+ENTRYPOINT [ "sh", "/opt/run-coder.sh" ]
+HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=5 \
+  CMD curl -fsS http://0.0.0.0:13337/healthz || exit 1
+
+# Expose coder port for local testing in Docker
+EXPOSE 13337
+

images/jupyter/minimal/Dockerfile

@@ -0,0 +1,4 @@
+#!/bin/env bash
+
+/opt/code-server/bin/code-server --auth none --port 13337 --bind-addr 0.0.0.0 > /tmp/code-server.log 2>&1
+