readme.md

.NET Interactive Docker image

This folder contains a Dockerfile that generates an image with the latest .NET Interactive and Jupyter. This lets you try out .NET Interactive's Jupyter experience without needing to install Jupyter directly.

Build instructions

You can build the Docker image by running the following command in this directory:

> docker build . --tag dotnet-interactive:1.0

The container exposes port 8888 and the port range 1100-1200. A different port range can be specified at build time.

Port 8888 is used by Jupyter and it is where the web application runs, the range is used by dotnet interactive to expose functionalities to the frontend directly.

> docker build . --tag dotnet-interactive:1.0 --build-arg HTTP_PORT_RANGE=1000-1100

Run the container

To run it execute the following command:

> docker run --rm -it -p 8888:8888 -p 1000-1200:1000-1200  --name dotnet-interactive-image dotnet-interactive:1.0

Remember to match the port range with the range used when building the image.

A JupyterLab instance will be published on http://127.0.0.1:8888/. Check the output of the docker run command for the full URL which includes the Jupyter authentication token.

Persistent storage and local notebooks

Local folder can be mounted using the -v option, follow the instruction to expose your host drive to Docker.

On Windows the following command will mount a local folder into the running image at the /notebooks mountpoint

docker run --rm -it -p 8888:8888 -p 1000-1200:1000-1200 -v c:\notebooks:/notebooks --name dotnet-interactive-image dotnet-interactive:1.0