{"id":13813690,"url":"https://github.com/pl31/heroku-jupyter","last_synced_at":"2025-05-15T00:34:02.319Z","repository":{"id":45004574,"uuid":"45393600","full_name":"pl31/heroku-jupyter","owner":"pl31","description":"One-click deployment for jupyter on heroku","archived":false,"fork":false,"pushed_at":"2023-05-17T21:19:15.000Z","size":71,"stargazers_count":171,"open_issues_count":9,"forks_count":389,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-08-04T04:04:29.613Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pl31.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-11-02T12:39:41.000Z","updated_at":"2024-07-24T01:46:00.000Z","dependencies_parsed_at":"2024-01-20T15:49:10.807Z","dependency_job_id":"9be395ad-727f-4ade-b69e-e3eda6d80d60","html_url":"https://github.com/pl31/heroku-jupyter","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/pl31%2Fheroku-jupyter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pl31%2Fheroku-jupyter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pl31%2Fheroku-jupyter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pl31%2Fheroku-jupyter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pl31","download_url":"https://codeload.github.com/pl31/heroku-jupyter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225319303,"owners_count":17455743,"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-08-04T04:01:25.912Z","updated_at":"2024-11-19T08:30:54.222Z","avatar_url":"https://github.com/pl31.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# heroku-jupyter\n\n*Currently none of the configurations work properly.\nI am not able to figure out a working environment.yml.\nSad enough older configurations do not work, as deprecated\npackages have been removed from package repositories.*\n\n*Instead of using anaconda, it might be more stable to create\na docker container to run in heroku. See as an example\n[heroku-debian-jupyter](https://github.com/pl31/heroku-debian-jupyter),\nbut there is still no support for a heroku deploy button from heroku*\n\nUse this application to deploy [Jupyter Notebook](https://jupyter.org/) to\nheroku or CloudFoundry. If a postgres database is available,\n[pgcontents](https://github.com/quantopian/pgcontents) is used as notebook\nstorage.\n\n## Quick start\n\nJupyter will not start, if the environment variable `JUPYTER_NOTEBOOK_PASSWORD`\nwas not set.\n\nIf you want to customize your app, easiest is to fork this repository.\n\n## Installation instructions\n\n### heroku - automatic deployment\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\nIf you forked this repository, you can link it to your heroku app afterwards.\n\n### heroku - manual deployment\n\nPush this repository to your app or fork this repository on github and link your\nrepository to your heroku app.\n\nUse the [heroku-buildpack-conda](https://github.com/pl31/heroku-buildpack-conda):\n```\n$ heroku buildpacks:set https://github.com/pl31/heroku-buildpack-conda.git -a \u003cyour_app\u003e\n```\n\nJupyter notebook will not start until the environment variable\n`JUPYTER_NOTEBOOK_PASSWORD` is set. Use a good password:\n```\n$ heroku config:set JUPYTER_NOTEBOOK_PASSWORD=\u003cyour_passwd\u003e -a \u003cyour_app\u003e\n```\n\nIf you are really sure, that you do not want a password protected notebook\nserver, you can set `JUPYTER_NOTEBOOK_PASSWORD_DISABLED` to `DangerZone!`.\n\n### CloudFoundry\n\n- Clone this repository\n- Create a postgres database service with name `jupyter-db`\n- Deploy using `cf push`\n- Set `JUPYTER_NOTEBOOK_PASSWORD` using `cf set-env`. Do not forget to restart application.\n\n## Environment variables\n\n- `JUPYTER_NOTEBOOK_PASSWORD`: Set password for notebooks\n- `JUPYTER_NOTEBOOK_PASSWORD_DISABLED`: Set to `DangerZone!` to disable password\n  protection\n- `JUPYTER_NOTEBOOK_ARGS`: Additional command line args passed to\n  `jupyter notebook`; e.g. get a more verbose logging using `--debug`\n\n## Python version\n\nIf you want to use a special python version, you should set it in your environment.yml:\n\n```\nname: root\ndependencies:\n  - python=2.7\n  - ...\n```\n\n## Environments\n\n*Experimental feature - in work*\n\n- Parametrize default environment using ENVIRONMENT_YML\n- Add additional kernel(s) to jupyter installation (Python2 and Python3 in parallel)\n- Allow changes and experimental features without damaging defult configuration\n\n| Deployment | Features | Description |\n| ---------- | -------- | ----------- |\n| [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?env[ENVIRONMENT_YML]=environments/default.yml) | Python3, IPython5 | Default Environment\n| [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?env[ENVIRONMENT_YML]=environments/latest.yml) | Python3 | Latest, no version binding\n| [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?env[ENVIRONMENT_YML]=environments/multi_kernel.yml\u0026env[ADDITIONAL_ENVIRONMENT_YML]=environments/kernel/python2/python2.yml) | Python3, IPython5 + Python2 | Default Environment + Python2\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpl31%2Fheroku-jupyter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpl31%2Fheroku-jupyter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpl31%2Fheroku-jupyter/lists"}