{"id":16567922,"url":"https://github.com/drorata/mwe-jupyter-docker","last_synced_at":"2026-04-16T23:01:31.285Z","repository":{"id":150667653,"uuid":"84986543","full_name":"drorata/mwe-jupyter-docker","owner":"drorata","description":"Minimal Jupyter notebook using Docker","archived":false,"fork":false,"pushed_at":"2017-07-10T18:07:33.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-15T23:59:21.486Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drorata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-14T18:59:23.000Z","updated_at":"2017-03-14T18:59:47.000Z","dependencies_parsed_at":"2023-05-30T20:31:06.793Z","dependency_job_id":null,"html_url":"https://github.com/drorata/mwe-jupyter-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drorata%2Fmwe-jupyter-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drorata%2Fmwe-jupyter-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drorata%2Fmwe-jupyter-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drorata%2Fmwe-jupyter-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drorata","download_url":"https://codeload.github.com/drorata/mwe-jupyter-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242012418,"owners_count":20057656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-11T21:07:48.078Z","updated_at":"2025-12-04T01:05:41.198Z","avatar_url":"https://github.com/drorata.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Motivation\n\n[Reproducible research](http://drorata.github.io/posts/2017/Mar/16/pillars-of-reproducible-data-science-work/) is, in my opinion, an important aspect of data science work and should be exercised as much as possible.\nAs part of this effort, I started to explore Docker which allows the creation of an image which bundles both the code of the analysis and the data to be crunched.\nIn this repository I outline the most basic way to achieve this.\n\n# Building the image\n\nIn this repository I'm building a docker image from which you could run a Jupyter notebook.\nMy objective is not merely running a notebook; this can be achieved by following the instruction in the [minimal notebook](https://github.com/jupyter/docker-stacks/tree/master/minimal-notebook).\nWhat I'm trying is to build an image which will contain data and a notebook.\nNote that this is very minimal and by and large not optimized or anything like that.\n\nThe magic happens with the [`Dockerfile`](./Dockerfile) where the instructions how to build the image are given.\nSee the inline comments for details.\nOnce you tuned the instructions, you can build the image on your local machine (after cloning this repository):\n\n```bash\ndocker build -t mwe-jupyter-docker .\n```\n\nAt this point, you can run the local image:\n\n```bash\ndocker run -p 8888:8888 mwe-jupyter-docker\n```\n\nIf you want to try out this image without cloning this repository, you should be able to pull it from [Docker hub](https://hub.docker.com/r/drorata/mwe-jupyter-docker/).\n\n## The files:\n\nThis repository comprises of the following files\n\n* `Dockerfile`: Instruction for the image creation\n* `README.md`: This readme\n* `data.csv`: Data generated by `generate-data.ipynb`\n* `generate-data.ipynb`: Data generation notebook; it is included merely for the sake of completeness.\n* `minimal-notebook.ipynb`: Data \"analysis\" notebook\n* `.dockerignore`: an attempt to optimize the size of the image.\n\n# Publishing the image\n\nIf you want to publish this image, the best option is to have an account on [docker hub](https://hub.docker.com).\nBasically, the image should be tagged as `username/mwe-jupyter-docker`.\nFor more details, see the instruction in the [documentation](https://docs.docker.com/engine/getstarted/step_six/#step-1-tag-and-push-the-image).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrorata%2Fmwe-jupyter-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrorata%2Fmwe-jupyter-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrorata%2Fmwe-jupyter-docker/lists"}