WsgiDAV Documentation¶
A generic and extendable WebDAV server written in Python and based on WSGI.
- Project:
- Version:
4.3, Date: Sep 24, 2024
Main Features¶
Comes bundled with a server and a file system provider, so we can share a directory right away from the command line.
Designed to run behind any WSGI compliant server.
Tested with different clients on different platforms (Windows, Linux, Mac).
Supports online editing of MS Office documents.
Contains a simple web browser interface.
SSL support
Support for authentication using Basic or Digest scheme.
Passes the litmus test suite.
Open architecture allows to Writing Custom Providers (i.e. storage, locking, authentication, virtual file systems, …).
WsgiDAV is a refactored version of PyFileServer written by Ho Chun Wei.
Note
Release 4.0 introduces some refactorings and breaking changes.
See Release Info for details.
Quickstart¶
Releases are hosted on PyPI. Install WsgiDAV (and a server) like:
$ pip install cheroot wsgidav
Note
MS Windows users that only need the command line interface may prefer the MSI installer or install using the Windows Package Manager:
> winget install wsgidav
To serve the /tmp
folder as WebDAV /
share with anonymous read-write
access, simply run:
$ wsgidav --host=0.0.0.0 --port=80 --root=/tmp --auth=anonymous
Then open http://HOST/ in your browser or pass this URL to another WebDAV-aware client, such as MS Word, macOS Finder, Windows File Explorer, …
On Linux we can enforce authentication against known users (e.g.
/etc/passwd
, /etc/shadow
) like so:
$ wsgidav --host=0.0.0.0 --port=80 --root=/tmp --auth=pam-login
On Windows we can enforce authentication against known users (e.g. Windows NT Domain Controller) like so:
> wsgidav --host=0.0.0.0 --port=80 --root=/tmp --auth=nt
There is much more to configure. Read this docs to find out.
Supported Clients¶
WsgiDAV comes with a web interface and was tested with different clients (Windows File Explorer and drive mapping, MS Office, Ubuntu, Mac OS X, …).