A generic and extendable WebDAV server written in Python and based on WSGI. It can be used to share files between across your various devices or with friends.


For this guide you should be familiar with the basic concepts of


Use pip3 to install wsgidav:

[isabell@stardust ~]$ pip3 install wsgidav cheroot --user

Create the data folder:

[isabell@stardust ~]$ mkdir ~/webdav

Add additional folders you want to access via webdav with:

[isabell@stardust ~]$ mkdir ~/webdav/<newfoldername>

Config file


Only use spaces to indent in the config file! No tabs!

We will modify this example config (YAML):

Define which folder should be accessible:

mount_path: null
    "/": "/home/isabell/webdav/"
    "/firstpath": "/home/isabell/webdav/<newpath>"
# Adds folder "/home/isabell/webdav/<newpath>" to URL

Add user and password for every path:

        "*":  # default (used for all shares that are not explicitly listed). Keep this one!
                password: "<password>" # Change it!
                roles: ["editor"]
        "/firstpath": # The mount_path this user has access to.
            "isabellscousin": # Username
                password: "<password>" # Password. Change it!
# You can add multiple users for every path.

Save the file here:


Configure web server

To make the web server available as a web backend you have to explicitly set the host ip address in the configuration file ~/etc/wsgidav.yaml.



wsgidav is running on port 8080.

To make the application accessible from the outside, configure a web backend:

[isabell@stardust ~]$ uberspace web backend set / --http --port <port>
Set backend for / to port <port>; please make sure something is listening!
You can always check the status of your backend using "uberspace web backend list".
[isabell@stardust ~]$

Configure supervisord

Create ~/etc/services.d/wsgidav.ini with the following content:

command=wsgidav -c %(ENV_HOME)s/etc/wsgidav.yaml
directory = %(ENV_HOME)s/webdav

Start Service

After creating the configuration, tell supervisord to refresh its configuration and start the service:

[isabell@stardust ~]$ supervisorctl reread
SERVICE: available
[isabell@stardust ~]$ supervisorctl update
SERVICE: added process group
[isabell@stardust ~]$ supervisorctl status
SERVICE                            RUNNING   pid 26020, uptime 0:03:14
[isabell@stardust ~]$

Now go to https://<username> (would be in our example) and see if it works. Enjoy!

Tested with wsgidav 3.1.0, Uberspace

Written by: Sebastian Burschel <>