# Jupyter Remote Desktop Proxy
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyterhub/jupyter-remote-desktop-proxy/HEAD?urlpath=desktop)
[![Latest PyPI version](https://img.shields.io/pypi/v/jupyter-remote-desktop-proxy?logo=pypi)](https://pypi.python.org/pypi/jupyter-remote-desktop-proxy)
[![Issue tracking - GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/jupyter-remote-desktop-proxy/issues)
[![Help forum - Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub)
Run XFCE (or other desktop environments) on Jupyter.
This is based on https://github.com/ryanlovett/nbnovnc.
When this extension is launched it will run a Linux desktop on the Jupyter single-user server, and proxy it to your browser using VNC via Jupyter.
If a `vncserver` executable is found in `PATH` it will be used, otherwise a bundled TightVNC server is run.
You can use this to install vncserver with support for other features, for example the [`Dockerfile`](./Dockerfile) in this repository installs TurboVNC for improved OpenGL support.
## Installation
1. Install this package itself, with `pip` from `PyPI`:
```bash
pip install jupyter-remote-desktop-proxy
```
2. Install the [websockify](https://github.com/novnc/websockify) dependency. Unfortunately,
the PyPI `websockify` package is broken, so you need to install it either
from [conda-forge](https://anaconda.org/conda-forge/websockify) or with
[apt](https://packages.ubuntu.com/search?suite=all&searchon=names&keywords=websockify)
3. Install the packages needed to provide the actual Linux Desktop environment.
You need to pick a desktop environment (there are many!) - here is the packages
you would need for using the light-weight [XFCE4](https://www.xfce.org/) desktop environment:
```
dbus-x11
libgl1-mesa-glx
xfce4
xfce4-panel
xfce4-session
xfce4-settings
xorg
xubuntu-icon-theme
```
The recommended way to install these is from your Linux system package manager
of choice (such as apt).
## Docker
To spin up such a notebook first build the container:
```bash
$ docker build -t $(whoami)/$(basename ${PWD}) .
```
Now you can ran the image:
```bash
$ docker run --rm --security-opt seccomp=unconfined -p 8888:8888 $(whoami)/$(basename ${PWD})
Executing the command: jupyter notebook
[I 12:43:59.148 NotebookApp] Writing notebook server cookie secret to /home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret
[I 12:44:00.221 NotebookApp] JupyterLab extension loaded from /opt/conda/lib/python3.7/site-packages/jupyterlab
[I 12:44:00.221 NotebookApp] JupyterLab application directory is /opt/conda/share/jupyter/lab
[I 12:44:00.224 NotebookApp] Serving notebooks from local directory: /home/jovyan
[I 12:44:00.225 NotebookApp] The Jupyter Notebook is running at:
[I 12:44:00.225 NotebookApp] http://924904e0a646:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83
[I 12:44:00.225 NotebookApp] or http://127.0.0.1:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83
[I 12:44:00.225 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 12:44:00.229 NotebookApp]
To access the notebook, open this file in a browser:
file:///home/jovyan/.local/share/jupyter/runtime/nbserver-8-open.html
Or copy and paste one of these URLs:
http://924904e0a646:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83
or http://127.0.0.1:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83
*snip*
```
Now head to the URL shown and you will be greated with a XFCE desktop.
Note the `--security-opt seccomp=unconfined` parameter - this is necessary
to start daemons (such as dbus, pulseaudio, etc) necessary for linux desktop
to work. This is the option kubernetes runs with by default, so most kubernetes
based JupyterHubs will not need any modifications for this to work.
## Limitations
1. Desktop applications that require access to OpenGL are currently unsupported.
Raw data
{
"_id": null,
"home_page": "https://jupyter.org",
"name": "jupyter-remote-desktop-proxy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "Interactive,Desktop,Jupyter",
"author": "Jupyter Development Team",
"author_email": "jupyter@googlegroups.com",
"download_url": "https://files.pythonhosted.org/packages/75/f0/208d4d8d7c3c7ba6c73645177806f2ca572fb7ffac2654098acae6c17904/jupyter-remote-desktop-proxy-1.2.1.tar.gz",
"platform": "Linux",
"description": "# Jupyter Remote Desktop Proxy\n\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyterhub/jupyter-remote-desktop-proxy/HEAD?urlpath=desktop)\n[![Latest PyPI version](https://img.shields.io/pypi/v/jupyter-remote-desktop-proxy?logo=pypi)](https://pypi.python.org/pypi/jupyter-remote-desktop-proxy)\n[![Issue tracking - GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/jupyter-remote-desktop-proxy/issues)\n[![Help forum - Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub)\n\nRun XFCE (or other desktop environments) on Jupyter.\n\nThis is based on https://github.com/ryanlovett/nbnovnc.\n\nWhen this extension is launched it will run a Linux desktop on the Jupyter single-user server, and proxy it to your browser using VNC via Jupyter.\n\nIf a `vncserver` executable is found in `PATH` it will be used, otherwise a bundled TightVNC server is run.\nYou can use this to install vncserver with support for other features, for example the [`Dockerfile`](./Dockerfile) in this repository installs TurboVNC for improved OpenGL support.\n\n## Installation\n\n1. Install this package itself, with `pip` from `PyPI`:\n\n ```bash\n pip install jupyter-remote-desktop-proxy\n ```\n\n2. Install the [websockify](https://github.com/novnc/websockify) dependency. Unfortunately,\n the PyPI `websockify` package is broken, so you need to install it either\n from [conda-forge](https://anaconda.org/conda-forge/websockify) or with\n [apt](https://packages.ubuntu.com/search?suite=all&searchon=names&keywords=websockify)\n\n3. Install the packages needed to provide the actual Linux Desktop environment.\n You need to pick a desktop environment (there are many!) - here is the packages\n you would need for using the light-weight [XFCE4](https://www.xfce.org/) desktop environment:\n\n ```\n dbus-x11\n libgl1-mesa-glx\n xfce4\n xfce4-panel\n xfce4-session\n xfce4-settings\n xorg\n xubuntu-icon-theme\n ```\n\n The recommended way to install these is from your Linux system package manager\n of choice (such as apt).\n\n## Docker\n\nTo spin up such a notebook first build the container:\n\n```bash\n$ docker build -t $(whoami)/$(basename ${PWD}) .\n```\n\nNow you can ran the image:\n\n```bash\n$ docker run --rm --security-opt seccomp=unconfined -p 8888:8888 $(whoami)/$(basename ${PWD})\nExecuting the command: jupyter notebook\n[I 12:43:59.148 NotebookApp] Writing notebook server cookie secret to /home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret\n[I 12:44:00.221 NotebookApp] JupyterLab extension loaded from /opt/conda/lib/python3.7/site-packages/jupyterlab\n[I 12:44:00.221 NotebookApp] JupyterLab application directory is /opt/conda/share/jupyter/lab\n[I 12:44:00.224 NotebookApp] Serving notebooks from local directory: /home/jovyan\n[I 12:44:00.225 NotebookApp] The Jupyter Notebook is running at:\n[I 12:44:00.225 NotebookApp] http://924904e0a646:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83\n[I 12:44:00.225 NotebookApp] or http://127.0.0.1:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83\n[I 12:44:00.225 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).\n[C 12:44:00.229 NotebookApp]\n\n To access the notebook, open this file in a browser:\n file:///home/jovyan/.local/share/jupyter/runtime/nbserver-8-open.html\n Or copy and paste one of these URLs:\n http://924904e0a646:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83\n or http://127.0.0.1:8888/?token=40475e553b7671b9e93533b97afe584fa2030448505a7d83\n*snip*\n```\n\nNow head to the URL shown and you will be greated with a XFCE desktop.\n\nNote the `--security-opt seccomp=unconfined` parameter - this is necessary\nto start daemons (such as dbus, pulseaudio, etc) necessary for linux desktop\nto work. This is the option kubernetes runs with by default, so most kubernetes\nbased JupyterHubs will not need any modifications for this to work.\n\n## Limitations\n\n1. Desktop applications that require access to OpenGL are currently unsupported.\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Run a desktop environments on Jupyter",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://jupyter.org",
"Source": "https://github.com/jupyterhub/jupyter-remote-desktop-proxy/",
"Tracker": "https://github.com/jupyterhub/jupyter-remote-desktop-proxy/issues"
},
"split_keywords": [
"interactive",
"desktop",
"jupyter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d2253f461dc1c440e2cdfe6b62822c768b3c40df07b619acc677c377d6e79b1",
"md5": "8b74646222abfcb19763e2ffe6d599a3",
"sha256": "f0ea2c0ad656fb82d26c4f65b8e11de223d70c127a6c83f4ecad180420d8be43"
},
"downloads": -1,
"filename": "jupyter_remote_desktop_proxy-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8b74646222abfcb19763e2ffe6d599a3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 10834968,
"upload_time": "2023-09-27T11:06:18",
"upload_time_iso_8601": "2023-09-27T11:06:18.997289Z",
"url": "https://files.pythonhosted.org/packages/4d/22/53f461dc1c440e2cdfe6b62822c768b3c40df07b619acc677c377d6e79b1/jupyter_remote_desktop_proxy-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "75f0208d4d8d7c3c7ba6c73645177806f2ca572fb7ffac2654098acae6c17904",
"md5": "c68413404f9e84e29adaf54cb1d4f8f8",
"sha256": "8adf71303e653360653c7dc5b9c1a836a239ab3fb2884d3259846046f6b82bda"
},
"downloads": -1,
"filename": "jupyter-remote-desktop-proxy-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "c68413404f9e84e29adaf54cb1d4f8f8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 10637806,
"upload_time": "2023-09-27T11:06:21",
"upload_time_iso_8601": "2023-09-27T11:06:21.459297Z",
"url": "https://files.pythonhosted.org/packages/75/f0/208d4d8d7c3c7ba6c73645177806f2ca572fb7ffac2654098acae6c17904/jupyter-remote-desktop-proxy-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-27 11:06:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jupyterhub",
"github_project": "jupyter-remote-desktop-proxy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "jupyter-remote-desktop-proxy"
}