Skip to content

Latest commit

 

History

History
133 lines (87 loc) · 5.58 KB

WEBDAV.md

File metadata and controls

133 lines (87 loc) · 5.58 KB

MEGA-WEBDAV - Serve you files as a WEBDAV server with MEGAcmd

This is a brief tutorial on how to configure webdav server.

Configuring a WEBDAV server will let you access your MEGA files as if they were located in your computer. All major platforms support access to WEBDAV server. See Platform usage.

Notice: the commands listed here assume you are using the interactive interaction mode: they are supposed to be executed within MEGAcmdShell.

Serving a folder

Example:

webdav /path/mega/folder

This will configure a WEBDAV server that will serve "myfolder". It'll show you the URL to access that path. You just use that location to configure access according to your specific OS. Once you have it configured, you can browse, edit, copy and delete your files as if they were local file in your computer. Caveat: They are not local, MEGAcmd transparently download/upload decrypt/encrypt those files. Hence, throughput will be decreased as compared to accessing to local files. Be patient.

Streaming

You can "webdav" a file, so as to offer streaming access to it:

webdav /path/to/myfile.mp4

You will receive an URL that you can use in your favourite video player.

Issues

We have detected some issues with different software, when trying to save a file into a webdav served locations. Typically with software that creates temporary files. We will keep on trying to circumvent those.

In Linux, using gvfsd-dav (Gnome's default webdav client), we have occasionally seen problems trying to open text files that have already been modified using some graphic editors. This is due to that gvfsd-dav tries to retrieve a URL different to the actual URL of the files. Reading the files through the console works just fine. This has been detected in Ubuntu 16.04.

In Windows XP, copying a file from a MEGA webdav location, and pasting in a local folder does nothing.

If you find any more issues, don't hesitate to write to support@mega.nz, explaining what the problem is and how to reproduce it.

Listing

You can list the webdav served locations typing webdav:

WEBDAV SERVED LOCATIONS:                                                        
/path/mega/folder: http://127.0.0.1:4443/XXXXXXX/myfolder
/path/to/myfile.mp4: http://127.0.0.1:4443/YYYYYYY/myfile.mp4

These locations will be available as long as MEGAcmd is running. The configuration is persisted, and will be restored everytime you restart MEGAcmd

Additional features/configurations

Port & public server

When you serve your first location, a WEBDAV server is configured in port 4443. You can change the port passing --port=PORT to your webdav command. By default, the server is only accessible from the local machine. You can pass --public to your webdav command so as to allow remote access. In that case, use the IP of your server to access to it.

HTTPS

Files in MEGA are encrypted, but you should bear in mind that the HTTP webdav server offers your files unencrypted.
If you wish to add authenticity to your webdav server and integrity & privacy of the data transfered to/from the clients, you can secure it with TLS. You just need to pass --tls and the paths* to your certificate and key files (in PEM format):

webdav /path/mega/folder --tls --certificate=/path/to/certificate.pem --key=/path/to/certificate.key

*Those paths are local paths in your machine, not in MEGA.

Currently, MEGAcmd only supports one server: although you can serve different locations, only one configuration is possible. The configuration used will be the one on your first served location. If you want to change that configuration you will need to stop serving each and every path and start over.

Stop serving

You can stop serving a MEGA location with:

webdav -d /path/mega/folder

If successfully, it will show a message indicating that the path is no longer served:

/path/mega/folder no longer served via webdav

Platforms

All major platforms support accesing/mounting a webdav location. Here are some instructions to do that in Windows, Linux & Mac.

Windows

This instructions refer to Windows 10, but they are similar in other windows.

Open an Explorer window, and then do right click on "This PC", and then "Map network drive...".

webdavMenuWin.png

Then enter the URL MEGAcmd gave you

webdavConnectToServerWin.png

Then, you should see the new location in the navigation panel now.

Mac

Open Find and in the Menu "Go", select "Connect to Server", or type ⌘ - k:

webdavMenuMac.png

Then enter the URL MEGAcmd gave you

webdavConnectToServerMac.png

At the moment of writing this tutorial, there is no authentication mechanisms, hence you don't need to worry about providing a user name/password. Just proceed if you are prompted with default options. You should see the new location in the navigation panel now.

Linux

This instructions are for Nautilus, it should be similar using another file browser. Click on File -> Connect to Server:

webdavMenuLinux.png

Then enter the URL MEGAcmd gave you

webdavConnectToServerLinux.png

You should see the new location in the navigation panel now.