Installation¶
This section describes, how a WsgiDAV server is installed.
See also
If you plan to contribute to the WsgiDAV project, check out Development for details on how to install in development mode.
Preconditions¶
WsgiDAV server was tested with these operating systems (among others):
- Linux (Ubuntu 13)
- Mac OS X 10.9
- Windows (Windows 10, 8, 7, Vista, XP)
WsgiDAV requires
- Python 2.7 or 3.4+
- A WSGI compliant web server.
WsigDAV is a WSGI application, that must be served by a compliant web server. Among others, there are CherryPy / Cheroot, gevent, gunicorn, mod_wsgi, uWSGI, and many more.
Simply choose a server that suites you best. If unsure, we recommend Cheroot (the server that backs CherryPy) which has proven to be pretty performant and stable. Cheroot comes also bundled with the MSI installer.- Optionally lxml for slight performance improvements (speed up performance of PROPPATCH requests up to 10%).
Unix / Linux¶
Releases are hosted on PyPI and can be installed using pip:
$ pip install --upgrade wsgidav
Or install the latest (potentially unstable) development version directly from GitHub:
$ pip install git+https://github.com/mar10/wsgidav.git
In order to run the WsgiDAV server from the command line, we also need a WSGI server such as Cheroot:
$ pip install cheroot
The following examples were tested on Ubuntu 13.04. Install lxml (optional):
$ sudo apt-get install python-lxml
If everything is cool, this should work now:
$ wsgidav --version -v
WsgiDAV/2.4.0 Python/3.6.1 Darwin-17.5.0-x86_64-i386-64bit
$ wsgidav --help
Windows¶
Install the preconditions if neccessary. Basically the same as for Unix / Linux
Note
MS Windows users that only need the command line interface may prefer the MSI installer.
Docker¶
An experimental Docker image that exposes a local directory using WebDAV is available here: https://hub.docker.com/r/mar10/wsgidav/
$ docker pull mar10/wsgidav
$ docker run --rm -it -p <PORT>:8080 -v <ROOT_FOLDER>:/var/wsgidav-root mar10/wsgidav
for example:
$ docker run --rm -it -p 8080:8080 -v c:/temp:/var/wsgidav-root mar10/wsgidav
Then open (or enter this URL in Windows File Explorer or any other WebDAV client) http://localhost:8080/