Editing Introduction to a Self Managed Life: a 13 hour & 28 minute presentation by FUTO software (section)

==== 3.1 Install and Configure WsgiDAV ====

WsgiDAV is a WebDAV server implementation written in Python.

<ol style="list-style-type: decimal;">
<li><p>'''Install WsgiDAV and its dependencies:'''</p>
<pre>sudo apt install python3-pip python3-dev libssl-dev libpam0g-dev -y
sudo pip3 install cheroot six python-pam
sudo pip install git+https://github.com/mar10/wsgidav.git</pre>
<blockquote><p>'''CAUTION:''' Do not install pip version of WsgiDAV as it will not work with the follow symlink option! These commands will install Python development files, SSL development files, WsgiDAV from github, and Cheroot (a WSGI server).</p></blockquote></li>
<li><p>'''Create WsgiDAV configuration directory:'''</p></li>
</ol><pre>sudo mkdir -p /etc/wsgidav</pre>
<ol  start="3" style="list-style-type: decimal;"><li><p>'''Generate an SSL certificate for WsgiDAV:'''</p></li></ol>

<pre> sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/wsgidav.key -out /etc/ssl/certs/wsgidav.crt</pre>
This creates a self-signed SSL certificate. In a production environment, use a certificate from a trusted Certificate Authority. When having localhost connect to localhost in your closet… this will do.

<ol start="4" style="list-style-type: decimal;">
<li>'''Create and edit the WsgiDAV configuration file:'''</li></ol>

<pre>sudo nano /etc/wsgidav/wsgidav.yaml</pre>
<ol start="5" style="list-style-type: decimal;">
<li>'''Add the following content to the configuration file, editing <code>/home/louis/webdavroot</code> with the directory you will use for documents:'''</li></ol>

<pre>  host: 0.0.0.0
  port: 8080
  ssl_certificate: /etc/ssl/certs/wsgidav.crt
  ssl_private_key: /etc/ssl/private/wsgidav.key
  enable_https: true
  
  
  fs_dav_provider:
      follow_symlinks: true
  
  `provider_mapping:
      '/webdav': '/home/louis/webdavroot'
  
  
  http_authenticator:
    domain_controller: wsgidav.dc.pam_dc.PAMDomainController
    accept_basic: true
    accept_digest: false
    default_to_digest: false
  
  pam_dc:
    service: &quot;login&quot;
    allow_users: &quot;all&quot;
  
  verbose: 3
  
  property_manager: true
  lock_storage: true
  
  middleware_stack:
    - wsgidav.error_printer.ErrorPrinter
    - wsgidav.http_authenticator.HTTPAuthenticator
    - wsgidav.dir_browser.WsgiDavDirBrowser
    - wsgidav.request_resolver.RequestResolver
  
  dir_browser:
    enable: true
    icon: true
    response_trailer: true</pre>
This configuration sets up SSL, defines shared directories, and configures authentication.

<ol start="7" style="list-style-type: decimal;">
<li><p>'''Add the following content to the service file:'''</p>
<pre>[Unit]
Description=WsgiDAV WebDAV Server
After=network.target

[Service]
ExecStart=/usr/local/bin/wsgidav --config=/etc/wsgidav/wsgidav.yaml
Restart=always

[Install]
WantedBy=multi-user.target</pre>
<p>This creates a systemd service for automatically starting WsgiDAV.</p></li>
<li><p>'''Set correct permissions for the configuration file:'''</p>
<pre>sudo chown root:root /etc/wsgidav/wsgidav.yaml
sudo chmod 644 /etc/wsgidav/wsgidav.yaml</pre>
<p>This make sures only root can modify the configuration file.</p></li>
<li><p>'''Enable and start the WsgiDAV service:'''</p>
<pre>sudo systemctl enable wsgidav.service
sudo systemctl start wsgidav.service</pre>
<p>This enables the service to start on boot and starts it immediately.</p></li></ol>

Now, it’s time to go back to the onlyoffice window we were at before to enter the WebDAV server information. '''See how mine is /webdav? That’s because'''

<gallery mode="packed-hover" heights=250 widths=400 perrow=2>
File:lu55028jxemg_tmp_77f5a739.png
</gallery>

<span id="understanding-file-locations"></span>