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 2 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
6 changes: 6 additions & 0 deletions protocols/webdav/nextcloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,12 @@ In *Cyberduck*, click on *Bookmark* and choose the option *New Bookmark*.
Make sure to use the actual username instead of the email address for login credential.
```

### Connect directly to sub directories

The default root for nextcloud connections is set to `remote.php/webdav` or `remote.php/dav/user/files`. The path must not be added to the bookmark configuration.

If servers are only accessible by using a subpath such as `example.net/directory/` this can be indicated by configuring default path as `directory/remote.php/webdav`. The default path can be set in the bookmark configuration or configured using a [custom profil](../profiles/index.md).
dkocher marked this conversation as resolved.
Show resolved Hide resolved

### 2-Factor Authentication

With 2-factor authentication enabled, you will need to create an app password instead of your regular login credentials. You should find it in *Personal → App passwords*.
Expand Down
Loading