Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add information for subpath access #536

Merged
merged 4 commits into from
Jun 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 21 additions & 19 deletions cli/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -184,25 +184,27 @@ The `<url>` argument for `--copy`, `--download`, `--upload`, and `--synchronize`
Spaces and other special-characters are not required to be percent-encoded (e.g. `%20` for space) as long as the path is quoted `duck --upload "scheme://hostname/path with/spaces" "/Path/To/Local/File With/Spaces"`.
```

| Protocol | Fully Qualified URI required | Absolute Path | Relative Path |
| --- | --- | --- | --- |
| Windows Azure Storage | No | `azure:/<container>/<key>` | `azure:<container>/<key>` |
| Backblaze B2 Cloud Storage | No | `b2:/<container>/<key>` | `b2:<container>/<key>` |
| WebDAV (HTTP) | Yes (`dav://<hostname>/<path>`) |||
| WebDAV (HTTPS) | Yes (`davs://<hostname>/<path>`) |||
| Dracoon (Email Address) | Yes (`dracoon://<hostname>/<path>`) |||
| Dropbox | No | `dropbox:/<path>` | `dropbox:<path>` |
| Local | No | `file:/<path>` | `file:<path>` |
| FTP (File Transfer Protocol) | Yes (`ftp://<hostname>/<path>`) |||
| FTPS (Explicit Auth TSL) | Yes (`ftps://<hostname>/<path>`) |||
| Google Drive | No | `googledrive:/<path>` | `googledrive:<path>` |
| Google Cloud Storage | No | `gs:/<path>` | `gs:<path>` |
| Microsoft OneDrive | No | `onedrive:/<path>` | `onedrive:<path>` |
| Amazon S3 | `s3://<hostname>/<container>/<key>` | `s3:/<container>/<key>` <br/>(using `s3.amazonaws.com`) | `s3:<container>/<key>` <br/>(using `s3.amazonaws.com`) |
| SFTP (SSH File Transfer <br/>Protocol) | Yes (`sftp://<hostname>/<path>`) |||
| Spectra S3 (HTTPS) | Yes<br/>(`spectra://<hostname>/<container>/<key>`) |||
| Rackspace Cloud Files (US) | No | `rackspace:/<container>/<key>` | `rackspace:<container>/<key>` |
| Swift (OpenStack Object<br/>Storage) | Yes (`swift://<hostname>/<container>/<key>`) |||
| Protocol | Fully Qualified URI required | Absolute Path | Relative Path |
|----------------------------------------|----------------------------------------------------|---------------------------------------------------------|--------------------------------------------------------|
| Windows Azure Storage | No | `azure:/<container>/<key>` | `azure:<container>/<key>` |
| Backblaze B2 Cloud Storage | No | `b2:/<container>/<key>` | `b2:<container>/<key>` |
| WebDAV (HTTP) | Yes (`dav://<hostname>/<path>`) | | |
| WebDAV (HTTPS) | Yes (`davs://<hostname>/<path>`) | | |
| Nextcloud | Yes (`nextcloud://<hostname>/<path>`) | | |
| ownCloud | Yes (`owncloud://<hostname>/<path>`) | | |
| DRACOON (Email Address) | Yes (`dracoon://<hostname>/<path>`) | | |
| Dropbox | No | `dropbox:/<path>` | `dropbox:<path>` |
| Local | No | `file:/<path>` | `file:<path>` |
| FTP (File Transfer Protocol) | Yes (`ftp://<hostname>/<path>`) | | |
| FTPS (Explicit Auth TSL) | Yes (`ftps://<hostname>/<path>`) | | |
| Google Drive | No | `googledrive:/<path>` | `googledrive:<path>` |
| Google Cloud Storage | No | `gs:/<path>` | `gs:<path>` |
| Microsoft OneDrive | No | `onedrive:/<path>` | `onedrive:<path>` |
| Amazon S3 | `s3://<hostname>/<container>/<key>` | `s3:/<container>/<key>` <br/>(using `s3.amazonaws.com`) | `s3:<container>/<key>` <br/>(using `s3.amazonaws.com`) |
| SFTP (SSH File Transfer <br/>Protocol) | Yes (`sftp://<hostname>/<path>`) | | |
| Spectra S3 (HTTPS) | Yes<br/>(`spectra://<hostname>/<container>/<key>`) | | |
| Rackspace Cloud Files (US) | No | `rackspace:/<container>/<key>` | `rackspace:<container>/<key>` |
| Swift (OpenStack Object<br/>Storage) | Yes (`swift://<hostname>/<container>/<key>`) | | |

#### Examples

Expand Down
18 changes: 9 additions & 9 deletions protocols/webdav/nextcloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,20 +33,20 @@ Download [Mountain Duck](https://mountainduck.io/) as an alternative to *Desktop

## Connecting

### Manual Configuration

Choose one of the protocols if you require a custom server path for your installation:

- Protocol: `WebDAV (HTTPS)`
- Default Path: `/remote.php/webdav/`

### Connection Profiles

- Protocol: `Nextcloud`
Select the connection profile in _Protocol_ bundled by default:
- Protocol: `Nextcloud`
- Protocol: `ownCloud`

Alternatively you can connect using `WebDAV (HTTPS)` with the default path set to `/remote.php/webdav/`.

```{tip}
The default path `/remote.php/dav/files/<username>` will be used with no custom setting in _Path_.
The default path `/remote.php/dav/files/<username>` will be used with no custom setting in _Path_ to access the WebDAV API.
```

```{attention}
You are required to set a _Path_ only if your installation is accessible under a subdirectory such as `example.net/cloud/` this can be indicated by setting a default path of `directory/remote.php/webdav`. You can omit the value in _Path_ if your installation defaults to the root of your domain and is accessible at `example.net/remote.php/dav/files/<username>`.
```

### Step-by-Step Instructions
Expand Down
Loading