An elfinder connector built with FastAPI, specifically for working with jupyter server proxy.
Project description
ImJoy elFinder
A web file browser for managing data on remote jupyter servers, specifically built for the ImJoy project, an open source platform for deploying computational tools to the end user.
The frontend is built with elFinder and a Python backend server.
What is elFinder
elFinder is an open-source file manager for web, written in JavaScript using jQuery and jQuery UI, the project is maintained by Studio 42.
Installation
Python 3.7+ is required.
pip install -U imjoy-elfinder
Basic Usage
In your terminal, run the following command:
imjoy-elfinder --thumbnail
(The thumbnail option enables thumbnail for images, it will create a folder named .tmb
under your current folder, you can also disable that by remove the --thumbnail
option.)
You will then see the following message:
==========ImJoy elFinder server is running=========
http://127.0.0.1:8765
Depending on where you started the command, the file browser will show your current folder as root directory or HOME.
In order to browse your own directory, you can manually set the root directory by passing --root-dir=/PATH/TO/MY/FOLDER
.
Use it with remote Jupyter notebook server
If you don't have jupyter notebook, run:
pip install -U jupyter
Next, install ImJoy elFinder with jupyter server proxy extension:
pip install -U imjoy-elfinder[jupyter]
Now start Jupyter notebook as you would do normally, for example:
jupyter notebook --ip=0.0.0.0
You will get a web file browser at http://YOUR_NOTEBOOK_URL/elfinder
(depending on what you get from your notebook, for example, the url can be http://localhost:8000/elfinder
).
Start a demo with MyBinder
-
Start an instance on MyBinder: https://mybinder.org/v2/gh/imjoy-team/imjoy-elfinder/master?urlpath=elfinder
-
You should be able to see a file browser.
Security Considerations
Please be aware that there is potential risk to use ImJoy elFinder locally or remotely over the internet.
Here are some suggestions:
-
Try to set root-dir to a folder containing the files you actually need, as minimal as possible, avoid exposing the entire file system.
-
For remote servers, use it via the Jupyter proxy such that the access will be protected by jupyter token or password. also, do not turn off the authentication in Jupyter.
-
For running it locally, we use allow-origin header (CORS) to protect access from a random website, for that to work, please use a modern browser and keep it updated.
-
Update ImJoy elFinder regularly with 'pip install -U imjoy-elfinder', in case there is security updates.
Development
- For developers, you can enable hot reloading by using
hupper
:
hupper -m imjoy_elfinder
- Install all development requirements with:
pip install -r requirements_dev.txt
You can also watch additional files by add -w
(e.g.: hupper -m imjoy_elfinder -w imjoy_elfinder/templates/elfinder/main.js
)
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for imjoy_elfinder-0.1.63-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7eb7ea8df04a1f263a9aac02abb1eb733b5e096db96b9a83a653edb21bf556a1 |
|
MD5 | 48624e79e08da2392cb052f9d23ec824 |
|
BLAKE2b-256 | 749bc5369556f0647bf67f03d51cfe77aa63482cf558492bf04dc287d27d074c |