Context
The WEkEO Drive stands among all the services offered by the WEkEO platform in the Essential (free) plan (cf. Registration and offer plans).
Once a user is connected, the WEkEO Drive is available in the private dashboard. It is a very useful tool allowing to share work performed between users.
Access WEkEO Drive
Log in to your account (you can create one for free).
Click on the "cloud" icon:
It will open the WEkEO Drive homepage:
You can now explore the available resources in the WEkEO Drive:
How to connect JupyterHub with WEkEO Drive?
The WebDAV protocol provides a framework for users to create, share, access and move documents on a server. This tool can be useful to store your work in the WEkEO Drive and to share your work between users.
In case you would like to move your files or folders, please follow these steps:
Step 1. First, you need to set up a password for your WEkEO Drive. By clicking your profile at the upper right (in WEkEO Drive), you can click on Settings (1):
Here, you can go to Security (2) and create a new password for the WEkEO Drive.
⚠️ We highly recommend to not use the same password as your WEkEO account.
Step 2. Create a new Jupyter notebook in your JupyterHub environment.
Step 3. Install the package webdavclient3 as follows: !pip install webdavclient3
This package provides an easy way to work with WebDAV servers.
Step 4. Then, the configuration of the client is needed. Required keys for configuring client connection with WebDAV server are webdav_hostname, webdav_login and webdav_password:
from webdav3.client import Client
options = {
'webdav_hostname': "<your_webdav_hostname>",
'webdav_login': "<your_username>",
'webdav_password': "<your_password>"
}
client = Client(options)
client.list()
To find the webdav_hostname, go on Files (1) and then Settings (2) at the bottom left.
You can copy the url from the WebDAV field (3):
The webdav_login is the WEkEO username, and webdav_password is the password configured in the first step.
Step 5. After setting the client, you can upload your files/folders to the WEkEO Drive by just using the following command:
client.upload_sync(remote_path="<path_JupyterHub>", local_path="<path_WEkEO_Drive>")
Step 6. Following this, you will see a new file/folder in the WEkEO Drive. If you would like to share it, you can share the link through WEkEO Drive.
Step 7. In case you would like to perform the inverse approach, you can send data from the WEkEO Drive to the JupyterHub using the following command:
client.download_sync(remote_path="<path_JupyterHub>", local_path="<path_WEkEO_Drive>")
Mapping drive for moving large files
Mapping to a drive enables you to browse and move files stored on a WEkEO Drive (Nextcloud) server. This is beneficial if you would like to store large files or folders into the WEkEO Drive.
Using this feature requires network connectivity. If you want to store your files offline, use the Desktop Client to sync all files on your WEkEO Drive to one or more directories of your local hard drive.
💡WEkEO Pro Tip: to map a drive, please check the Nextcloud Manual.pdf or look at the manual in the WEkEO Drive. This would definitely help you uploading and extracting files in a much faster manner!
In order to understand whether you have created correctly the drive, you should see the drive of the WEkEO Drive in the network locations as shown below:
What's next?
We are user-driven and we implement users' suggestions, so feel free to contact us:
through a chat session available in the bottom right corner of the page
via our contact webpage
via e-mail to our support team (supportATwekeo.eu)
Regardless of how you choose to contact us, you will first be put in touch with our AI Agent Neo. At any time, you can reach a member of the WEkEO User Support team by clicking on "talk to a person" via chat, or by naturally requesting it in reply to Neo's email.