> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alumio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WebDAV

> Provides filesystem access through the WebDAV protocol.

export const FormField = ({property, label, required = false, diType, uiPatterns, children}) => {
  const patterns = Array.isArray(uiPatterns) ? uiPatterns : uiPatterns ? [uiPatterns] : [];
  return <div style={{
    margin: '1.5rem 0'
  }}>
      <div style={{
    display: 'flex',
    alignItems: 'baseline',
    flexWrap: 'wrap',
    gap: '0.5rem',
    marginBottom: '0.25rem'
  }}>
        <strong>{label}</strong>
        <span style={{
    fontSize: '0.7rem',
    fontWeight: 600,
    textTransform: 'uppercase',
    letterSpacing: '0.04em',
    color: required ? '#6241f5' : '#6b7280'
  }}>
          {required ? 'Required' : 'Optional'}
        </span>
      </div>

      <div>{children}</div>

      {diType || patterns.length > 0 ? <p style={{
    fontSize: '0.85rem',
    color: '#6b7280',
    marginBottom: 0
  }}>
          {diType ? <>
              See the <a href={`/references/${diType}`}>{diType}</a> reference.{' '}
            </> : null}
          {patterns.length > 0 ? <>
              Accepts a <a href={`/documentation/placeholders-and-patterns/patterns#${patterns[0]}`}>pattern</a>.
            </> : null}
        </p> : null}
    </div>;
};

Connect Alumio to a WebDAV server and use it like a filesystem: read files from it and write files to it. WebDAV is the file-sharing protocol used by many content servers and managed file-storage products, so use this connection whenever you need to exchange files with such a system.

This documentation describes: [Schema](/schemas/filesystem/webdav)

## Fields

### General

<FormField property="baseUri" label="Base URL" required>
  The web address of your WebDAV server, including the path to the WebDAV endpoint, for example `https://files.example.com/dav`. Alumio reads and writes files relative to this location.
</FormField>

<FormField property="authType" label="Authentication">
  The sign-in method the server expects. Choose **Basic authentication**, **Digest authentication**, or **NTLM authentication** to match how your server is set up. Ask your server administrator if you are unsure.
</FormField>

<FormField property="userName" label="Username">
  The username Alumio signs in with.
</FormField>

<FormField property="password" label="Password">
  The password that goes with the username. Keep this confidential.
</FormField>

### Advanced

<FormField property="encoding" label="Encoding">
  The compression method used when transferring files, which can speed up transfers if the server supports it. Choose **Identity** for no compression, **Deflate**, **Gzip**, or **All** to let the server pick. If you are unsure, leave it on the default and only change it if your server requires a specific setting.
</FormField>

<FormField property="withoutStreams" label="Disable streams when writing files">
  By default Alumio streams file contents to the server, which keeps memory usage low for large files. Turn this on only if your server has trouble with streamed uploads; Alumio will then send the whole file at once instead. Off by default.
</FormField>

<FormField property="useStreamedCopy" label="Copy files as stream">
  When copying a file on the server, Alumio streams the contents rather than loading the whole file into memory. On by default. Leave it on unless your server does not handle streamed copies well.
</FormField>

<FormField property="logger" label="Logger" diType="filesystem-logger">
  Selects how file activity on this connection is recorded, so you can trace which files were read or written.
</FormField>

## Sample data

A connection to a WebDAV server using basic authentication.

| Field          | Value                           |
| -------------- | ------------------------------- |
| Base URL       | `https://files.example.com/dav` |
| Authentication | Basic authentication            |
| Username       | `your-username`                 |
| Password       | `your-password`                 |

```json Configuration theme={null}
{
  "prototype": "webdav",
  "parameters": {
    "baseUri": "https://files.example.com/dav",
    "authType": 1,
    "userName": "your-username",
    "password": "your-password"
  }
}
```