├── .codespellrc ├── .github ├── FUNDING.yml ├── dependabot.yml └── workflows │ ├── CI.yml │ └── codespell.yml ├── .gitignore ├── Makefile ├── README.md ├── _images ├── cryptomator_256.png ├── cyberduck-icon-64.png └── mountainduck_y_64.png ├── _static ├── Ressources │ └── ftp-default.reg ├── css │ └── documentation.css ├── favicon.ico └── videos │ └── mountainduck │ └── keepoffline.mp4 ├── cli ├── _images │ └── CLI_Setup.png ├── index.md └── support.md ├── conf.py ├── cryptomator ├── _images │ ├── Browse_Cryptomator_Vault.gif │ ├── Create_New_Vault.png │ ├── Cryptomator_Vault_Browser.png │ ├── Keychain_Access_Cryptomator_Passphrase.png │ ├── Mountain_Duck_Create_New_Vault_Finder_Extension.png │ ├── Mountain_Duck_Create_New_Vault_Windows_Explorer.png │ ├── Mountain_Duck_Unlock_Vault.png │ ├── Mountain_Duck_Unlock_Vault_Windows.png │ ├── New_Encrypted_Vault_File_Menu_Option.png │ └── cryptomator.png ├── architecture │ └── index.md └── index.md ├── cyberduck-icon-64.png ├── cyberduck ├── _images │ ├── Access_Control_Lists.png │ ├── Activity.png │ ├── Add_Bookmark.png │ ├── Amazon_S3.png │ ├── B2_Authorized_URL.png │ ├── Bookmark_Files.png │ ├── Bookmark_Upload_Selection.png │ ├── Connection_Popup.png │ ├── Console.app.png │ ├── Copy.png │ ├── Cyberduck_Quick_Reference_Page_1.png │ ├── Cyberduck_Quick_Reference_Page_2.png │ ├── Cyberduck_Transcript.png │ ├── Cyberduck_saved_search.png │ ├── Default_FTP_Protocol_Handler.png │ ├── Donation_Prompt.png │ ├── Download_Share_Box.png │ ├── Download_Share_Context_Menu.png │ ├── Download_Toolbar_Button.png │ ├── Drag_Bookmark.png │ ├── Edit_Labels_for_Bookmark.png │ ├── Edit_With_Application.png │ ├── Editor_Preferences.png │ ├── Filezilla_Import.png │ ├── General.png │ ├── Groups_in_Bookmarks_Menu.png │ ├── HTTP_URL.png │ ├── History_Menu.png │ ├── Info_Panel_Versions.png │ ├── Inline_Rename.png │ ├── Language_Preference.png │ ├── Limit_Connections.png │ ├── Metadata.png │ ├── Notification_Center.png │ ├── Notifications_Area_Settings.png │ ├── Open_Connection.png │ ├── Overwrite_Options.png │ ├── Overwrite_Prompt.png │ ├── Passphrase_Prompt_Dropbox_Share.png │ ├── Paste_Files.png │ ├── Proxy_Configuration_FTP_and_SFTP.png │ ├── Proxy_Icon.png │ ├── Quick_Connect.png │ ├── S3_Pre-Signed_URL.png │ ├── Services_Upload.png │ ├── Share_File_Google_Drive_.png │ ├── Synchronize_Folders.png │ ├── Toolbar_Upload.png │ ├── Transfer_Options.png │ ├── Transfer_Progress.png │ ├── Transfers.png │ ├── UNIX_Permissions.png │ ├── Update.png │ ├── Upload_from_Finder.png │ ├── WebDAV_Bookmark_Client_Certificate.png │ ├── command.png │ ├── dropfolderbadge.png │ ├── privatefolderbadge.png │ ├── quicklook.png │ ├── readonlyfolderbadge.png │ └── system_files_criteria.png ├── bookmarks.md ├── browser.md ├── connection.md ├── copy.md ├── cryptomator.md ├── download.md ├── edit.md ├── faq.md ├── index.md ├── info.md ├── installation.md ├── notifications.md ├── preferences.md ├── share.md ├── spotlight.md ├── support.md ├── sync.md ├── transfer.md └── upload.md ├── index.md ├── mountainduck ├── _images │ ├── Access_Control_Lists.png │ ├── Amazon_S3.png │ ├── Bookmark_Search_Input.png │ ├── Context_Menu_Windows.png │ ├── Copy_Operation_Mountain_Duck_File_Explorer.png │ ├── Copy_Operation_Mountain_Duck_Finder.png │ ├── Custom_Location_Sync_Cache.png │ ├── Disk_Syncing.png │ ├── Document_in_Use_Libre_Office_macOS.png │ ├── Edit_Bookmark_Windows.png │ ├── Edit_Bookmark_macOS.png │ ├── File_Added_Notification_Windows.png │ ├── File_Updated_Notification.png │ ├── File_Updated_Notification_Windows.png │ ├── File_in_Use_Microsoft_Word_Windows.png │ ├── General.png │ ├── Icon_Sync_in_Progress.gif │ ├── Info_Panel_Versions.png │ ├── Info_Window_CDN.png │ ├── Info_Window_Metadata.png │ ├── Info_Window_Permissions.png │ ├── Info_Window_S3.png │ ├── Menu_Sync_in_Progress.png │ ├── Metadata.png │ ├── Microsoft_Excel_File_Now_Available_Notification_Windows.png │ ├── Microsoft_Word_File_Now_Available_Windows.png │ ├── Microsoft_Word_Read-Only_Edit_Windows.png │ ├── Mountain_Duck_Finder_Context_Menu.png │ ├── Mountain_Duck_Screenshot_Finder_Dark.png │ ├── Notification_Preferences.png │ ├── Profiles_Preferences.png │ ├── Read_Only_Microsoft_Excel_Windows.png │ ├── Read_Only_Microsoft_Word_macOS.png │ ├── Read_Only_Mode_Libre_Office_macOS.png │ ├── Recent_Files.png │ ├── Revert_File_Context_Menu_Option_Windows.png │ ├── Screenshot_Windows_Mountain_Duck.png │ ├── Soft_Quota_Disk_Space.png │ ├── Status_Bar_Menu_Mac_Dark.png │ ├── Sync_Context_Menu_macOS.png │ ├── Sync_Paused_macOS.png │ ├── Sync_Preferences.png │ ├── Sync_Preferences_Win.png │ ├── Task_Bar_Menu_Windows.png │ ├── Taskbar_Menu_Bookmark_Groups_Large_Icons_Windows.png │ ├── UNIX_Permissions.png │ ├── alert.png │ ├── delete.png │ ├── overlay-pause.png │ ├── overlay_error.png │ ├── overlay_ignored.png │ ├── overlay_infinite.png │ ├── overlay_sync.png │ ├── overlay_syncing.png │ ├── overlay_uptodate.png │ ├── plus.png │ ├── transfer_download.png │ └── transfer_upload.png ├── connect │ ├── index.md │ ├── online.md │ └── sync.md ├── cryptomator.md ├── index.md ├── info.md ├── installation │ ├── _images │ │ ├── Login_Item.png │ │ ├── Mountain_Duck_Finder_Integration.png │ │ └── Mountain_Duck_Windows_Installer.png │ └── index.md ├── interface.md ├── issues │ ├── fastcgi.md │ └── index.md ├── locking.md ├── preferences.md ├── share.md ├── support │ ├── index.md │ └── licensing.md └── versions.md ├── protocols ├── _images │ ├── 10GbE_Transfer.png │ ├── AuthenticationAdmin.png │ ├── Azure_ACLs.png │ ├── Azure_Shared_Access_Signature_URLs.png │ ├── Azure_tab_info_macOS.png │ ├── B2_Bucket_ACL.png │ ├── B2_Bucket_Type.png │ ├── B2_Large_File_Upload.png │ ├── B2_application_key_LI.jpg │ ├── B2_icon_128x128.png │ ├── B2_tab_info_macOS.png │ ├── Cache_Retry.png │ ├── Compress.png │ ├── DRACOON_Download_Share.png │ ├── Dropbox_Authorization_Code.png │ ├── Dropbox_Link.png │ ├── Dropbox_Permissions.png │ ├── GCS_tab_info_macOS.png │ ├── Google_Drive_OAuth_2_Authentication_Code_Prompt.png │ ├── Google_Storage_ACLs.png │ ├── Google_Storage_Access_Log_Configuration.png │ ├── Kex_Timeout.png │ ├── Limit_Number_of_Transfers.png │ ├── Microsoft_OneDrive_OAuth_Authorization.png │ ├── OneDrive_OAuth_2_Authorization.png │ ├── OneDrive_Sign_In.png │ ├── Preferences_Profiles.png │ ├── Preferences_Profiles_macOS.png │ ├── Project_ID_Bookmark_Configuration.png │ ├── SMB_Connection.png │ ├── SMB_Share.png │ ├── Terminal.png │ ├── Unknown_host_key.png │ ├── Unsecured_connection.png │ ├── Use_parallel_transfer_option.png │ ├── Verification_Code_Prompt.png │ ├── Windows-Security-Prompt.png │ ├── azure.png │ ├── box.png │ ├── command.png │ ├── dracoon.png │ ├── dropbox.png │ ├── ftp.png │ ├── googledrive.png │ ├── googlestorage.png │ ├── onedrive.png │ ├── putty.png │ └── spectra_128x128.png ├── azure.md ├── b2.md ├── box.md ├── cdn │ ├── _images │ │ ├── Akamai_CDN_Configuration.png │ │ ├── Akamai_Distribution.png │ │ ├── CDN_Custom_Origin_Server.png │ │ ├── CloudFront_Configuration.png │ │ ├── Copy_URLs.png │ │ └── Custom_Origin_CDN.png │ ├── akamai.md │ ├── cloudfront.md │ ├── index.md │ └── keycdn.md ├── dracoon.md ├── dropbox.md ├── files.com.md ├── ftp.md ├── googlecloudstorage.md ├── googledrive.md ├── index.md ├── irods.md ├── onedrive.md ├── openstack │ ├── _images │ │ ├── Auro_Logo.jpg │ │ ├── Cloud.ca_logo.png │ │ ├── Copy_URLs.png │ │ ├── Create_Container.png │ │ ├── Memset_Logo.png │ │ ├── Memstore.Swift.Config.png │ │ ├── OVH_Public_Cloud_Storage.png │ │ ├── blue-128.png │ │ ├── candy-drive-removable-media-zetta.png │ │ ├── cloudfiles_icon.png │ │ ├── cropped-cloudA_transparent_temp_oldsite1.png │ │ ├── entercloudsuite.com.png │ │ ├── swift.png │ │ └── swiftstack.png │ ├── auro.md │ ├── cloud.ca.md │ ├── clouda.md │ ├── cloudfiles.md │ ├── entercloudsuite.md │ ├── flexcloud.md │ ├── hubic.md │ ├── index.md │ ├── infomaniak.md │ ├── internap.md │ ├── memset.md │ ├── oktawave.md │ ├── ovh.md │ ├── providers.md │ ├── swiftstack.md │ └── zetta.io.md ├── profiles │ ├── _images │ │ ├── Google_Client_ID_and_client_secret.png │ │ └── Google_Create_OAuth_Client_ID.png │ ├── _static │ │ ├── Google Drive Custom OAuth Client ID.cyberduckprofile │ │ └── Google Storage Custom OAuth Client ID.cyberduckprofile │ ├── aws_oidc.md │ ├── google_client_id.md │ └── index.md ├── s3 │ ├── _images │ │ ├── 10GbE_Transfer.png │ │ ├── ACLs.png │ │ ├── AWS_Logging_Configuration.png │ │ ├── AWS_SSE-KMS_Private_Key_Selection.png │ │ ├── Cache_Retry.png │ │ ├── Copy_URLs.png │ │ ├── Create_Bucket.png │ │ ├── Dunkel_Cloud_Storage.png │ │ ├── Lifecycle-Configuration-for-S3-Windows.png │ │ ├── MFA_Credentials.png │ │ ├── MFA_Token_Prompt.png │ │ ├── MINIO_wordmark.png │ │ ├── OCI_Object_Storage.png │ │ ├── S3_Anonymous_Login.png │ │ ├── S3_Website_Configuration.png │ │ ├── Wasabi_Certificate_Error.png │ │ ├── cloud-mrktplc-badge.png │ │ ├── exoscale.png │ │ ├── garage.png │ │ ├── s3.png │ │ └── selectel.png │ ├── alibaba.md │ ├── cloudflare.md │ ├── cynny.md │ ├── digitalocean.md │ ├── dreamobjects.md │ ├── dunkel.md │ ├── exoscale.md │ ├── fastly.md │ ├── filebase.md │ ├── garage.md │ ├── hetzner.md │ ├── ibmcos.md │ ├── index.md │ ├── ionos.md │ ├── linode.md │ ├── minio.md │ ├── oraclecloud.md │ ├── pilvio.md │ ├── polycloud.md │ ├── providers.md │ ├── scaleway.md │ ├── seagate.md │ ├── selectel.md │ ├── spectra.md │ ├── storadera.md │ ├── storjdcs.md │ ├── synology.md │ ├── vitanium.md │ ├── wasabi.md │ └── z1.md ├── sftp │ ├── index.md │ ├── providers.md │ └── sftptogo.md ├── sharepoint.md ├── smb.md ├── spectra.md └── webdav │ ├── _images │ ├── NextCloud_Bookmark_Window.png │ ├── Nextcloud_Download_Everyone.png │ ├── Nextcloud_Drive_icon.png │ ├── Nextcloud_Share_Passphrase.png │ ├── WebDAV_Bookmark_Client_Certificate.png │ ├── Windows-Security-Prompt.png │ └── ownCloud_Drive_icon.png │ ├── bigcommerce.md │ ├── gmx.md │ ├── ikeepincloud.md │ ├── index.md │ ├── kdrive.md │ ├── nextcloud.md │ ├── pcloud.md │ ├── providers.md │ └── seafile.md ├── requirements.txt └── tutorials ├── _images ├── 1Password_Authorize_SSH_Key_Usage.png ├── 1Password_SSH_Agent_Edit_Automatically.png ├── 1Password_SSH_Agent_Settings.png ├── 1Password_SSH_Key_Create.png ├── APIs_Services_Client_ID.png ├── Access_Cryptomator_Vault_Cyberduck.png ├── Access_Cryptomator_Vault_Mountain_Duck.png ├── App_Information_Client_ID.png ├── Application_Type_Client_ID.png ├── Bitwarden_Confirm_SSH_Key_Usage.png ├── Bitwarden_SSH_Agent_Settings.png ├── Bitwarden_SSH_Key_Create.png ├── Bookmark_Panel.png ├── Client_ID_Credentials.png ├── Consent_Screen_Client_ID.png ├── Create_New_Project_Client_ID.png ├── Enable_APIs_Client_ID.png ├── List_of_Scopes_Client_ID.png ├── Local_Disk_Connection.png ├── OAuth_Client_ID_Credentials.png ├── Search_Google_API.png ├── Test_Users_Client_ID.png └── YubiKey_Agent_PIN_Prompt.png ├── cli_github_action.md ├── custom_oauth_client_id.md ├── hidden_properties.md ├── iam.md ├── index.md ├── sftp_publickeyauth.md ├── sftp_publickeyauth_1password.md ├── sftp_publickeyauth_bitwarden.md ├── sftp_publickeyauth_yubikey.md └── vault_localdisk.md /.codespellrc: -------------------------------------------------------------------------------- 1 | [codespell] 2 | skip = .git,*.pdf,*.svg,go.sum,*.css,.codespellrc 3 | check-hidden = true 4 | # Some German and custom names and regexes 5 | ignore-regex = .*\b(ist ein|SAV for Mac)\b|.*ü.*|\bTe\*|\b_static/Ressources\b 6 | # ignore-words-list = 7 | -------------------------------------------------------------------------------- /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | custom: ['https://cyberduck.io/donate/'] 2 | -------------------------------------------------------------------------------- /.github/dependabot.yml: -------------------------------------------------------------------------------- 1 | # Set update schedule for GitHub Actions 2 | version: 2 3 | updates: 4 | - package-ecosystem: "github-actions" 5 | directory: "/" 6 | schedule: 7 | interval: "weekly" -------------------------------------------------------------------------------- /.github/workflows/CI.yml: -------------------------------------------------------------------------------- 1 | # This is a basic workflow to help you get started with Actions 2 | 3 | name: CI 4 | 5 | on: 6 | push: 7 | branches: [ main ] 8 | pull_request: 9 | branches: [ main ] 10 | 11 | workflow_dispatch: 12 | 13 | jobs: 14 | build: 15 | runs-on: ubuntu-latest 16 | 17 | steps: 18 | - uses: actions/checkout@v4 19 | - uses: iterate-ch/sphinx-action@v1.0 20 | with: 21 | docs-folder: "." 22 | build-command: "make dirhtml" 23 | - name: Cache artifacts 24 | uses: actions/cache@v4 25 | if: github.ref == 'refs/heads/main' 26 | with: 27 | key: html-${{ github.sha }} 28 | path: ./_build/dirhtml 29 | deploy: 30 | name: Deploy 31 | runs-on: ubuntu-latest 32 | needs: build 33 | if: github.ref == 'refs/heads/main' 34 | steps: 35 | - uses: actions/checkout@v4 36 | - name: Cache artifacts 37 | uses: actions/cache@v4 38 | with: 39 | key: html-${{ github.sha }} 40 | path: ./_build/dirhtml 41 | - name: Deploy 42 | uses: iterate-ch/cyberduck-cli-action@v1 43 | id: upload 44 | env: 45 | USERNAME: '${{ secrets.AWS_ACCESS_KEY_ID }}' 46 | PASSWORD: '${{ secrets.AWS_SECRET_ACCESS_KEY }}' 47 | with: 48 | mode: upload 49 | url: 's3:/github-cyberduck-docs/' 50 | path: './_build/dirhtml/*' 51 | args: '--existing compare --region ${{ secrets.AWS_DEFAULT_REGION }}' 52 | - name: Purge CDN 53 | uses: iterate-ch/cyberduck-cli-action@v1 54 | id: purge 55 | env: 56 | USERNAME: '${{ secrets.AWS_ACCESS_KEY_ID }}' 57 | PASSWORD: '${{ secrets.AWS_SECRET_ACCESS_KEY }}' 58 | with: 59 | mode: purge 60 | url: 's3:/github-cyberduck-docs/' 61 | args: '--region ${{ secrets.AWS_DEFAULT_REGION }}' 62 | -------------------------------------------------------------------------------- /.github/workflows/codespell.yml: -------------------------------------------------------------------------------- 1 | --- 2 | name: Codespell 3 | 4 | on: 5 | push: 6 | branches: [main] 7 | pull_request: 8 | branches: [main] 9 | 10 | permissions: 11 | contents: read 12 | 13 | jobs: 14 | codespell: 15 | name: Check for spelling errors 16 | runs-on: ubuntu-latest 17 | 18 | steps: 19 | - name: Checkout 20 | uses: actions/checkout@v4 21 | - name: Codespell 22 | uses: codespell-project/actions-codespell@v2 23 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | _build/ 2 | bin 3 | lib 4 | lib64 5 | pyvenv.cfg -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | # Minimal makefile for Sphinx documentation 2 | # 3 | 4 | # You can set these variables from the command line, and also 5 | # from the environment for the first two. 6 | SPHINXOPTS ?= 7 | SPHINXBUILD ?= sphinx-build 8 | SOURCEDIR = . 9 | BUILDDIR = _build 10 | 11 | # Put it first so that "make" without argument is like "make help". 12 | help: 13 | @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) 14 | 15 | .PHONY: help Makefile 16 | 17 | # Catch-all target: route all unknown targets to Sphinx using the new 18 | # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). 19 | %: Makefile 20 | @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Documentation source for [Cyberduck](https://cyberduck.io), [Cyberduck CLI](https://duck.sh) & [Mountain Duck](https://mountainduck.io) 2 | 3 | [![CI](https://github.com/iterate-ch/docs/actions/workflows/CI.yml/badge.svg)](https://github.com/iterate-ch/docs/actions/workflows/CI.yml) 4 | 5 | Libre file transfer client for macOS and Windows. Command line interface (CLI) for Linux, macOS and Windows. 6 | 7 | ## Prerequisites 8 | 9 | - Python 10 | - make 11 | - `pip install sphinx` 12 | - `pip install -r requirements.txt` 13 | 14 | 15 | ## Building 16 | 17 | Build the documentation by running 18 | 19 | ``` 20 | make html 21 | ``` 22 | 23 | Output can be found in `_build/html`. 24 | 25 | ## Contributions 26 | 27 | Contributions to this documentation are welcome. Please open a pull request. 28 | 29 | --- 30 | 31 | ## General Formatting Guidelines 32 | 33 | Add an empty line... 34 | - ...after a heading 35 | - ...before and after an admonition or codeblock 36 | - ...after the admonition class for custom admonitions 37 | - ...after a tab opening and before a tab closing as shown in the [Tabs Section](#tabs) 38 | - ...before and after tables 39 | - ...before and after image inserts with custom properties 40 | 41 | Indent codeblocks and admonitions within numbered lists, as the numbers aren't rendered correctly otherwise. 42 | 43 | ### Footnotes 44 | 45 | - This is a manually-numbered footnote reference.[^3] 46 | - This is an auto-numbered footnote reference.[^myref] 47 | 48 | [^myref]: This is an auto-numbered footnote definition. 49 | [^3]: This is a manually-numbered footnote definition. 50 | 51 | A longer footnote definition.[^mylongdef] 52 | 53 | [^mylongdef]: This is the _**footnote definition**_. 54 | 55 | That continues for all indented lines 56 | 57 | - even other block elements 58 | 59 | Plus any preceding unindented lines, 60 | that are not separated by a blank line 61 | 62 | ### Tabs 63 | Group tabs allow to select a tab for the whole page. As an example: If a page contains three group tabs with macOS and Windows as options and you select macOS for one section then all the sections on the page will switch to macOS. 64 | 65 | ``` 66 | ::::{tabs} 67 | :::{group-tab} macOS 68 | 69 | text 70 | 71 | ::: 72 | :::{group-tab} Windows 73 | 74 | text 75 | 76 | ::: 77 | :::: 78 | ``` 79 | 80 | Regular tabs are limited to the section and doesn't affect any other tabs on the page. 81 | 82 | ``` 83 | ::::{tabs} 84 | :::{tab} Text 1 85 | 86 | text 87 | 88 | ::: 89 | :::{tab} Text 2 90 | 91 | text 92 | 93 | ::: 94 | ``` 95 | 96 | ### Quotes and Code 97 | 98 | ```` 99 | ``` 100 | This is a codeblock 101 | ``` 102 | ```` 103 | 104 | `this is in line code` 105 | 106 | ``` 107 | > this is a single line Quote 108 | ``` 109 | 110 | ### Links und Downloadlinks 111 | Add those inline into the text where needed. 112 | 113 | ``` 114 | [Formatting Cheat Sheet](Formatting_Cheat-Sheet) 115 | ``` 116 | 117 | ``` 118 | {download}`Title` 119 | ``` 120 | 121 | ### Admonitions 122 | Admonitions are boxes with a colored background that highlight information. Available admonition types are: note, warning, tip, caution, attention, danger, error, hint, important, and seealso 123 | 124 | ``` 125 | :::{} 126 | text 127 | ::: 128 | ``` 129 | 130 | Admonitions can also be used with custom titles by using the format below. 131 | 132 | ``` 133 | :::{admonition} Custom Title 134 | :class: tip 135 | 136 | text 137 | ::: 138 | ``` -------------------------------------------------------------------------------- /_images/cryptomator_256.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/_images/cryptomator_256.png -------------------------------------------------------------------------------- /_images/cyberduck-icon-64.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/_images/cyberduck-icon-64.png -------------------------------------------------------------------------------- /_images/mountainduck_y_64.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/_images/mountainduck_y_64.png -------------------------------------------------------------------------------- /_static/Ressources/ftp-default.reg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/_static/Ressources/ftp-default.reg -------------------------------------------------------------------------------- /_static/css/documentation.css: -------------------------------------------------------------------------------- 1 | @import url("https://cdn.cyberduck.io/css/custom.css"); 2 | 3 | body { 4 | font-size: 16px; 5 | } 6 | 7 | .wy-nav-content { 8 | max-width: 100% 9 | } 10 | 11 | .text-align\:left { 12 | text-align: left; 13 | } 14 | .text-align\:center { 15 | text-align: center; 16 | } 17 | .text-align\:right { 18 | text-align: right; 19 | } 20 | 21 | .wy-menu-vertical a:hover, .wy-menu-vertical a:focus { 22 | color: inherit; 23 | } 24 | 25 | .rst-content blockquote { 26 | font-size: 16px; 27 | margin: 0; 28 | } 29 | 30 | .rst-content blockquote p { 31 | padding-left: 10px; 32 | border-left: 5px solid #ccc; 33 | } 34 | 35 | .sphinx-tabs-panel { 36 | padding: 1em 1em 0 1em; 37 | } 38 | 39 | .rst-content section ol.arabic, .rst-content section ol.arabic > li { 40 | list-style: none; 41 | } 42 | 43 | .rst-content section ol.arabic > li { 44 | position: relative; 45 | counter-increment: step-counter; 46 | padding-left: 10px; 47 | padding-bottom: 10px; 48 | } 49 | 50 | .rst-content section ol > li::before { 51 | text-align: center; 52 | content: counter(step-counter); 53 | background-color: #55a5d9; 54 | color: white; 55 | padding: 2px 10px; 56 | border-radius: 50%; 57 | position: absolute; 58 | display: block; 59 | right: 100%; 60 | } -------------------------------------------------------------------------------- /_static/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/_static/favicon.ico -------------------------------------------------------------------------------- /_static/videos/mountainduck/keepoffline.mp4: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/_static/videos/mountainduck/keepoffline.mp4 -------------------------------------------------------------------------------- /cli/_images/CLI_Setup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cli/_images/CLI_Setup.png -------------------------------------------------------------------------------- /cli/support.md: -------------------------------------------------------------------------------- 1 | Support 2 | ==== 3 | 4 | ## Application Support Directory 5 | 6 | ::::{tabs} 7 | :::{group-tab} macOS 8 | 9 | You can reach the application support folder by choosing `Go → Go to folder` within the *Finder* menu, copying the path below into the appearing window, and clicking on the *Open* button afterward. 10 | 11 | `~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/` 12 | 13 | ::: 14 | :::{group-tab} Windows 15 | 16 | You can reach the application support folder by navigating to `%AppData%\Cyberduck` by copying the path into the address bar of the Explorer and press *Return* afterward. 17 | 18 | ::: 19 | :::{group-tab} Linux 20 | 21 | The support directory is `~/.duck/`. 22 | 23 | ::: 24 | :::: 25 | 26 | ### Profiles 27 | 28 | The directory location is printed with `--help` following the list of supported protocols. 29 | 30 | ::::{tabs} 31 | :::{group-tab} macOS 32 | 33 | You can install third party [profiles](../protocols/profiles/index.md) in `~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/Profiles`. 34 | 35 | ::: 36 | :::{group-tab} Windows 37 | 38 | Install additional profiles in `%AppData%\Cyberduck\Profiles` on Windows. 39 | 40 | ::: 41 | :::{group-tab} Linux 42 | 43 | You can install third party [profiles](../protocols/profiles/index.md) in `~/.duck/profiles/`. 44 | 45 | ::: 46 | :::: 47 | 48 | ## Logging Output 49 | 50 | The logging output is written directly into the command line: 51 | 52 | - **macOS:** Open *Terminal.app* and type `-v` 53 | - **Windows:** Open *cmd.exe* and type `-v` 54 | 55 | ### Enable Debug Logging 56 | 57 | To enable debug logging use the parameter `--debug`. Alternatively, set the [environment variable](index.md#preferences) `logging` to the level `debug`, `info`, `warn`, or `error`. 58 | -------------------------------------------------------------------------------- /conf.py: -------------------------------------------------------------------------------- 1 | # Configuration file for the Sphinx documentation builder. 2 | # 3 | # This file only contains a selection of the most common options. For a full 4 | # list see the documentation: 5 | # https://www.sphinx-doc.org/en/master/usage/configuration.html 6 | 7 | # -- Path setup -------------------------------------------------------------- 8 | 9 | # If extensions (or modules to document with autodoc) are in another directory, 10 | # add these directories to sys.path here. If the directory is relative to the 11 | # documentation root, use os.path.abspath to make it absolute, like shown here. 12 | # 13 | # import os 14 | # import sys 15 | # sys.path.insert(0, os.path.abspath('.')) 16 | 17 | # -- Project information ----------------------------------------------------- 18 | 19 | project = 'Cyberduck Help' 20 | copyright = '2022-2025 iterate GmbH' 21 | author = 'iterate GmbH' 22 | 23 | 24 | # -- General configuration --------------------------------------------------- 25 | 26 | # Add any Sphinx extension module names here, as strings. They can be 27 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom 28 | # ones. 29 | extensions = [ 30 | "sphinx_rtd_theme", 31 | "sphinx_tabs.tabs", 32 | "myst_parser", 33 | ] 34 | 35 | # Add any paths that contain templates here, relative to this directory. 36 | templates_path = ['_templates'] 37 | 38 | # List of patterns, relative to source directory, that match files and 39 | # directories to ignore when looking for source files. 40 | # This pattern also affects html_static_path and html_extra_path. 41 | exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'README.md'] 42 | 43 | 44 | # -- Options for HTML output ------------------------------------------------- 45 | 46 | # The theme to use for HTML and HTML Help pages. See the documentation for 47 | # a list of builtin themes. 48 | # 49 | html_theme = 'sphinx_rtd_theme' 50 | html_theme_options = { 51 | 'logo_only': True, 52 | 'style_nav_header_background': '#5a5a5a', 53 | 'style_external_links': True, 54 | 'vcs_pageview_mode': 'edit', 55 | 56 | # Toc options 57 | 'includehidden': True, 58 | 'titles_only': False 59 | } 60 | html_favicon = '_static/favicon.ico' 61 | html_logo = 'cyberduck-icon-64.png' 62 | html_context = { 63 | "display_github": True, # Add 'Edit on Github' link instead of 'View page source' 64 | "github_user": "iterate-ch", 65 | "github_repo": "docs", 66 | "github_version": "main", 67 | "conf_py_path": "/" 68 | } 69 | html_show_sourcelink = False 70 | html_show_sphinx = True 71 | 72 | # Add any paths that contain custom static files (such as style sheets) here, 73 | # relative to this directory. They are copied after the builtin static files, 74 | # so a file named "default.css" will overwrite the builtin "default.css". 75 | html_static_path = ['_static'] 76 | 77 | html_css_files = [ 78 | 'css/documentation.css', 79 | ] 80 | 81 | master_doc = 'index' 82 | myst_heading_anchors = 4 83 | myst_enable_extensions = [ 84 | "html_image", 85 | "colon_fence" 86 | ] -------------------------------------------------------------------------------- /cryptomator/_images/Browse_Cryptomator_Vault.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Browse_Cryptomator_Vault.gif -------------------------------------------------------------------------------- /cryptomator/_images/Create_New_Vault.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Create_New_Vault.png -------------------------------------------------------------------------------- /cryptomator/_images/Cryptomator_Vault_Browser.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Cryptomator_Vault_Browser.png -------------------------------------------------------------------------------- /cryptomator/_images/Keychain_Access_Cryptomator_Passphrase.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Keychain_Access_Cryptomator_Passphrase.png -------------------------------------------------------------------------------- /cryptomator/_images/Mountain_Duck_Create_New_Vault_Finder_Extension.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Mountain_Duck_Create_New_Vault_Finder_Extension.png -------------------------------------------------------------------------------- /cryptomator/_images/Mountain_Duck_Create_New_Vault_Windows_Explorer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Mountain_Duck_Create_New_Vault_Windows_Explorer.png -------------------------------------------------------------------------------- /cryptomator/_images/Mountain_Duck_Unlock_Vault.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Mountain_Duck_Unlock_Vault.png -------------------------------------------------------------------------------- /cryptomator/_images/Mountain_Duck_Unlock_Vault_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/Mountain_Duck_Unlock_Vault_Windows.png -------------------------------------------------------------------------------- /cryptomator/_images/New_Encrypted_Vault_File_Menu_Option.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/New_Encrypted_Vault_File_Menu_Option.png -------------------------------------------------------------------------------- /cryptomator/_images/cryptomator.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cryptomator/_images/cryptomator.png -------------------------------------------------------------------------------- /cryptomator/architecture/index.md: -------------------------------------------------------------------------------- 1 | Encryption Security Architecture 2 | ==== 3 | 4 | Please refer to [Cryptomator](https://docs.cryptomator.org/en/latest/security/architecture/) security overview for more details. 5 | 6 | ## Masterkey 7 | 8 | Each vault has its own 256 bit encryption as well as MAC masterkey used for encryption of file specific keys and file authentication, respectively. Both keys are encrypted using RFC 3394 key wrapping with a KEK derived from the user's password using scrypt. 9 | 10 | The wrapped keys (with some additional metadata) are remotely stored in a JSON file named masterkey.cryptomator located in the root directory of a vault. 11 | 12 | ## Filename Encryption 13 | 14 | Cryptomator uses AES-SIV to encrypt file as well as directory names. Additionally to the name, a unique directory ID of its parent directory is passed as associated data. This prevents undetected moving of files between directories. 15 | 16 | ## File Header Encryption 17 | 18 | The file header stores certain metadata, which is needed for file content encryption. It consists of 68 bytes. 19 | 20 | - 12 bytes nonce used during header payload encryption 21 | - 40 bytes AES-GCM encrypted payload consisting of: 22 | - 8 bytes filled with 1 for future use (formerly used for file size) 23 | - 32 bytes file content key 24 | - 16 bytes tag of the encrypted payload 25 | 26 | ## File Content Encryption 27 | 28 | The cleartext is broken down into multiple chunks, each up to 32 KiB + 28 bytes consisting of: 29 | 30 | - 12 bytes nonce 31 | - up to 32 KiB encrypted payload using AES-GCM with the file content key 32 | - 16 bytes tag computed by GCM with the following AAD: 33 | - file header nonce (to bind this chunk to the file header) 34 | - chunk number as 32 bit big endian integer (to prevent undetected reordering) 35 | 36 | ## References 37 | 38 | [Security Architecture Overview](https://docs.cryptomator.org/en/latest/security/architecture/#) -------------------------------------------------------------------------------- /cyberduck-icon-64.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck-icon-64.png -------------------------------------------------------------------------------- /cyberduck/_images/Access_Control_Lists.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Access_Control_Lists.png -------------------------------------------------------------------------------- /cyberduck/_images/Activity.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Activity.png -------------------------------------------------------------------------------- /cyberduck/_images/Add_Bookmark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Add_Bookmark.png -------------------------------------------------------------------------------- /cyberduck/_images/Amazon_S3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Amazon_S3.png -------------------------------------------------------------------------------- /cyberduck/_images/B2_Authorized_URL.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/B2_Authorized_URL.png -------------------------------------------------------------------------------- /cyberduck/_images/Bookmark_Files.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Bookmark_Files.png -------------------------------------------------------------------------------- /cyberduck/_images/Bookmark_Upload_Selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Bookmark_Upload_Selection.png -------------------------------------------------------------------------------- /cyberduck/_images/Connection_Popup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Connection_Popup.png -------------------------------------------------------------------------------- /cyberduck/_images/Console.app.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Console.app.png -------------------------------------------------------------------------------- /cyberduck/_images/Copy.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Copy.png -------------------------------------------------------------------------------- /cyberduck/_images/Cyberduck_Quick_Reference_Page_1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Cyberduck_Quick_Reference_Page_1.png -------------------------------------------------------------------------------- /cyberduck/_images/Cyberduck_Quick_Reference_Page_2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Cyberduck_Quick_Reference_Page_2.png -------------------------------------------------------------------------------- /cyberduck/_images/Cyberduck_Transcript.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Cyberduck_Transcript.png -------------------------------------------------------------------------------- /cyberduck/_images/Cyberduck_saved_search.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Cyberduck_saved_search.png -------------------------------------------------------------------------------- /cyberduck/_images/Default_FTP_Protocol_Handler.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Default_FTP_Protocol_Handler.png -------------------------------------------------------------------------------- /cyberduck/_images/Donation_Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Donation_Prompt.png -------------------------------------------------------------------------------- /cyberduck/_images/Download_Share_Box.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Download_Share_Box.png -------------------------------------------------------------------------------- /cyberduck/_images/Download_Share_Context_Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Download_Share_Context_Menu.png -------------------------------------------------------------------------------- /cyberduck/_images/Download_Toolbar_Button.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Download_Toolbar_Button.png -------------------------------------------------------------------------------- /cyberduck/_images/Drag_Bookmark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Drag_Bookmark.png -------------------------------------------------------------------------------- /cyberduck/_images/Edit_Labels_for_Bookmark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Edit_Labels_for_Bookmark.png -------------------------------------------------------------------------------- /cyberduck/_images/Edit_With_Application.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Edit_With_Application.png -------------------------------------------------------------------------------- /cyberduck/_images/Editor_Preferences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Editor_Preferences.png -------------------------------------------------------------------------------- /cyberduck/_images/Filezilla_Import.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Filezilla_Import.png -------------------------------------------------------------------------------- /cyberduck/_images/General.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/General.png -------------------------------------------------------------------------------- /cyberduck/_images/Groups_in_Bookmarks_Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Groups_in_Bookmarks_Menu.png -------------------------------------------------------------------------------- /cyberduck/_images/HTTP_URL.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/HTTP_URL.png -------------------------------------------------------------------------------- /cyberduck/_images/History_Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/History_Menu.png -------------------------------------------------------------------------------- /cyberduck/_images/Info_Panel_Versions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Info_Panel_Versions.png -------------------------------------------------------------------------------- /cyberduck/_images/Inline_Rename.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Inline_Rename.png -------------------------------------------------------------------------------- /cyberduck/_images/Language_Preference.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Language_Preference.png -------------------------------------------------------------------------------- /cyberduck/_images/Limit_Connections.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Limit_Connections.png -------------------------------------------------------------------------------- /cyberduck/_images/Metadata.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Metadata.png -------------------------------------------------------------------------------- /cyberduck/_images/Notification_Center.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Notification_Center.png -------------------------------------------------------------------------------- /cyberduck/_images/Notifications_Area_Settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Notifications_Area_Settings.png -------------------------------------------------------------------------------- /cyberduck/_images/Open_Connection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Open_Connection.png -------------------------------------------------------------------------------- /cyberduck/_images/Overwrite_Options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Overwrite_Options.png -------------------------------------------------------------------------------- /cyberduck/_images/Overwrite_Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Overwrite_Prompt.png -------------------------------------------------------------------------------- /cyberduck/_images/Passphrase_Prompt_Dropbox_Share.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Passphrase_Prompt_Dropbox_Share.png -------------------------------------------------------------------------------- /cyberduck/_images/Paste_Files.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Paste_Files.png -------------------------------------------------------------------------------- /cyberduck/_images/Proxy_Configuration_FTP_and_SFTP.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Proxy_Configuration_FTP_and_SFTP.png -------------------------------------------------------------------------------- /cyberduck/_images/Proxy_Icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Proxy_Icon.png -------------------------------------------------------------------------------- /cyberduck/_images/Quick_Connect.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Quick_Connect.png -------------------------------------------------------------------------------- /cyberduck/_images/S3_Pre-Signed_URL.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/S3_Pre-Signed_URL.png -------------------------------------------------------------------------------- /cyberduck/_images/Services_Upload.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Services_Upload.png -------------------------------------------------------------------------------- /cyberduck/_images/Share_File_Google_Drive_.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Share_File_Google_Drive_.png -------------------------------------------------------------------------------- /cyberduck/_images/Synchronize_Folders.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Synchronize_Folders.png -------------------------------------------------------------------------------- /cyberduck/_images/Toolbar_Upload.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Toolbar_Upload.png -------------------------------------------------------------------------------- /cyberduck/_images/Transfer_Options.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Transfer_Options.png -------------------------------------------------------------------------------- /cyberduck/_images/Transfer_Progress.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Transfer_Progress.png -------------------------------------------------------------------------------- /cyberduck/_images/Transfers.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Transfers.png -------------------------------------------------------------------------------- /cyberduck/_images/UNIX_Permissions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/UNIX_Permissions.png -------------------------------------------------------------------------------- /cyberduck/_images/Update.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Update.png -------------------------------------------------------------------------------- /cyberduck/_images/Upload_from_Finder.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/Upload_from_Finder.png -------------------------------------------------------------------------------- /cyberduck/_images/WebDAV_Bookmark_Client_Certificate.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/WebDAV_Bookmark_Client_Certificate.png -------------------------------------------------------------------------------- /cyberduck/_images/command.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/command.png -------------------------------------------------------------------------------- /cyberduck/_images/dropfolderbadge.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/dropfolderbadge.png -------------------------------------------------------------------------------- /cyberduck/_images/privatefolderbadge.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/privatefolderbadge.png -------------------------------------------------------------------------------- /cyberduck/_images/quicklook.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/quicklook.png -------------------------------------------------------------------------------- /cyberduck/_images/readonlyfolderbadge.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/readonlyfolderbadge.png -------------------------------------------------------------------------------- /cyberduck/_images/system_files_criteria.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/cyberduck/_images/system_files_criteria.png -------------------------------------------------------------------------------- /cyberduck/copy.md: -------------------------------------------------------------------------------- 1 | Copy 2 | ==== 3 | 4 | Open two browser windows each with a connection to any server and drag files and folders between the browsers to copy 5 | files or using *Edit → Copy* followed by *Edit → Paste*. 6 | 7 | ## Copy Files and Folders Between Servers 8 | 9 | File are copied using either a server-side operation or by downloading and uploading the file. 10 | 11 | | **Protocol** | **Server-side Copy Support** | **Download and Upload** | 12 | |:---------------------------------------------------------|:----------------------------:|:-----------------------:| 13 | | [FTP](../protocols/ftp.md) | | ✅ | 14 | | [SFTP](../protocols/sftp/index.md) | | ✅ | 15 | | [WebDAV](../protocols/webdav/index.md) | ✅ | | 16 | | [SMB](../protocols/smb.md) | ✅ | | 17 | | [Nextcloud & ownCloud](../protocols/webdav/nextcloud.md) | ✅ | | 18 | | Local Disk | ✅ | | 19 | | | 20 | | [Amazon S3](../protocols/s3/index.md) | ✅ | | 21 | | [Google Storage](../protocols/googlecloudstorage.md) | ✅ | | 22 | | [OpenStack Swift](../protocols/openstack/index.md) | ✅ | | 23 | | [Azure](../protocols/azure.md) | ✅ | | 24 | | [Backblaze B2](../protocols/b2.md) | ✅ | | 25 | | | 26 | | [Microsoft OneDrive](../protocols/onedrive.md) | ✅ | | 27 | | [Microsoft Sharepoint](../protocols/sharepoint.md) | ✅ | | 28 | | [Dropbox](../protocols/dropbox.md) | ✅ | | 29 | | [Google Drive](../protocols/googledrive.md) | ✅ | | 30 | | [Box](../protocols/box.md) | ✅ | | 31 | | | 32 | | [DRACOON](../protocols/dracoon.md) | ✅ | | 33 | | [Files.com](../protocols/files.com.md) | ✅ | | 34 | | [iRODS](../protocols/irods.md) | ✅ | | 35 | 36 | :::{important} 37 | Transfer speed depends on your local connectivity as files are routed through your computer for transfer between the 38 | remote servers. 39 | ::: 40 | -------------------------------------------------------------------------------- /cyberduck/cryptomator.md: -------------------------------------------------------------------------------- 1 | Cryptomator 2 | ==== 3 | 4 | :::{tip} 5 | You do not need to have _Cryptomator for macOS or Windows_ installed to access vaults using Cyberduck. 6 | ::: 7 | 8 | Cyberduck includes support to create and access Cryptomator interoperable vaults. Refer to the [documentation](../cryptomator/index.md). -------------------------------------------------------------------------------- /cyberduck/edit.md: -------------------------------------------------------------------------------- 1 | Edit Files 2 | ==== 3 | 4 | You can edit a file just as a local file in an external editor by clicking the Edit toolbar button or by choosing *File → Edit With*. The file will be downloaded to a temporary directory and opened with the preferred editor. The file will be uploaded to the server every time you choose *File → Save* in the Editor application. The file is not changed on the server if you just close the document without saving it or if the content has not changed. 5 | 6 | ## Default Editor 7 | The default editor opened for a file is selected depending on the file type. If no application is found to handle the file type the default editor chosen in *Preferences* is used instead. 8 | 9 | :::{image} _images/Edit_With_Application.png 10 | :alt: Edit with Application 11 | :width: 700px 12 | ::: 13 | 14 | ::::{tabs} 15 | :::{group-tab} macOS 16 | 17 | To edit file type associations choose *File → Info* for a given file type in the *Finder.app*. 18 | 19 | ::: 20 | :::{group-tab} Windows 21 | 22 | To edit file type associations choose *Properties → General → Type of file → Change…* for a given file type in Windows Explorer. 23 | 24 | ::: 25 | :::: 26 | 27 | ## Preferences 28 | 29 | ### Default Editor 30 | Set your preferred editor in *Preferences*. Select *Always use default editor* in *Preferences → Editor* if you always want to use the default editor set regardless of the file type. 31 | 32 | :::{image} _images/Editor_Preferences.png 33 | :alt: Editor Preferences 34 | :width: 700px 35 | ::: 36 | 37 | ### Versioning 38 | 39 | :::{important} 40 | Cyberduck [9.0](https://cyberduck.io/changelog/) or later required 41 | ::: 42 | 43 | Enable the custom versioning option in *Preferences → Editor* to store previous versions of a file. The versions can be previewed, deleted or restored in the *File → Info → Versions* tab of the *[Info](../cyberduck/info.md#versions)* window. The feature only applies for protocols without native versioning like [FTP](../protocols/ftp.md)/[SFTP](../protocols/sftp/index.md), [WebDAV](../protocols/webdav/index.md), [SMB](../protocols/smb.md), [OpenStack Swift](../protocols/openstack/index.md). The file versions are stored in a hidden folder named `.duckversions` in each folder on the mount. The versions are named with a pattern like `filename.extension → filename-20230906102017.762.extension`. 44 | 45 | ## Hidden Preferences 46 | 47 | ### Disable Upload of Temporary File on Save 48 | 49 | A [hidden configuration option](../tutorials/hidden_properties.md). 50 | 51 | ``` 52 | editor.upload.temporary=false 53 | ``` 54 | 55 | ### Exclude Files from Versioning 56 | 57 | Files can be excluded from versioning by using a [hidden configuration option](../tutorials/hidden_properties.md). 58 | 59 | ``` 60 | versioning.include.regex=.* 61 | ``` 62 | 63 | ### Number of Saved Versions 64 | 65 | Per default, the number of saved versions is limited to 5. The oldest version will be deleted once a new version is uploaded exceeding the limit. 66 | 67 | The number of saved versions can be customized by using a [hidden configuration option](../tutorials/hidden_properties.md). 68 | 69 | ``` 70 | versioning.limit=5 71 | ``` 72 | 73 | ## Problems 74 | 75 | ### No External Editor Available 76 | 77 | :::{admonition} macOS only 78 | :class: tip 79 | 80 | If the editor does not show up as a choice in *File → Edit With* (the only submenu item is *No external editor available*), you may have to rebuild the `LaunchServices`database of OS X using Terminal.app: 81 | 82 | `/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister \ -kill -r -domain local -domain system -domain user` 83 | ::: -------------------------------------------------------------------------------- /cyberduck/index.md: -------------------------------------------------------------------------------- 1 | Cyberduck 2 | ==== 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | installation 8 | bookmarks 9 | connection 10 | browser 11 | transfer 12 | edit 13 | share 14 | info 15 | cryptomator 16 | preferences 17 | notifications 18 | spotlight 19 | support 20 | faq 21 | ::: 22 | 23 | ## Quick Reference Cheat Sheet 24 | 25 | Download the {download}`Cyberduck Quick Reference` PDF. 26 | 27 | :::{image} _images/Cyberduck_Quick_Reference_Page_1.png 28 | :alt: Cyberduck Quick Reference Page 1 29 | :width: 700px 30 | ::: 31 | 32 | :::{image} _images/Cyberduck_Quick_Reference_Page_2.png 33 | :alt: Cyberduck Quick Reference Page 2 34 | :width: 700px 35 | ::: 36 | 37 | ## [Opening Connections](connection.md) 38 | 39 | FTP, SFTP, WebDAV, OpenStack Swift, Google Storage, Amazon S3, and many more protocols are supported. There are several options to open a [connection](connection.md) depending on the workflow. 40 | 41 | ## [Browser](browser.md) 42 | 43 | [Browser](browser.md) remote files in a list or hierarchical outline view. 44 | 45 | - **[Info Window](info.md):** Edit access permissions and configure [CDN](../protocols/cdn/index.md) options 46 | - **QuickLook:** Preview files in the browser window 47 | - **Open Web URL:** Configuration steps to open HTTP URL of selected file 48 | - **[Create and expand ZIP/TAR Archives](../protocols/sftp/index.md#create-and-expand-zip-or-tar-archives)** 49 | - **[Send custom commands](../protocols/sftp/index.md#remote-commands):** Send commands to a server not available in the graphical user interface. 50 | - **[Activity](browser.md#activity):** The activity window shows a list of all pending background tasks. 51 | 52 | ### [Edit Files](edit.md) 53 | 54 | Editing files on the server using an [external editor](edit.md). 55 | 56 | ### [Share Files](share.md) 57 | 58 | Share files with others using signed or temporary URLs. 59 | 60 | ## [Bookmarks](bookmarks.md) 61 | 62 | Create and edit [bookmarks](bookmarks.md) for your favorite servers. 63 | 64 | - [Spotlight](spotlight.md) support for bookmark files 65 | 66 | ## [File Transfers](transfer.md) 67 | 68 | - **[General](transfer.md)** information about transfers. 69 | - **[Download](download.md)** files and folders to your computer. 70 | - **[Upload](upload.md)** files and folders to a server. 71 | - **[Synchronize](sync.md)** folders between your computer and a server. 72 | - **[Copy](copy.md)** files and folders between servers. 73 | 74 | ## [Cryptomator](cryptomator.md) 75 | 76 | Support for client-side encryption with Cryptomator interoperable vaults. 77 | 78 | ## [Notifications](notifications.md) 79 | 80 | - [Notifications](notifications.md) configuration 81 | 82 | ## [Preferences](preferences.md) 83 | 84 | - Settings available in the [Preferences](preferences.md) window. -------------------------------------------------------------------------------- /cyberduck/notifications.md: -------------------------------------------------------------------------------- 1 | Notifications 2 | ==== 3 | 4 | ## Events 5 | 6 | - Connection opened 7 | - Connection failed 8 | - Download failed 9 | - Upload failed 10 | - Transfer complete 11 | - Transfer incomplete 12 | - Transfer queued 13 | - Bonjour 14 | 15 | :::::{tabs} 16 | ::::{group-tab} macOS 17 | 18 | **Notification Center** 19 | 20 | On *OS x 10.8 or later*, notifications are sent to the *Notification Center*. 21 | 22 | **Settings** 23 | 24 | Notifications can be configured in *System Preferences → Notifications*. 25 | 26 | :::{image} _images/Notification_Center.png 27 | :alt: Notification Center 28 | :width: 700px 29 | ::: 30 | 31 | The default alert style is *Banner* which is dismissed automatically after some delay. You can change the type to *Alert* if you want to have a *Close* and *Show* button to dismiss the alert manually. 32 | 33 | :::: 34 | ::::{group-tab} Windows 35 | 36 | **Notification Area** 37 | 38 | Notifications are displayed in the notification area commonly referred to as the system tray. Notifications can be disabled in *Control Panel → Notification Area Icons*. 39 | 40 | **Settings** 41 | 42 | :::{image} _images/Notifications_Area_Settings.png 43 | :alt: Notification Area Settings 44 | :width: 700px 45 | ::: 46 | 47 | :::: 48 | ::::: -------------------------------------------------------------------------------- /cyberduck/spotlight.md: -------------------------------------------------------------------------------- 1 | Spotlight (macOS) 2 | ==== 3 | 4 | ## Search Bookmarks with Spotlight 5 | 6 | Cyberduck includes a custom *Spotlight Importer Plugin* to search the contents of its bookmarks files. 7 | 8 | ## Using the Spotlight Menu 9 | 10 | :::{note} 11 | The *Spotlight Menu* does return no results for recently connected servers in Cyberduck because it excludes indexed files located in `~/Library/Application Support/Cyberduck/History`. This is also an issue for Adium. 12 | ::: 13 | 14 | As a workaround, you have to export all bookmarks to another location such as your *Documents* folder. Select all bookmarks *(`⌘A`)* in the bookmark list and drag these somewhere in your *Documents* folder in the Finder. You can then search bookmarks in the *Spotlight Menu* by nickname and hostname. Additionally, to display all bookmarks as a result search for `kind:"Cyberduck Bookmark"`. 15 | 16 | ## Create a Smart Folder in Finder to Search Bookmark Files 17 | 18 | Using custom search criteria, you can create a smart folder in *Finder.app* to display all recently connected servers and other bookmarks you have manually exported from Cyberduck. 19 | 20 | Follow these steps: 21 | 22 | - Choose *File → Find* in the *Finder*. 23 | - Select *Contents* as a search criteria matching the text `kind: "Cyberduck Bookmark"`. 24 | - Add another criteria using the `+` button. 25 | - Select to include system files in the custom search by choosing *Other...* in the criteria drop-down menu. 26 | 27 | :::{image} _images/system_files_criteria.png 28 | :alt: System Files Criteria 29 | :width: 600px 30 | ::: 31 | 32 | - Choose *System files* as search criteria and choose *are included* as the value. 33 | 34 | When configured, the saved search looks the following: 35 | 36 | :::{image} _images/Cyberduck_saved_search.png 37 | :alt: Cyberduck Saved Search 38 | :width: 800px 39 | ::: -------------------------------------------------------------------------------- /cyberduck/sync.md: -------------------------------------------------------------------------------- 1 | Synchronize Folders 2 | ==== 3 | 4 | ## Synchronization 5 | 6 | Files can be synchronized by selecting the directory to synchronize in the browser and select *File → Synchronize*. You will be prompted to select the directory on your computer to synchronize the files with. 7 | 8 | :::{important} 9 | The options in *Preferences → Transfers → Timestamps* must be enabled. 10 | ::: 11 | 12 | Synchronization is based on the modification date and checksum of the files when available. You will be prompted to confirm the actions and if missing files should only be downloaded, uploaded, or mirrored. 13 | 14 | :::{image} _images/Synchronize_Folders.png 15 | :alt: Synchronize Folders 16 | :width: 700px 17 | ::: 18 | 19 | - **Checkbox:** Toggle to include or exclude files or directories from the transfer. 20 | - **Down Arrow:** The file is downloaded from the server replacing the local file if included. 21 | - **Up Arrow:** The file is uploaded to the server replacing the remote file if included. 22 | - **Plus Sign:** The file does not exist and will be newly created when transferred. 23 | 24 | ### Mirror Files 25 | 26 | Files are transferred in both directions and created if missing or replaced with the newer file on either system depending on the timestamp. 27 | 28 | ### Only Download Files 29 | 30 | Files are downloaded that match one of the following criteria: 31 | 32 | - Do not exist on the local filesystem 33 | - Have a different checksum 34 | - Have a newer timestamp on the server 35 | 36 | No files are uploaded. 37 | 38 | ### Only Upload Files 39 | 40 | Files are uploaded that match one of the following criteria: 41 | 42 | - Do not exist on the server 43 | - Have a different checksum 44 | - Have a newer timestamp on the local filesystem 45 | 46 | No files are downloaded. 47 | 48 | ## Other Solutions 49 | 50 | You have to manually restart the synchronization in the transfer window. If you want to automate things you will be better off with either 51 | 52 | - [Cyberduck CLI](https://duck.sh/) which allows you to write a script and schedule it with your preferred method such as `cron`. 53 | - [Mountain Duck](https://mountainduck.io/) which allows you to mount the remote volume and synchronise files with any of your preferred tools such as `rsync`. 54 | -------------------------------------------------------------------------------- /cyberduck/upload.md: -------------------------------------------------------------------------------- 1 | Upload 2 | ==== 3 | 4 | See also [Transfers](transfer.md) in general. 5 | 6 | ## Menu File → Upload... 7 | 8 | Select *File → Upload...* to select files to upload. 9 | 10 | ## Toolbar 11 | 12 | There is a toolbar button available that you can add using *View → Customize Toolbar...*. 13 | 14 | :::{image} _images/Toolbar_Upload.png 15 | :alt: Toolbar Upload 16 | :width: 300px 17 | ::: 18 | 19 | ## Using Drag & Drop 20 | 21 | Note that dragging files is not limited to the *Finder.app*, but also works i.e. with attachments *Mail.app* or any other application supporting file promises. 22 | 23 | ### Drag to a Folder 24 | 25 | Drag the file from the *Finder.app* or *Windows Explorer* to the [browser](browser.md) window to upload to the current working directory or the folder hovered over. 26 | 27 | ### Drag to a Bookmark 28 | 29 | Upload files without first opening a connection to a server by dropping the file(s) onto a [bookmark](bookmarks.md) item in the bookmark source list. 30 | 31 | ### Local Disk Browser 32 | 33 | You can browse your local hard disk within Cyberduck and drag files to the remote browser opened in another window or tab. 34 | 35 | :::{image} _images/Connection_Popup.png 36 | :alt: Connection Popup 37 | :width: 400px 38 | ::: 39 | 40 | ### Drag to the Dock 41 | 42 | :::{admonition} macOS only 43 | :class: tip 44 | 45 | Drag files to the application icon in the `Dock` which will upload to the frontmost browser. A prompt is displayed to choose the bookmark to upload the files to (with the bookmark of the current browser selected by default if any). 46 | ::: 47 | 48 | :::{image} _images/Bookmark_Upload_Selection.png 49 | :alt: Bookmark Upload Selection 50 | :width: 400px 51 | ::: 52 | 53 | ## Using Copy & Paste 54 | 55 | Copy a file in the *Finder.app* or *Explorer* with *Edit → Copy (macOS `⌘C` Windows `Ctrl+C`)* and paste it to a browser window in Cyberduck to upload with *Edit → Paste (macOS `⌘V` Windows `Ctrl+V`)*. 56 | 57 | :::{image} _images/Paste_Files.png 58 | :alt: Paste Files 59 | :width: 300px 60 | ::: 61 | 62 | ## The Service Menu 63 | 64 | ::::{admonition} macOS only 65 | :class: tip 66 | 67 | When selecting files in the *Finder* or another application with references to files and folders, choose the item *Services → Upload* (with the Cyberduck icon) in the application menu to launch Cyberduck and upload the items selected to the bookmark you choose. This action is also available in the context menu (right-click on files or folders) in the *Finder*. 68 | 69 | :::{image} _images/Services_Upload.png 70 | :alt: Services Upload 71 | :width: 300px 72 | ::: 73 | 74 | :::: 75 | 76 | :::{note} 77 | Make sure in *System Preferences → Keyboard → Keyboard Shortcuts → Services → Files and Folders* the item *Upload with Cyberduck* is selected. 78 | ::: 79 | 80 | :::{image} _images/Upload_from_Finder.png 81 | :alt: Upload from Finder 82 | :width: 600px 83 | ::: 84 | 85 | ## Preferences 86 | 87 | ### Transfers → General → Uploads → Upload with temporary filename 88 | 89 | An option to upload with a temporary name and rename the file after the transfer is complete. An upload that is not complete, will not be renamed. This is useful for uploading to watch folders, that should only pick up a file once the upload is complete. To specify a different temporary filename pattern, use the [hidden configuration option](../tutorials/hidden_properties.md) 90 | 91 | ``` 92 | queue.upload.file.temporary.format="'{0}-{1}'" 93 | ``` 94 | 95 | where `{0}` is the original filename and `{1}` is a random UUID. The default setting uses a temporary filename of `filename-uuid`. -------------------------------------------------------------------------------- /index.md: -------------------------------------------------------------------------------- 1 | Cyberduck & Mountain Duck Help 2 | ==== 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | :caption: Cyberduck 8 | 9 | cyberduck/index 10 | ::: 11 | 12 | :::{toctree} 13 | :hidden: 14 | :titlesonly: 15 | :caption: Cyberduck CLI 16 | cli/index 17 | ::: 18 | 19 | :::{toctree} 20 | :hidden: 21 | :titlesonly: 22 | :caption: Mountain Duck 23 | mountainduck/index 24 | ::: 25 | 26 | :::{toctree} 27 | :hidden: 28 | :titlesonly: 29 | :caption: Supported Protocols 30 | protocols/index 31 | protocols/profiles/index 32 | protocols/cdn/index 33 | ::: 34 | 35 | :::{toctree} 36 | :hidden: 37 | :titlesonly: 38 | :caption: Cryptomator 39 | cryptomator/index 40 | ::: 41 | 42 | ```{toctree} 43 | :hidden: 44 | :titlesonly: 45 | :caption: Tutorials 46 | tutorials/index 47 | ``` 48 | 49 | ## Support 50 | 51 | If you have a feature request or bug to report you can open a new ticket. The pages below has all the information on how to collect relevant log files. 52 | 53 | - [Cyberduck Support](cyberduck/support.md) 54 | - [Mountain Duck Support](mountainduck/support/index.md) 55 | - [CLI Support](cli/support.md) 56 | 57 | Cyberduck Application Icon [Cyberduck](cyberduck/index.md) 58 | ---- 59 | 60 | Cyberduck is a libre server and cloud storage browser for Mac and Windows. With an easy-to-use interface, connect to servers, enterprise file sharing, and cloud storage. 61 | 62 | ### [Frequently Asked Questions (FAQ)](cyberduck/faq.md) 63 | 64 | Read more about system requirements, registration keys and incompatibilities. 65 | 66 | Mountain Duck Application Icon [Mountain Duck](mountainduck/index.md) 67 | ---- 68 | 69 | Mountain Duck lets you mount server and cloud storage as a disk in Finder on macOS and the File Explorer on Windows with a minimal User Interface and Smart Synchronisation feature that allows making files available offline. 70 | 71 | ## [Client-side Encryption (Cryptomator)](cryptomator/index.md) 72 | 73 | Support for client side encryption with Cryptomator interoperable vaults. Transparent, client-side encryption to secure your data on any server or cloud storage. Encryption for data at rest prevents unauthorized access regardless of the server or cloud storage infrastructure. 74 | 75 | ## [Command Line Interface](cli/index.md) 76 | 77 | Command Line Interface (CLI) for Mac, Windows & Linux. 78 | 79 | ## [Supported Protocols](protocols/index.md#protocols) 80 | 81 | All major server and cloud storage protocols are supported to connect to just about any server or cloud storage. 82 | -------------------------------------------------------------------------------- /mountainduck/_images/Access_Control_Lists.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Access_Control_Lists.png -------------------------------------------------------------------------------- /mountainduck/_images/Amazon_S3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Amazon_S3.png -------------------------------------------------------------------------------- /mountainduck/_images/Bookmark_Search_Input.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Bookmark_Search_Input.png -------------------------------------------------------------------------------- /mountainduck/_images/Context_Menu_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Context_Menu_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Copy_Operation_Mountain_Duck_File_Explorer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Copy_Operation_Mountain_Duck_File_Explorer.png -------------------------------------------------------------------------------- /mountainduck/_images/Copy_Operation_Mountain_Duck_Finder.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Copy_Operation_Mountain_Duck_Finder.png -------------------------------------------------------------------------------- /mountainduck/_images/Custom_Location_Sync_Cache.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Custom_Location_Sync_Cache.png -------------------------------------------------------------------------------- /mountainduck/_images/Disk_Syncing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Disk_Syncing.png -------------------------------------------------------------------------------- /mountainduck/_images/Document_in_Use_Libre_Office_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Document_in_Use_Libre_Office_macOS.png -------------------------------------------------------------------------------- /mountainduck/_images/Edit_Bookmark_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Edit_Bookmark_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Edit_Bookmark_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Edit_Bookmark_macOS.png -------------------------------------------------------------------------------- /mountainduck/_images/File_Added_Notification_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/File_Added_Notification_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/File_Updated_Notification.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/File_Updated_Notification.png -------------------------------------------------------------------------------- /mountainduck/_images/File_Updated_Notification_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/File_Updated_Notification_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/File_in_Use_Microsoft_Word_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/File_in_Use_Microsoft_Word_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/General.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/General.png -------------------------------------------------------------------------------- /mountainduck/_images/Icon_Sync_in_Progress.gif: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Icon_Sync_in_Progress.gif -------------------------------------------------------------------------------- /mountainduck/_images/Info_Panel_Versions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Info_Panel_Versions.png -------------------------------------------------------------------------------- /mountainduck/_images/Info_Window_CDN.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Info_Window_CDN.png -------------------------------------------------------------------------------- /mountainduck/_images/Info_Window_Metadata.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Info_Window_Metadata.png -------------------------------------------------------------------------------- /mountainduck/_images/Info_Window_Permissions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Info_Window_Permissions.png -------------------------------------------------------------------------------- /mountainduck/_images/Info_Window_S3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Info_Window_S3.png -------------------------------------------------------------------------------- /mountainduck/_images/Menu_Sync_in_Progress.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Menu_Sync_in_Progress.png -------------------------------------------------------------------------------- /mountainduck/_images/Metadata.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Metadata.png -------------------------------------------------------------------------------- /mountainduck/_images/Microsoft_Excel_File_Now_Available_Notification_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Microsoft_Excel_File_Now_Available_Notification_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Microsoft_Word_File_Now_Available_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Microsoft_Word_File_Now_Available_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Microsoft_Word_Read-Only_Edit_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Microsoft_Word_Read-Only_Edit_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Mountain_Duck_Finder_Context_Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Mountain_Duck_Finder_Context_Menu.png -------------------------------------------------------------------------------- /mountainduck/_images/Mountain_Duck_Screenshot_Finder_Dark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Mountain_Duck_Screenshot_Finder_Dark.png -------------------------------------------------------------------------------- /mountainduck/_images/Notification_Preferences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Notification_Preferences.png -------------------------------------------------------------------------------- /mountainduck/_images/Profiles_Preferences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Profiles_Preferences.png -------------------------------------------------------------------------------- /mountainduck/_images/Read_Only_Microsoft_Excel_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Read_Only_Microsoft_Excel_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Read_Only_Microsoft_Word_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Read_Only_Microsoft_Word_macOS.png -------------------------------------------------------------------------------- /mountainduck/_images/Read_Only_Mode_Libre_Office_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Read_Only_Mode_Libre_Office_macOS.png -------------------------------------------------------------------------------- /mountainduck/_images/Recent_Files.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Recent_Files.png -------------------------------------------------------------------------------- /mountainduck/_images/Revert_File_Context_Menu_Option_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Revert_File_Context_Menu_Option_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Screenshot_Windows_Mountain_Duck.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Screenshot_Windows_Mountain_Duck.png -------------------------------------------------------------------------------- /mountainduck/_images/Soft_Quota_Disk_Space.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Soft_Quota_Disk_Space.png -------------------------------------------------------------------------------- /mountainduck/_images/Status_Bar_Menu_Mac_Dark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Status_Bar_Menu_Mac_Dark.png -------------------------------------------------------------------------------- /mountainduck/_images/Sync_Context_Menu_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Sync_Context_Menu_macOS.png -------------------------------------------------------------------------------- /mountainduck/_images/Sync_Paused_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Sync_Paused_macOS.png -------------------------------------------------------------------------------- /mountainduck/_images/Sync_Preferences.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Sync_Preferences.png -------------------------------------------------------------------------------- /mountainduck/_images/Sync_Preferences_Win.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Sync_Preferences_Win.png -------------------------------------------------------------------------------- /mountainduck/_images/Task_Bar_Menu_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Task_Bar_Menu_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/Taskbar_Menu_Bookmark_Groups_Large_Icons_Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/Taskbar_Menu_Bookmark_Groups_Large_Icons_Windows.png -------------------------------------------------------------------------------- /mountainduck/_images/UNIX_Permissions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/UNIX_Permissions.png -------------------------------------------------------------------------------- /mountainduck/_images/alert.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/alert.png -------------------------------------------------------------------------------- /mountainduck/_images/delete.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/delete.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay-pause.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay-pause.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay_error.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay_error.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay_ignored.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay_ignored.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay_infinite.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay_infinite.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay_sync.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay_sync.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay_syncing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay_syncing.png -------------------------------------------------------------------------------- /mountainduck/_images/overlay_uptodate.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/overlay_uptodate.png -------------------------------------------------------------------------------- /mountainduck/_images/plus.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/plus.png -------------------------------------------------------------------------------- /mountainduck/_images/transfer_download.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/transfer_download.png -------------------------------------------------------------------------------- /mountainduck/_images/transfer_upload.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/_images/transfer_upload.png -------------------------------------------------------------------------------- /mountainduck/connect/online.md: -------------------------------------------------------------------------------- 1 | Online 2 | === 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | ::: 8 | 9 | > In _Online_ connect mode, changes to a file are immediately uploaded and in sync when an application has finished saving a file. Files are accessed on demand from the remote when opened and do not take up any local disk space. Files are not synchronized on local disk but only saved temporarily when required and deleted at the latest when the bookmark is disconnected. 10 | 11 | :::{tip} 12 | You can only access volumes in _Online_ connect mode when a connection is possible to the server or cloud storage. 13 | ::: 14 | 15 | :::{contents} Content 16 | :depth: 1 17 | :local: 18 | ::: 19 | 20 | ## Status of Files 21 | 22 | Files and folders on a mounted volume have a status icon overlay in _File Explorer_ (Windows) and _Finder_ (macOS). 23 | 24 | :::{admonition} macOS only 25 | :class: tip 26 | 27 | Please make sure to enable the Mountain Duck [Integration](../installation/index.md) in *System Preferences → Extensions → Finder* on macOS. For macOS Ventura and later, the setting can be found in *System Settings → Privacy & Security → Extensions → Added Extensions*. 28 | ::: 29 | 30 | ### ![](../_images/overlay_infinite.png) Online Only 31 | 32 | The file can only be opened when a connection to the server or cloud storage can be made. The file does not take any space on your computer. The file is downloaded on demand when you open it. 33 | 34 | ### ![](../_images/overlay_ignored.png) Ignored 35 | 36 | The file or folder is only saved in a local [temporary](../issues/index.md#temporary-files) location and not uploaded. This includes files matching a [temporary filename pattern](../issues/index.md#filenames), empty files and new folders. 37 | 38 | ## Transfer Progress 39 | 40 | While transferring files and folders, a transfer [progress](../interface.md#copying-files) window shows in _Finder.app_ or _Windows Explorer_. When completed, the file(s) have been uploaded to the server. 41 | 42 | ## Notifications 43 | 44 | Notifications can be posted for the following events: 45 | - **Filesystem mounted**. The volume is now connected. 46 | - **Filesystem unmounted**. The volume has been disconnected. 47 | - **Download complete**. File download completed in the background. 48 | - **Upload complete**. File upload completed in the background. 49 | 50 | You can adjust which notifications you want to receive in [*Preferences → Notifications*](../preferences.md#notifications). 51 | 52 | ## Connectivity Issues 53 | 54 | Network problems and quota or authentication failures will cause the mounted volume to be disconnected. When enabled in *Preferences → Connection → Confirm disconnect* a disconnect prompt is shown. 55 | 56 | ### Auto Unmount on Connection Error 57 | 58 | To disable the unmount upon failure use a [hidden configuration option](../../tutorials/hidden_properties.md) `unmount.auto=false`. 59 | -------------------------------------------------------------------------------- /mountainduck/cryptomator.md: -------------------------------------------------------------------------------- 1 | Cryptomator 2 | ==== 3 | 4 | :::{tip} 5 | You do not need to have _Cryptomator for macOS or Windows_ installed to access vaults using Mountain Duck. 6 | ::: 7 | 8 | Mountain Duck includes support to create and access Cryptomator interoperable vaults. Refer to the [documentation](../cryptomator/index.md). -------------------------------------------------------------------------------- /mountainduck/index.md: -------------------------------------------------------------------------------- 1 | Mountain Duck 2 | ==== 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | installation/index 8 | interface 9 | connect/index 10 | info 11 | share 12 | locking 13 | versions 14 | cryptomator 15 | preferences 16 | issues/index 17 | support/index 18 | ::: 19 | 20 | Cyberduck for mounting volumes in the file explorer is available for Mac & Windows. 21 | 22 | > Mountain Duck lets you mount server and cloud storage as a disk in Finder on macOS and the File Explorer on Windows. Open remote files with any application and work like on a local volume. Transfer files using Finder to remote servers, fast. 23 | 24 | ## [Installation](installation/index.md) 25 | 26 | Refer to our installation instructions. 27 | 28 | ## [Licensing](support/licensing.md) 29 | 30 | Refer to our licensing FAQ. 31 | 32 | ## [User Interface](interface.md) 33 | 34 | Mountain Duck runs in the *status bar* on macOS and *tray area* on Windows. Refer to our user interface documentation. 35 | 36 | ## [Connect Mode](connect/index.md) 37 | 38 | Choose between different connect modes based on use case and available disk space. 39 | 40 | ## [Info Window](info.md) 41 | 42 | Edit access permissions and configure [CDN](../protocols/cdn/index.md) options. 43 | 44 | ## [Share](share.md) 45 | 46 | Share files with others using signed or temporary URLs. 47 | 48 | ## [Client-Side Encryption](../cryptomator/index.md) 49 | 50 | Support for client-side encryption with Cryptomator interoperable vaults. 51 | 52 | ## [File Locking](locking.md) 53 | 54 | Support for locking files to prevent conflicting edits from others while a document is open in an editor. 55 | 56 | ## [File Versioning](versions.md) 57 | 58 | You can preview and revert previous versioned bucket in [Amazon S3](../protocols/s3/index.md) 59 | 60 | ## [Cryptomator](cryptomator.md) 61 | 62 | Support for client-side encryption with Cryptomator interoperable vaults. 63 | 64 | ## [Preferences](preferences.md) 65 | 66 | ## [Known Issues & Workarounds](issues/index.md) 67 | -------------------------------------------------------------------------------- /mountainduck/info.md: -------------------------------------------------------------------------------- 1 | :::{include} ../cyberduck/info.md 2 | ::: -------------------------------------------------------------------------------- /mountainduck/installation/_images/Login_Item.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/installation/_images/Login_Item.png -------------------------------------------------------------------------------- /mountainduck/installation/_images/Mountain_Duck_Finder_Integration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/installation/_images/Mountain_Duck_Finder_Integration.png -------------------------------------------------------------------------------- /mountainduck/installation/_images/Mountain_Duck_Windows_Installer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/mountainduck/installation/_images/Mountain_Duck_Windows_Installer.png -------------------------------------------------------------------------------- /mountainduck/share.md: -------------------------------------------------------------------------------- 1 | :::{include} ../cyberduck/share.md 2 | ::: -------------------------------------------------------------------------------- /mountainduck/versions.md: -------------------------------------------------------------------------------- 1 | File Versions 2 | ==== 3 | 4 | :::{note} 5 | Mountain Duck 4.12 or later required. Previously versions could be accessed from 6 | the [context menu](interface.md#context-menu-in-finder-and-windows-file-explorer) by right-clicking on a file in 7 | *Finder* on macOS or *File Explorer* on Windows and choosing *Versions*. 8 | ::: 9 | 10 | A list of file versions can be viewed within the *Versions* tab of the *[Info](../cyberduck/info.md#versions)* window. 11 | The files can also be reverted to a chosen version of the list. 12 | 13 | ## Supported Protocols 14 | 15 | The versions feature within the *Info* window is supported for the following protocols: 16 | 17 | | **Protocol** | **Revert previous version** | **Open/Quick Look previous version** | **Delete version** | 18 | |----------------------------------------------------------|-----------------------------|--------------------------------------|--------------------| 19 | | [Nextcloud & ownCloud](../protocols/webdav/nextcloud.md) | ✅ | ✅ | ❌ | 20 | | | 21 | | [S3](../protocols/s3/index.md) | ✅ | ✅ | ✅ | 22 | | [Google Storage](../protocols/googlecloudstorage.md) | ✅ | ✅ | ✅ | 23 | | [Backblaze B2](../protocols/b2.md) | ✅ | ✅ | ✅ | 24 | | | 25 | | [Microsoft OneDrive](../protocols/onedrive.md) | ✅ | ✅ | ❌ | 26 | | [Microsoft Sharepoint](../protocols/sharepoint.md) | ❌ | ✅ | ❌ | 27 | | [Google Drive](../protocols/googledrive.md) | ❌ | ✅ | ✅ | 28 | | [Dropbox](../protocols/dropbox.md) | ✅ | ✅ | ❌ | 29 | | | 30 | | [DRACOON](../protocols/dracoon.md) | ✅ | ❌ | ✅ | 31 | 32 | :::{attention} 33 | Using [S3](../protocols/s3/index.md) versions will only be displayed for buckets with versioning enabled. Versioning can 34 | be enabled per bucket in by choosing *Info → S3* in *Finder* on macOS or *File Explorer* on Windows. Alternatively, 35 | enable versioning in AWS Console or [Cyberduck](../cyberduck/index.md). 36 | ::: 37 | 38 | ### Revert 39 | 40 | You can revert to a previous version of a file by choosing *Versions → ... → Revert*. Wait for the *File Updated* 41 | notification which notifies the previous version has been restored. 42 | 43 | :::{image} _images/File_Updated_Notification_Windows.png 44 | :alt: File Updated Notification (Windows) 45 | :width: 400px 46 | ::: 47 | 48 | ### Delete 49 | 50 | Permanently delete a previous version of the selected file. 51 | 52 | ### Preview 53 | 54 | This will open a *Quick Look preview* on macOS or open the previous version of the file in the default application on 55 | Windows. 56 | -------------------------------------------------------------------------------- /protocols/_images/10GbE_Transfer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/10GbE_Transfer.png -------------------------------------------------------------------------------- /protocols/_images/AuthenticationAdmin.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/AuthenticationAdmin.png -------------------------------------------------------------------------------- /protocols/_images/Azure_ACLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Azure_ACLs.png -------------------------------------------------------------------------------- /protocols/_images/Azure_Shared_Access_Signature_URLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Azure_Shared_Access_Signature_URLs.png -------------------------------------------------------------------------------- /protocols/_images/Azure_tab_info_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Azure_tab_info_macOS.png -------------------------------------------------------------------------------- /protocols/_images/B2_Bucket_ACL.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/B2_Bucket_ACL.png -------------------------------------------------------------------------------- /protocols/_images/B2_Bucket_Type.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/B2_Bucket_Type.png -------------------------------------------------------------------------------- /protocols/_images/B2_Large_File_Upload.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/B2_Large_File_Upload.png -------------------------------------------------------------------------------- /protocols/_images/B2_application_key_LI.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/B2_application_key_LI.jpg -------------------------------------------------------------------------------- /protocols/_images/B2_icon_128x128.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/B2_icon_128x128.png -------------------------------------------------------------------------------- /protocols/_images/B2_tab_info_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/B2_tab_info_macOS.png -------------------------------------------------------------------------------- /protocols/_images/Cache_Retry.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Cache_Retry.png -------------------------------------------------------------------------------- /protocols/_images/Compress.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Compress.png -------------------------------------------------------------------------------- /protocols/_images/DRACOON_Download_Share.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/DRACOON_Download_Share.png -------------------------------------------------------------------------------- /protocols/_images/Dropbox_Authorization_Code.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Dropbox_Authorization_Code.png -------------------------------------------------------------------------------- /protocols/_images/Dropbox_Link.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Dropbox_Link.png -------------------------------------------------------------------------------- /protocols/_images/Dropbox_Permissions.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Dropbox_Permissions.png -------------------------------------------------------------------------------- /protocols/_images/GCS_tab_info_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/GCS_tab_info_macOS.png -------------------------------------------------------------------------------- /protocols/_images/Google_Drive_OAuth_2_Authentication_Code_Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Google_Drive_OAuth_2_Authentication_Code_Prompt.png -------------------------------------------------------------------------------- /protocols/_images/Google_Storage_ACLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Google_Storage_ACLs.png -------------------------------------------------------------------------------- /protocols/_images/Google_Storage_Access_Log_Configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Google_Storage_Access_Log_Configuration.png -------------------------------------------------------------------------------- /protocols/_images/Kex_Timeout.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Kex_Timeout.png -------------------------------------------------------------------------------- /protocols/_images/Limit_Number_of_Transfers.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Limit_Number_of_Transfers.png -------------------------------------------------------------------------------- /protocols/_images/Microsoft_OneDrive_OAuth_Authorization.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Microsoft_OneDrive_OAuth_Authorization.png -------------------------------------------------------------------------------- /protocols/_images/OneDrive_OAuth_2_Authorization.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/OneDrive_OAuth_2_Authorization.png -------------------------------------------------------------------------------- /protocols/_images/OneDrive_Sign_In.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/OneDrive_Sign_In.png -------------------------------------------------------------------------------- /protocols/_images/Preferences_Profiles.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Preferences_Profiles.png -------------------------------------------------------------------------------- /protocols/_images/Preferences_Profiles_macOS.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Preferences_Profiles_macOS.png -------------------------------------------------------------------------------- /protocols/_images/Project_ID_Bookmark_Configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Project_ID_Bookmark_Configuration.png -------------------------------------------------------------------------------- /protocols/_images/SMB_Connection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/SMB_Connection.png -------------------------------------------------------------------------------- /protocols/_images/SMB_Share.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/SMB_Share.png -------------------------------------------------------------------------------- /protocols/_images/Terminal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Terminal.png -------------------------------------------------------------------------------- /protocols/_images/Unknown_host_key.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Unknown_host_key.png -------------------------------------------------------------------------------- /protocols/_images/Unsecured_connection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Unsecured_connection.png -------------------------------------------------------------------------------- /protocols/_images/Use_parallel_transfer_option.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Use_parallel_transfer_option.png -------------------------------------------------------------------------------- /protocols/_images/Verification_Code_Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Verification_Code_Prompt.png -------------------------------------------------------------------------------- /protocols/_images/Windows-Security-Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/Windows-Security-Prompt.png -------------------------------------------------------------------------------- /protocols/_images/azure.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/azure.png -------------------------------------------------------------------------------- /protocols/_images/box.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/box.png -------------------------------------------------------------------------------- /protocols/_images/command.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/command.png -------------------------------------------------------------------------------- /protocols/_images/dracoon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/dracoon.png -------------------------------------------------------------------------------- /protocols/_images/dropbox.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/dropbox.png -------------------------------------------------------------------------------- /protocols/_images/ftp.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/ftp.png -------------------------------------------------------------------------------- /protocols/_images/googledrive.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/googledrive.png -------------------------------------------------------------------------------- /protocols/_images/googlestorage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/googlestorage.png -------------------------------------------------------------------------------- /protocols/_images/onedrive.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/onedrive.png -------------------------------------------------------------------------------- /protocols/_images/putty.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/putty.png -------------------------------------------------------------------------------- /protocols/_images/spectra_128x128.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/_images/spectra_128x128.png -------------------------------------------------------------------------------- /protocols/box.md: -------------------------------------------------------------------------------- 1 | Box.com 2 | ==== 3 | 4 | :::{image} _images/box.png 5 | :alt: Box Drive Icon 6 | :width: 128px 7 | ::: 8 | 9 | :::{tip} 10 | Download [Mountain Duck](https://mountainduck.io/) as an alternative to *Box Drive*. 11 | ::: 12 | 13 | > [Box](https://box.com/) Simple, secure file sharing and collaboration from anywhere. 14 | 15 | ## Connecting 16 | 17 | Use the default *Box* connection profile to connect to your server using the Box API. This allows to have Multi-Factor Authentication enabled for your account. 18 | 19 | ### Alternate Connection Options 20 | 21 | #### FTP 22 | 23 | :::{important} 24 | Only available for Box business and enterprise accounts 25 | ::: 26 | 27 | Enter the following information in the [bookmark](../cyberduck/bookmarks.md): 28 | 29 | - **Protocol**: `FTP` or `FTPS` 30 | - **Server**: `ftp.box.com` 31 | - **Username**: Your Box account email address 32 | - **Password**: Your Box account password 33 | 34 | #### WebDAV 35 | 36 | :::{warning} 37 | Box WebDAV support reached end-of-life at October 25th, 2019 38 | ::: 39 | 40 | 1. {download}`Download` the *Box Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 41 | 2. Enter your email address for the username. 42 | 43 | Alternatively, enter the following information in the [bookmark](../cyberduck/bookmarks.md): 44 | 45 | - **Protocol**: `WebDAV (HTTPS)` 46 | - **Server**: `dav.box.com` 47 | - **Username**: Your Box account email address 48 | - **Password**: Your Box account password 49 | - **Path**: `dav` 50 | 51 | ## Share 52 | 53 | :::{note} 54 | Only available using the default *Box* connection profile. 55 | ::: 56 | 57 | Create download [shares](../cyberduck/share.md#box) of files or folders for people who are not Box users by using *File → Share...*. 58 | 59 | ## Known Limitations 60 | 61 | ### Modification Date 62 | 63 | The modification date retention is supported for new files uploaded but without the option to adjust the modification date later. 64 | 65 | ## References 66 | 67 | - [WebDAV with Box](https://support.box.com/hc/en-us/articles/360043696414-WebDAV-with-Box) 68 | - [Using Box with FTP or FTPS](https://support.box.com/hc/en-us/articles/360043697414-Using-Box-with-FTP-or-FTPS) 69 | -------------------------------------------------------------------------------- /protocols/cdn/_images/Akamai_CDN_Configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/cdn/_images/Akamai_CDN_Configuration.png -------------------------------------------------------------------------------- /protocols/cdn/_images/Akamai_Distribution.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/cdn/_images/Akamai_Distribution.png -------------------------------------------------------------------------------- /protocols/cdn/_images/CDN_Custom_Origin_Server.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/cdn/_images/CDN_Custom_Origin_Server.png -------------------------------------------------------------------------------- /protocols/cdn/_images/CloudFront_Configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/cdn/_images/CloudFront_Configuration.png -------------------------------------------------------------------------------- /protocols/cdn/_images/Copy_URLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/cdn/_images/Copy_URLs.png -------------------------------------------------------------------------------- /protocols/cdn/_images/Custom_Origin_CDN.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/cdn/_images/Custom_Origin_CDN.png -------------------------------------------------------------------------------- /protocols/cdn/akamai.md: -------------------------------------------------------------------------------- 1 | Akamai (CDN) Support 2 | ==== 3 | 4 | Akamai is the [CDN provider for Rackspace Cloudfiles](https://www.rackspace.com/openstack/public/cdn-content-delivery-network). A container can be enabled for *Akamai* in the *Distribution (CDN)* tab of the [Info](../../cyberduck/info.md) panel. 5 | 6 | ![Akamai CDN Configuration](_images/Akamai_CDN_Configuration.png) 7 | 8 | ## Basic (Download HTTP) Distributions 9 | 10 | Used to serve static content. The files you elect to be public are shared out over a content distribution network with locations all over the world. The first time your content is served to a worldwide user (one in Tokyo, for example), a copy of the content will be stored in cache on the edge servers in that location. The next time the content is requested, it's pulled directly from the cached copy on the edge servers, dramatically reducing delivery time. 11 | 12 | **Example Configuration:**
13 | ![Akamai Distribution](_images/Akamai_Distribution.png) 14 | 15 | ## Deployment Status 16 | 17 | The configuration updates are fully propagated status switches to *CDN Enabled*. 18 | 19 | ## Distribution Access Logging 20 | 21 | When this option is enabled in the *File → Info → Distribution (CDN)* panel of a container, access logs are written to `/.CDN_ACCESS_LOGS`. Use *View → Show Hidden Files* to access the `*.gz` log files. 22 | 23 | ## Invalidation 24 | 25 | To force the CDN to refetch the files from the container source, you can invalidate (aka purge) objects from edge locations. Use the *Invalidate* option *File → Info → Distribution (CDN)* to remove objects or the entire container from the CDN cache. 26 | 27 | ## Index File 28 | 29 | You can assign a default root object for your distribution. This default object will be served when Akamai receives a request for the root of your distribution – i.e., your distribution’s domain name by itself. 30 | 31 | ## URLs 32 | 33 | You can access all URLs (including from CDN configurations) from the menu *Edit → Copy URL* and *File → Open URL*. 34 | 35 | :::{note} 36 | You must first open *File → Info → Distribution (CDN)* before these URLs are available. 37 | ::: 38 | 39 | ![Copy URL](_images/Copy_URLs.png) 40 | 41 | ## References 42 | 43 | - [Content Delivery Network|CDN by Rackspace](https://www.rackspace.com/openstack/public/cdn-content-delivery-network) 44 | - [Rackspace Launches New Content Delivery Networking Service with Akamai](https://www.rackspace.com/newsroom/rackspace-launches-new-content-delivery-networking-service-with-akamai) 45 | - [Quickstart for Rackspace CDN](https://developer.rackspace.com/docs/cdn/quickstart/) 46 | - [Rackspace CDN concepts](https://developer.rackspace.com/docs/cdn/v1/getting-started/concepts/) -------------------------------------------------------------------------------- /protocols/cdn/index.md: -------------------------------------------------------------------------------- 1 | Content Delivery Network (CDN) Configuration 2 | ==== 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | akamai 8 | cloudfront 9 | keycdn 10 | ::: 11 | 12 | A content delivery network or content delivery network (CDN) allows the distribution of files from locations all over the world using a network of edge locations. Requests for files are automatically routed to the nearest edge location. Two of the main market players are supported from within Cyberduck with a simple to use interface to enable distributions with a single click of a button. 13 | 14 | Using the [Info](../../cyberduck/info.md) panel, the following content distribution networks (CDN) can be enabled: 15 | 16 | - [Amazon CloudFront](cloudfront.md) 17 | - [Akamai](akamai.md) 18 | - [KeyCDN](keycdn.md) 19 | 20 | ## Logging & Analytics 21 | 22 | Configuration for the delivery of access logs can be configured from within Cyberduck in the [Info window](../../cyberduck/info.md) for [S3](../s3/index.md), [Google Cloud Storage](../googlecloudstorage.md) and [Amazon CloudFront](cloudfront.md) CDN distributions. The server create a massive amount of log files which is best analyzed with a third-party service. 23 | 24 | ## Amazon CloudFront 25 | 26 | - Add a download or streaming CDN configuration to your [S3](../s3/index.md) bucket. 27 | - Connect to any server using FTP, SFTP or WebDAV and configure it as the origin of a new [Amazon CloudFront](cloudfront.md) CDN distribution. 28 | 29 | ## Akamai 30 | 31 | When connected to [Rackspace Cloudfiles](../openstack/cloudfiles.md), configure [Akamai](akamai.md) content distribution. 32 | -------------------------------------------------------------------------------- /protocols/cdn/keycdn.md: -------------------------------------------------------------------------------- 1 | KeyCDN 2 | ==== 3 | 4 | > [KeyCDN](https://www.keycdn.com/) is the leading European content delivery network. The CDN already supports HTTP/2 and consists of 24+ points of presence (POPs) around the world. KeyCDN does not charge extra for HTTPS traffic or HTTP requests. The pricing model is transparent and purely pay-as-you-go. No monthly fee. 5 | 6 | ## KeyCDN Features 7 | 8 | KeyCDN offers a state-of-the-art features: 9 | - Full [HTTP/2](https://www.keycdn.com/blog/keycdn-http2-support/) support for all customers 10 | - [Free Custom SSL based on Let's Encrypt](https://www.keycdn.com/support/use-letsencrypt-with-keycdn-to-enable-ssl-tls/) 11 | - [Raw logs](https://www.keycdn.com/support/cdn-log-format/) in real time. 12 | - CDN changes in near-realtime: Any change or update of a KeyCDN zone is globally provisioned within minutes 13 | - Free WordPress plugins developed by KeyCDN: [CDN Enabler](https://wordpress.org/plugins/cdn-enabler/) and [Cache Enabler](https://wordpress.org/plugins/cache-enabler/) 14 | - File browser for push zones: Any content of y push zone can be browsed within the KeyCDN dashboard. 15 | 16 | ## Content Delivery with a KeyCDN Push Zone 17 | 18 | ### Free Trial Account Including $10 19 | 20 | KeyCDN offers a free trial account for all Cyberduck users preloaded with \$10. The whole feature set of KeyCDN is available during the test phase. Sign up for free [KeyCDN trial account](https://www.keycdn.com/?a=7) including $10 worth 250 GB of traffic. 21 | 22 | ### Creating a KeyCDN Push Zone 23 | 24 | A KeyCDN [push zone](https://www.keycdn.com/support/create-a-push-zone/) is needed in order to use Cyberduck and upload content to a zone. 25 | 26 | ### KeyCDN Configuration 27 | 28 | Once a KeyCDN push zone has been created. Connect with Cyberduck to your push zone. Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 29 | 30 | - Protocol: `FTP-SSL (Explicit AUTH TLS)` 31 | - Server: `ftp.keycdn.com` 32 | - Port: `21` 33 | - Username: The same username as used for the KeyCDN dashboard 34 | - Password: Same as used for the KeyCDN dashboard 35 | 36 | ## KeyCDN Tools 37 | 38 | KeyCDN offers a wide variety of tools along with the CDN that can be used: 39 | 40 | - Analyze a website performance with the [KeyCDN Speed Test](https://tools.keycdn.com/speed) 41 | - Locate IPs worldwide with [IP Location Finder](https://tools.keycdn.com/geo) 42 | - Check if a website is ready for HTTP/2 with the [KeyCDN HTTP/2 Test](https://tools.keycdn.com/http2-test) 43 | - Examine HTTP headers with [Curl Test](https://tools.keycdn.com/curl) -------------------------------------------------------------------------------- /protocols/dracoon.md: -------------------------------------------------------------------------------- 1 | DRACOON 2 | ==== 3 | 4 | Cloud service made in Germany. DRACOON as a Cloud Service in ISO 27001 certified data centers. 5 | 6 | :::{image} _images/dracoon.png 7 | :alt: DRACOON Drive Icon 8 | :width: 128px 9 | ::: 10 | 11 | > [DRACOON](https://www.dracoon.com/en/home#) is a highly secure, platform-independent enterprise file sharing solution, which has repeatedly won awards as a market leader. It is certified according to the highest compliance guidelines. Unique to the solution is the own developed TripleCrypt technology with end-to-end encryption as well as the authorization system for high demands in the enterprise business environment. 12 | 13 | ## Free Account 14 | 15 | Open a [free account](https://www.dracoon.com/en/free) with 10 users including 10 GB of storage. 16 | 17 | > With DRACOON, you opt for a highly secure enterprise file sync and share solution that is made and hosted in Germany. Try the full version of our business cloud storage free of charge. 18 | 19 | ## Connecting 20 | 21 | - {download}`Download` the *DRACOON (OAuth) connection profile*. 22 | - {download}`Download` the *DRACOON (OAuth Password Flow) connection profile*. 23 | 24 | :::{note} 25 | The DRACOON (OAuth) connection profile is bundled by default with Cyberduck. 26 | ::: 27 | 28 | ### Authentication With Username and Password 29 | 30 | To authenticate with your username and password, use the _DRACOON (OAuth Password Flow)_ profile. Instead of retrieving an authentication code by logging in using a web browser, the profile uses the OAuth password flow to authenticate. This is most useful when working with [Cyberduck CLI](https://duck.sh/). 31 | 32 | ## Client-Side Encryption 33 | 34 | The client-side encryption technology Triple-Crypt of DRACOON is fully supported to upload files to encrypted data rooms. 35 | 36 | ## Download Share 37 | 38 | Choose *File → Share…* to create a download share for a file. Default settings apply with no expiration. 39 | 40 | ![Create Download Share](_images/DRACOON_Download_Share.png) 41 | 42 | ## Versioning 43 | 44 | A list of file versions can be viewed within the *Versions* panel of the *[Info](../cyberduck/info.md)* window. Files can be reverted to a chosen version of this list. Additionally, versions of the list can be deleted. 45 | 46 | 47 | ## References 48 | - [Encryption](https://cloud.support.dracoon.com/hc/en-us/articles/115001832709-Encryption) -------------------------------------------------------------------------------- /protocols/files.com.md: -------------------------------------------------------------------------------- 1 | Files.com 2 | ==== 3 | 4 | > [Files.com](https://www.files.com/) is one single API and App for all the Files in your business, no matter where they live. 5 | 6 | ## Connecting 7 | 8 | ### REST API 9 | 10 | The connection profile allows to login using the *Files.com REST API* supporting two-factor authentication. 11 | 12 | - {download}`Download` the *Files.com Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 13 | 14 | ### Manual Configuration 15 | 16 | #### FTPS 17 | 18 | Enter the following information in the [bookmark](../cyberduck/bookmarks.md): 19 | 20 | - **Protocol**: `FTP-SSL (Explicit AUTH TLS)` 21 | - **Server**: `app.files.com` 22 | - **Username**: Your Files.com username 23 | - **Password**: Your Files.com password 24 | 25 | #### WebDAV 26 | 27 | Enter the following information in the [bookmark](../cyberduck/bookmarks.md): 28 | 29 | - **Protocol**: `WebDAV (HTTPS)` 30 | - **Server**: `.files.com` 31 | - **Username**: Your Files.com username 32 | - **Password**: Your Files.com password 33 | 34 | ## References 35 | 36 | - [Connecting via FTP/FTPS](https://www.files.com/docs/integrations/ftp-ftps) 37 | - [Connecting via WebDAV](https://www.files.com/docs/integrations/webdav) -------------------------------------------------------------------------------- /protocols/openstack/_images/Auro_Logo.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/Auro_Logo.jpg -------------------------------------------------------------------------------- /protocols/openstack/_images/Cloud.ca_logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/Cloud.ca_logo.png -------------------------------------------------------------------------------- /protocols/openstack/_images/Copy_URLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/Copy_URLs.png -------------------------------------------------------------------------------- /protocols/openstack/_images/Create_Container.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/Create_Container.png -------------------------------------------------------------------------------- /protocols/openstack/_images/Memset_Logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/Memset_Logo.png -------------------------------------------------------------------------------- /protocols/openstack/_images/Memstore.Swift.Config.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/Memstore.Swift.Config.png -------------------------------------------------------------------------------- /protocols/openstack/_images/OVH_Public_Cloud_Storage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/OVH_Public_Cloud_Storage.png -------------------------------------------------------------------------------- /protocols/openstack/_images/blue-128.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/blue-128.png -------------------------------------------------------------------------------- /protocols/openstack/_images/candy-drive-removable-media-zetta.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/candy-drive-removable-media-zetta.png -------------------------------------------------------------------------------- /protocols/openstack/_images/cloudfiles_icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/cloudfiles_icon.png -------------------------------------------------------------------------------- /protocols/openstack/_images/cropped-cloudA_transparent_temp_oldsite1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/cropped-cloudA_transparent_temp_oldsite1.png -------------------------------------------------------------------------------- /protocols/openstack/_images/entercloudsuite.com.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/entercloudsuite.com.png -------------------------------------------------------------------------------- /protocols/openstack/_images/swift.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/swift.png -------------------------------------------------------------------------------- /protocols/openstack/_images/swiftstack.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/openstack/_images/swiftstack.png -------------------------------------------------------------------------------- /protocols/openstack/auro.md: -------------------------------------------------------------------------------- 1 | AURO 2 | ==== 3 | 4 | :::{image} _images/Auro_Logo.jpg 5 | :alt: AURO Logo 6 | :height: 128px 7 | ::: 8 | 9 | > AURO is 100% Canadian owned and operated provider of public cloud infrastructure based on OpenStack. 10 | 11 | ## Connecting 12 | 13 | - **Protocol**: `Swift (OpenStack Object Storage)` 14 | - **Server**: `api.van1.auro.io` 15 | - **Port**: `5000` 16 | - **Username**: `:` 17 | - **Password**: `` 18 | 19 | The server name is found in the Cloud Dashboard under `Project/Compute/Access & Security/API Access`. Use the Identity server, not the Object Store server. 20 | 21 | The username is a concatenation of your OpenStack tenant name and OpenStack user name. These values can be found in your [OpenStack RC file](https://login.van1.auro.io/project/access_and_security/api_access/openrc/). 22 | 23 | ## References 24 | 25 | - [Swift Usage](https://www.auro.io/support/CLI/swift/) -------------------------------------------------------------------------------- /protocols/openstack/cloud.ca.md: -------------------------------------------------------------------------------- 1 | Cloud.ca Object Storage 2 | ==== 3 | 4 | ![Cloud.ca Logo](_images/Cloud.ca_logo.png) 5 | 6 | > Cloud.ca object store is providing cloud storage services with the data located in Canada and powered by renewable energy. The Object store is running on Openstack Swift technology and the infrastructure has been designed for performance and reliability. For additional information please visit [Cloud.ca](http://www.cloud.ca/). 7 | 8 | ## Connecting 9 | 10 | ### Connection Profile 11 | 12 | {download}`Download` the *Cloud.ca Object Store East-1 Region Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 13 | 14 | ### Manual Configuration 15 | 16 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 17 | 18 | - **Protocol**: `OpenStack` 19 | - **Server**: `objects.east-1.cloud.ca` 20 | - **Port**: `443` 21 | - **Username**: Account Name 22 | - **Password**: API Key -------------------------------------------------------------------------------- /protocols/openstack/clouda.md: -------------------------------------------------------------------------------- 1 | Cloud A 2 | ==== 3 | 4 | :::{image} _images/cropped-cloudA_transparent_temp_oldsite1.png 5 | :alt: Cloud A Logo 6 | :height: 128px 7 | ::: 8 | 9 | > [Cloud-A](https://www.clouda.ca/cloud-infrastructure#cloud_servers) is a leading provider of public cloud Infrastructure based in Canada. Our products automate & simplify the installation and management of the hardware and software that provides the infrastructure for large-scale environments having hundreds or thousands of servers supporting high-performance compute applications. 10 | 11 | ## Connecting 12 | 13 | - **Protocol**: `Swift (OpenStack Object Storage)` 14 | - **Server**: `keystone.ca-ns-1.clouda.ca` 15 | - **Port**: `8443` 16 | - **Username**: Email (Cloud-A login username) 17 | - **Password**: Cloud-A login password 18 | 19 | ## References 20 | 21 | - [Authenticate Bulk Storage with Cyberduck](https://www.clouda.ca/blog/general/cyberduck-bulk-storage/) 22 | - [Knowledge Base](http://docs.clouda.ca/bulk-storage/cyberduck) -------------------------------------------------------------------------------- /protocols/openstack/entercloudsuite.md: -------------------------------------------------------------------------------- 1 | Enter Cloud Suite Object Storage 2 | ==== 3 | 4 | > [Enter Cloud Suite Object Storage](https://www.entercloudsuite.com/en/) a Pay-Per-Use Storage provides IaaS public object storage that you can use to archive large amounts of data in a variety of formats in the cloud. You only pay for the space and time you use – starting at 0.075€ per Gb per month – and can even archive data for very short periods of time. 5 | 6 | ## Connecting 7 | 8 | ### Connection Profile 9 | 10 | - {download}`Download` the *Enter Cloud Suite (Keystone) Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 11 | 12 | Use the Tenant ID `email` and password to login. See [API Access](https://cm.entercloudsuite.com/project/access_and_security/). 13 | 14 | ![Enter Cloud Suite](_images/entercloudsuite.com.png) 15 | 16 | ### Manual Configuration 17 | 18 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 19 | 20 | - **Protocol**: `Swift (OpenStack Object Storage)` 21 | - **Server**: `api.entercloudsuite.com` 22 | - **Port**: `443` 23 | - **Username**: *Enter Cloud Suite* `credentials email` 24 | - **Password**: *Enter Cloud Suite* `credentials password` 25 | - **Tenant**: `Tenant ID` from the [OpenStack RC File](https://cm.entercloudsuite.com/project/access_and_security/). -------------------------------------------------------------------------------- /protocols/openstack/flexcloud.md: -------------------------------------------------------------------------------- 1 | OpenStack FlexCloud 2 | ==== 3 | 4 | > [OpenStack FlexCloud](https://www.green.ch/de-ch/greencloud/openstackflexcloud/flexcloudservices.aspx) bietet Ihnen Schweizer Infrastruktur mit maximaler Flexibilität. 5 | 6 | An OpenStack installation by [green.ch](https://green.ch/). 7 | 8 | ## Connecting 9 | 10 | Connect using the preconfigured connection profile. 11 | - {download}`Download` the *FlexCloud Connection Profile* or install it from *Preferences… → Profiles*. 12 | 13 | ## Resources 14 | 15 | - [Flex Cloud Quickstart Guide](https://www.green.ch/de-ch/Support/TechnischerSupport/Helpdesk/TabId/1544/ArtMID/6180/ArticleID/315/Flex-Cloud-Quickstart-Guide.aspx) 16 | - Technischer Support [Container Storage mit Cyberduck verwalten](http://www.green.ch/de-ch/Support/TechnischerSupport/Helpdesk/TabId/1544/ArtMID/6180/ArticleID/349/Container-Storage-mit-Cyberduck-verwalten.aspx?language=de-CH#1) -------------------------------------------------------------------------------- /protocols/openstack/hubic.md: -------------------------------------------------------------------------------- 1 | hubiC 2 | ==== 3 | 4 | > hubiC, the online storage solution, was developed by the OVH group, a French company specialised in data hosting. Datacentres in France: Roubaix, Gravelines and Strasbourg. 5 | 6 | ## Connecting 7 | 8 | hubiC is using [OpenStack Swift](index.md) APIs for its storage service but requires additional authentication using OAuth 2.0 to access the service. 9 | 10 | ### OAuth 2.0 Authentication 11 | 12 | Connect using the OAuth 2.0 connection profile: 13 | 14 | - {download}`Download` the *hubiC Cyberduck Connection Profile* or install it from *Preferences… → Profiles*. 15 | 16 | ### Gateway for Authentication 17 | 18 | Use the [Openstack Swift (v1) profile](index.md) together with an authentication gateway. 19 | 20 | - [HubiC to OpenStack Swift Gateway](https://github.com/oderwat/hubic2swiftgate) 21 | - [Node hubiC Swift Authentication](https://github.com/gierschv/node-hubic-swiftauth) 22 | 23 | ## Known Issues 24 | 25 | - Interoperability with hubiC (OVH) (Issue [#7764](https://github.com/iterate-ch/cyberduck/issues/7764)) -------------------------------------------------------------------------------- /protocols/openstack/internap.md: -------------------------------------------------------------------------------- 1 | Internap AgileFILES 2 | ==== 3 | 4 | Sign up for [Internap AgileCLOUD (includes AgileFILES object storage)](https://agile.internap.com/signup/register?utm_source=wiki&utm_medium=referral&utm_campaign=cyberduck). 5 | 6 | ## Connecting 7 | 8 | ### Connection Profile 9 | 10 | {download}`Download` the *Internap AgileFILES Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 11 | 12 | ### Manual Configuration 13 | 14 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 15 | 16 | - **Protocol**: `OpenStack` 17 | - **Server**: `auth.storage.santa-clara.internapcloud.net` 18 | - **Port**: `443` 19 | - **Username**: account/client login name 20 | - **Password**: your client password 21 | 22 | For more user information please log in to the [Internap Customer Portal](https://login.internap.com/). -------------------------------------------------------------------------------- /protocols/openstack/memset.md: -------------------------------------------------------------------------------- 1 | Memset Object Storage 2 | ==== 3 | 4 | ![Memset Logo](_images/Memset_Logo.png) 5 | 6 | > Memset Memstore is an exciting new long-term storage solution. Based on the OpenStack Object Storage platform, combined with our own impressive infrastructure, Memstore™ is flexible, scalable, easy to use, and secure. We take care of the details from disk space to backups; you simply drag and drop your files and leave everything else to us. You only pay for what you use, whether that be 1GB or 1TB, and there are no license fees or hidden costs. Data replication means that your data is unaffected by hardware failures and you can sleep soundly knowing your data is safe with us. 7 | 8 | **Free 5GB Account**
9 | Sign up for a free account that comes with 5GB of storage and 5GB of transfer per month [Memset Object Storage](https://www.memset.com/services/object-storage/). 10 | 11 | ## Connecting 12 | 13 | :::{note} 14 | Connection profiles can be installed from *Preferences → Profiles*. 15 | ::: 16 | 17 | ### Connection Profile 18 | 19 | #### Memset 1.0 20 | 21 | {download}`Download` the *Memset (1.0) Profile* for preconfigured settings. 22 | 23 | Use your Memstore access username (e.g. `mstestaa1.admin`) and password (API key) to log in. 24 | 25 | #### Keystone 26 | 27 | {download}`Download` the *Memstore (Keystone) Profile* for preconfigured settings. 28 | 29 | Use `admin` for the username, the Memstore name when prompted for the Tenant ID (e.g. `mstestaa1`) and password (API key) to log in. 30 | 31 | ### Manual Configuration 32 | 33 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 34 | 35 | - **Protocol**: `Swift (OpenStack Object Storage)` 36 | - **Server**: `auth.storage.memset.com` 37 | - **Port**: `443` 38 | - **Username**: Memstore name and username e.g. `mstestaa1.admin` 39 | - If you are not using the `admin` user then a container name will need to be specified under *More Options* 40 | - **Password**: Memstore password (API key) 41 | 42 | ![Memstore configuration](_images/Memstore.Swift.Config.png) 43 | 44 | ## References 45 | - [Documentation and Resources for Developers](https://docs.memset.com/cd/API-%2F-Developer-Resources.199072028.html) 46 | - [Swift Openstack API with Cyberduck](https://docs.memset.com/cd/Swift-OpenStack-API-with-Cyberduck.199072116.html) -------------------------------------------------------------------------------- /protocols/openstack/oktawave.md: -------------------------------------------------------------------------------- 1 | Oktawave Cloud Storage 2 | ==== 3 | 4 | > [Oktawave Cloud Storage (OCS)](https://www.oktawave.com/en/cloud/object-storage) is a highly efficient, reliable, and secure way to exchange files between different systems and applications on the Internet. 5 | 6 | ## Connecting 7 | 8 | Install a [connection profile](https://oktawave.com/docs/services/ocs/polaczenie-z-usluga#cyberduck) to connect with OpenStack Swift API: 9 | 10 | - {download}`Keystone v3. Oktawave Cloud Storage` 11 | - {download}`Swauth Oktawave Cloud Storage` 12 | 13 | ## References 14 | - [Jak przenieść instancję?](https://oktawave.com/docs/faq/faq/jak-przeniesc-instancje) -------------------------------------------------------------------------------- /protocols/openstack/providers.md: -------------------------------------------------------------------------------- 1 | Third-Party Providers 2 | === 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | auro 8 | cloud.ca 9 | clouda 10 | cloudfiles 11 | entercloudsuite 12 | flexcloud 13 | hubic 14 | infomaniak 15 | internap 16 | memset 17 | oktawave 18 | ovh 19 | swiftstack 20 | zetta.io 21 | ::: 22 | 23 | There are a growing number of cloud storage providers offering OpenStack Swift compatible solutions. 24 | 25 | :::{note} 26 | Connection profiles can be installed from *Preferences → Profiles*. 27 | ::: 28 | -------------------------------------------------------------------------------- /protocols/openstack/swiftstack.md: -------------------------------------------------------------------------------- 1 | SwiftStack 2 | ==== 3 | 4 | ![SwiftStack Drive Icon](_images/swiftstack.png) 5 | 6 | > [SwiftStack](http://swiftstack.com/) makes OpenStack Swift enterprise-ready with dramatically simplified deployment, management, and monitoring capabilities for object storage. 7 | 8 | ## Connecting 9 | 10 | ### Connection Profiles 11 | 12 | :::{note} 13 | Connection profiles can be installed from *Preferences → Profiles*. 14 | ::: 15 | 16 | Connect to a SwiftStack cluster via HTTP or HTTPS using these preconfigured [connection profiles](../../cyberduck/connection.md#connection-profiles): 17 | 18 | - **HTTP:** {download}`OpenStack Swift (SwiftStack HTTP).cyberduckprofile` 19 | - **HTTPS:** {download}`OpenStack Swift (SwiftStack HTTPS).cyberduckprofile` 20 | 21 | **Version 2.0 Authentication** 22 | 23 | - **HTTP:** {download}`OpenStack Swift Auth v2.0 (SwiftStack HTTP).cyberduckprofile` 24 | - **HTTPS:** {download}`OpenStack Swift Auth v2.0 (SwiftStack HTTPS).cyberduckprofile` 25 | 26 | ### Additional Fields Required 27 | 28 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 29 | 30 | - **Server**: SwiftStack cluster API IP address 31 | - **Username**: SwiftStack cluster user 32 | - **Password**: SwiftStack cluster user's password 33 | 34 | ## References 35 | 36 | - [Demo Video](https://vimeo.com/123122789) -------------------------------------------------------------------------------- /protocols/openstack/zetta.io.md: -------------------------------------------------------------------------------- 1 | Zetta.IO 2 | ==== 3 | 4 | ![Zetta Drive Icon](_images/candy-drive-removable-media-zetta.png) 5 | 6 | > [Object Storage](https://zetta.io/en/products/object-storage/) from [Zetta.IO](https://zetta.io/) is an affordable, flexible and scalable online storage solution. 7 | 8 | Access your data from any internet-connected environment. Store and retrieve any amount of data at any time. 9 | 10 | While most of the big cloud players in the world are U.S.-based, Zetta.IO is a Norwegian company with Norwegian owners, operating under strict Norwegian privacy laws. 11 | 12 | ## Connecting 13 | 14 | ### Connection Profiles 15 | 16 | Connect using the preconfigured [connection profile](../../cyberduck/connection.md#connection-profiles): 17 | 18 | - {download}`Download` the *Zetta.IO Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 19 | 20 | ### Manual Configuration 21 | 22 | - **Server**: `identity.api.zetta.io` 23 | - **Port**: `443` 24 | - **Username**: `::` 25 | - **Password**: Your Password 26 | 27 | You will need the [Openstack Swift (Keystone 3) profile](index.md) if you want to use manual configuration with Cyberduck or Mountainduck. We recommend that you use the official profile instead. 28 | 29 | ## References 30 | 31 | - [Sign up for an account](https://dashboard.zetta.io/register/) 32 | - [Step-by-step instructions for signing up and activating the Object Storage service.](https://zetta.io/en/help/articles-tutorials/registration-object-storage/) -------------------------------------------------------------------------------- /protocols/profiles/_images/Google_Client_ID_and_client_secret.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/profiles/_images/Google_Client_ID_and_client_secret.png -------------------------------------------------------------------------------- /protocols/profiles/_images/Google_Create_OAuth_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/profiles/_images/Google_Create_OAuth_Client_ID.png -------------------------------------------------------------------------------- /protocols/profiles/_static/Google Drive Custom OAuth Client ID.cyberduckprofile: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | Protocol 5 | googledrive 6 | Vendor 7 | googledrive_custom 8 | Description 9 | Google Drive Custom OAuth Client ID 10 | Default Hostname 11 | www.googleapis.com 12 | OAuth Authorization Url 13 | https://accounts.google.com/o/oauth2/auth 14 | OAuth Token Url 15 | https://accounts.google.com/o/oauth2/token 16 | Scopes 17 | 18 | https://www.googleapis.com/auth/drive 19 | 20 | OAuth Redirect Url 21 | 22 | OAuth Client ID 23 | 24 | OAuth Client Secret 25 | 26 | 27 | 28 | -------------------------------------------------------------------------------- /protocols/profiles/_static/Google Storage Custom OAuth Client ID.cyberduckprofile: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | Protocol 5 | gs 6 | Vendor 7 | gs_custom 8 | Description 9 | Google Storage Custom OAuth Client ID 10 | Default Hostname 11 | storage.googleapis.com 12 | OAuth Authorization Url 13 | https://accounts.google.com/o/oauth2/auth 14 | OAuth Token Url 15 | https://accounts.google.com/o/oauth2/token 16 | Scopes 17 | 18 | https://www.googleapis.com/auth/devstorage.full_control 19 | 20 | OAuth Redirect Url 21 | 22 | OAuth Client ID 23 | 24 | OAuth Client Secret 25 | 26 | 27 | 28 | -------------------------------------------------------------------------------- /protocols/profiles/google_client_id.md: -------------------------------------------------------------------------------- 1 | Custom OAuth 2.0 Client ID for Google Cloud Storage and Google Drive 2 | ==== 3 | 4 | Instructions to register a custom OAuth 2.0 Client ID in the [Google Cloud Console](https://console.cloud.google.com/apis/credentials) to connect to [Google Drive](../googledrive.md) or [Google Storage](../googlecloudstorage.md). 5 | 6 | > To use OAuth 2.0 in your application, you need an OAuth 2.0 client ID, which your application uses when requesting an OAuth 2.0 access token. 7 | 8 | ## Register Client ID 9 | 10 | :::{admonition} Tutorial 11 | :class: tip 12 | 13 | Follow the [step-by-step instructions](../../tutorials/custom_oauth_client_id.md) to setup a Custom OAuth Client ID. 14 | ::: 15 | 16 | Follow the steps in [Setting up OAuth 2.0](https://support.google.com/googleapi/answer/6158849?hl=en). From Credentials copy the client ID and client secret by choosing the action Edit OAuth client. 17 | 18 | 1. Choose _Desktop app_ as the _Application type_ which will result in a Client ID with a suffix like `number-id.apps.googleusercontent.com`. 19 | 20 | :::{image} _images/Google_Create_OAuth_Client_ID.png 21 | :alt: Google Create OAuth Client ID 22 | :width: 600px 23 | ::: 24 | 25 | :::{image} _images/Google_Client_ID_and_client_secret.png 26 | :alt: Google Client ID and Client Secret 27 | :width: 600px 28 | ::: 29 | 30 | 2. Edit the *OAuth Consent Screen* to add the scopes *Google Cloud Storage JSON API* `../auth/devstorage.read_write` and/or *Google Drive API* `../auth/drive`. You will first need to enable *Google Drive* in the Google API Library. 31 | 32 | ## Edit Custom Connection Profile 33 | 34 | 1. Create a custom [connection profile](index.md) with the following properties. 35 | 36 | - `OAuth Client ID`. Override the registered application client id. 37 | - `OAuth Client Secret`. Optional. Override the registered application client secret. 38 | - `OAuth Redirect Url`. Use the reverse notation of the client id and set it like 39 | 40 | ```xml 41 | OAuth Redirect Url 42 | com.googleusercontent.apps.number-id:oauth 43 | ``` 44 | 45 | ### Sample Google Drive with Custom OAuth Client ID Connection Profile 46 | 47 | - {download}`Google Drive Custom OAuth Client ID.cyberduckprofile<_static/Google Drive Custom OAuth Client ID.cyberduckprofile>` 48 | 49 | ### Sample Google Cloud Storage with Custom OAuth Client ID Connection Profile 50 | 51 | - {download}`Google Storage Custom OAuth Client ID.cyberduckprofile<_static/Google Storage Custom OAuth Client ID.cyberduckprofile>` -------------------------------------------------------------------------------- /protocols/s3/_images/10GbE_Transfer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/10GbE_Transfer.png -------------------------------------------------------------------------------- /protocols/s3/_images/ACLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/ACLs.png -------------------------------------------------------------------------------- /protocols/s3/_images/AWS_Logging_Configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/AWS_Logging_Configuration.png -------------------------------------------------------------------------------- /protocols/s3/_images/AWS_SSE-KMS_Private_Key_Selection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/AWS_SSE-KMS_Private_Key_Selection.png -------------------------------------------------------------------------------- /protocols/s3/_images/Cache_Retry.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/Cache_Retry.png -------------------------------------------------------------------------------- /protocols/s3/_images/Copy_URLs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/Copy_URLs.png -------------------------------------------------------------------------------- /protocols/s3/_images/Create_Bucket.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/Create_Bucket.png -------------------------------------------------------------------------------- /protocols/s3/_images/Dunkel_Cloud_Storage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/Dunkel_Cloud_Storage.png -------------------------------------------------------------------------------- /protocols/s3/_images/Lifecycle-Configuration-for-S3-Windows.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/Lifecycle-Configuration-for-S3-Windows.png -------------------------------------------------------------------------------- /protocols/s3/_images/MFA_Credentials.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/MFA_Credentials.png -------------------------------------------------------------------------------- /protocols/s3/_images/MFA_Token_Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/MFA_Token_Prompt.png -------------------------------------------------------------------------------- /protocols/s3/_images/MINIO_wordmark.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/MINIO_wordmark.png -------------------------------------------------------------------------------- /protocols/s3/_images/OCI_Object_Storage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/OCI_Object_Storage.png -------------------------------------------------------------------------------- /protocols/s3/_images/S3_Anonymous_Login.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/S3_Anonymous_Login.png -------------------------------------------------------------------------------- /protocols/s3/_images/S3_Website_Configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/S3_Website_Configuration.png -------------------------------------------------------------------------------- /protocols/s3/_images/Wasabi_Certificate_Error.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/Wasabi_Certificate_Error.png -------------------------------------------------------------------------------- /protocols/s3/_images/cloud-mrktplc-badge.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/cloud-mrktplc-badge.png -------------------------------------------------------------------------------- /protocols/s3/_images/exoscale.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/exoscale.png -------------------------------------------------------------------------------- /protocols/s3/_images/garage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/garage.png -------------------------------------------------------------------------------- /protocols/s3/_images/s3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/s3.png -------------------------------------------------------------------------------- /protocols/s3/_images/selectel.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/s3/_images/selectel.png -------------------------------------------------------------------------------- /protocols/s3/cloudflare.md: -------------------------------------------------------------------------------- 1 | Cloudflare R2 2 | ==== 3 | 4 | > [Cloudflare R2 Storage](https://www.cloudflare.com/products/r2/) allows developers to store large amounts of unstructured data without the costly egress bandwidth fees associated with typical cloud storage services. 5 | 6 | ## Connection 7 | 8 | {download}`Download` the *Cloudflare R2 Storage (S3) Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 9 | 10 | :::{tip} 11 | Make sure to set `.r2.cloudflarestorage.com` for server. The `ACCOUNT_ID` can be found in the [Cloudflare dashboard](https://developers.cloudflare.com/fundamentals/setup/find-account-and-zone-ids/). 12 | ::: 13 | 14 | :::{warning} 15 | For tokens that are limited to _Object Read & Write_ or _Object Read only_ with no permission to list buckets, the bucket name to 16 | connect to must be set in `Path` when configuring the [bookmark](../../cyberduck/bookmarks.md#edit-bookmark). 17 | ::: 18 | 19 | ### Regions 20 | The connection profile supports the following [regions](https://developers.cloudflare.com/r2/reference/data-location/#available-hints): 21 | 22 | - `APAC` (Asia Pacific) 23 | - `EEUR` (Eastern Europe) 24 | - `ENAM` (Eastern North America) 25 | - `WEUR` (Western Europe) 26 | - `WNAM` (Western North America) 27 | 28 | ## Limitations 29 | 30 | The following features are not supported within the [open beta](https://blog.cloudflare.com/r2-open-beta/): 31 | - Specify regions for buckets 32 | - ACLs 33 | - Pre-signed URLs 34 | 35 | ## References 36 | 37 | - [Cloudflare documentation](https://developers.cloudflare.com/r2/get-started/) -------------------------------------------------------------------------------- /protocols/s3/cynny.md: -------------------------------------------------------------------------------- 1 | Cynny Space 2 | ==== 3 | 4 | > Simple Sustainable Storage. Changing the rules of Cloud Object Storage (and saving the planet). 5 | 6 | ## Connecting 7 | 8 | - {download}`Download` the *Cynny Space Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 9 | 10 | ## References 11 | 12 | - [Cloud Object storage | Cynny Space](https://www.theswarm.co/) -------------------------------------------------------------------------------- /protocols/s3/digitalocean.md: -------------------------------------------------------------------------------- 1 | DigitalOcean Spaces 2 | ==== 3 | 4 | :::{image} https://cdn.cyberduck.io/img/providers/digitaloceanspaces.png 5 | :alt: DigitalOcean Spaces Drive Icon 6 | :width: 128px 7 | ::: 8 | 9 | > [Spaces](https://www.digitalocean.com/products/object-storage/), a beautifully simple and scalable object storage service. Securely store and deliver any amount of data with the same simplicity you've come to expect from us. Instantaneously create a cost-effective, reliable storage space using our drag-and-drop UI or API. 10 | 11 | ## Connecting 12 | 13 | :::{note} 14 | Connection profiles can be installed from *Preferences → Profiles*. 15 | ::: 16 | 17 | ### AMS3 18 | 19 | - **AMS3** {download}`Download` the *DigitalOcean Spaces (ams3) Connection Profile* for preconfigured settings. 20 | - **BLR1** {download}`Download` the *DigitalOcean Spaces (blr1) Connection Profile* for preconfigured settings. 21 | - **FRA1** {download}`Download` the *DigitalOcean Spaces (fra1) Connection Profile* for preconfigured settings. 22 | - **NYC3** {download}`Download` the *DigitalOcean Spaces (nyc3) Connection Profile* for preconfigured settings. 23 | - **SFO2** {download}`Download` the *DigitalOcean Spaces (sfo2) Connection Profile* for preconfigured settings. 24 | - **SFO3** {download}`Download` the *DigitalOcean Spaces (sfo3) Connection Profile* for preconfigured settings. 25 | - **SGP1** {download}`Download` the *DigitalOcean Spaces (sgp1) Connection Profile* for preconfigured settings. 26 | - **SYD1** {download}`Download` the *DigitalOcean Spaces (syd1) Connection Profile* for preconfigured settings. 27 | 28 | ## Buckets 29 | 30 | :::{tip} 31 | Names must be lowercase and start with a letter or number. They may contain dashes. 32 | ::: 33 | 34 | ## References 35 | 36 | - [How to Manage DigitalOcean Spaces with Cyberduck](https://docs.digitalocean.com/products/spaces/resources/cyberduck/) 37 | - [How To Create a DigitalOcean Space and API Key](https://www.digitalocean.com/community/tutorials/how-to-create-a-digitalocean-space-and-api-key) 38 | -------------------------------------------------------------------------------- /protocols/s3/dreamobjects.md: -------------------------------------------------------------------------------- 1 | DreamObject Cloud Storage 2 | ==== 3 | 4 | :::{image} https://cdn.cyberduck.io/img/providers/dreamobjects.png 5 | :alt: DreamObject Cloud Storage 6 | :width: 128px 7 | ::: 8 | 9 | > [DreamObjects](http://dreamhost.com/cloud/dreamobjects/) is a cost-effective, public cloud storage service built on top of the open source technology [Ceph](http://ceph.io/). It is compatible with the APIs of [Amazon S3](index.md) and [Swift](../openstack/index.md) based object storage services. 10 | 11 | ## Connecting 12 | 13 | :::{attention} 14 | `us-west-1` was shut down 15 | 16 | See the article [What DreamObjects hostname should I use to connect?](https://help.dreamhost.com/hc/en-us/articles/360001370846) for more information. 17 | ::: 18 | 19 | - `us-east-1` {download}`Download` the *DreamObjects Cloud Storage Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 20 | - Alternatively, use `objects-us-east-1.dream.io` for the hostname in Open Connection or Bookmark settings with a *S3* protocol selection. Then user your *Access Key* for the username and *Secret Key* for the password. 21 | 22 | ## Limitations 23 | 24 | - View a feature support list in the [API documentation](https://help.dreamhost.com/hc/en-us/articles/217590537-How-To-Use-DreamObjects-S3-compatible-API). 25 | - No support for multipart uploads through Cyberduck. 26 | 27 | ## References 28 | 29 | - [This article describes how to connect Cyberduck to your DreamObjects buckets](https://help.dreamhost.com/hc/en-us/articles/217131247#connecting) 30 | - [The following describes how to use Cyberduck to connect to your DreamObjects account](https://help.dreamhost.com/hc/en-us/articles/217131247-Cyberduck) -------------------------------------------------------------------------------- /protocols/s3/dunkel.md: -------------------------------------------------------------------------------- 1 | Dunkel Cloud Storage 2 | ==== 3 | 4 | :::{image} _images/Dunkel_Cloud_Storage.png 5 | :alt: Dunkel Cloud Storage Drive Icon 6 | :width: 128px 7 | ::: 8 | 9 | > [Dunkel Cloud Storage](http://www.dunkel.de/s3/) ist ein S3 kompatibler Cloud Storage in deutschen Rechenzentren. 10 | 11 | Refer also to [S3](index.md) wiki page in general. 12 | 13 | ## Connecting 14 | 15 | ### Connection Profile 16 | 17 | {download}`Download` the *Dunkel Cloud Storage Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 18 | 19 | ### Manual Configuration 20 | 21 | - **Protocol**: `S3` 22 | - **Server**: `dcs.dunkel.de` 23 | 24 | ## Limitations 25 | 26 | - No bucket location support (All data is stored in Germany). 27 | - No bucket logging configuration. 28 | - Storage class options are not available. 29 | - Torrent URLs are not supported. 30 | - No content distribution ([CDN](../../protocols/cdn/index.md)) configuration. -------------------------------------------------------------------------------- /protocols/s3/exoscale.md: -------------------------------------------------------------------------------- 1 | Exoscale 2 | ==== 3 | 4 | ![Exoscale Drive Icon](_images/exoscale.png) 5 | 6 | > [Exoscale Object Storage.](https://www.exoscale.com/object-storage/) An S3-compatible object storage service, with zones in Switzerland, Germany, Autria, and Bulgaria. 7 | 8 | ## Connecting 9 | 10 | Download the *Exoscale* connection profile for the region in which your bucket is located or install it from *Preferences… → Profiles* for preconfigured settings. 11 | 12 | - Austria 13 | - {download}`AT-VIE-1` 14 | - {download}`AT-VIE-2` 15 | - Bulgaria 16 | - {download}`BG-SOF-1` 17 | - Germany 18 | - {download}`DE-FRA-1` 19 | - {download}`DE-MUC-1` 20 | - Switzerland 21 | - {download}`CH-DK-2` 22 | - {download}`CH-GVA-2` 23 | 24 | ### References 25 | 26 | - [Exoscale documentation](https://community.exoscale.com/documentation/storage/quick-start/) 27 | -------------------------------------------------------------------------------- /protocols/s3/fastly.md: -------------------------------------------------------------------------------- 1 | Fastly Object Storage 2 | ==== 3 | 4 | > [Fastly Object Storage](https://www.fastly.com/products/storage) Fastly Object Storage operates as a drop-in replacement for the S3 API with zero egress costs. 5 | 6 | ## Connecting 7 | 8 | ### Connection Profile 9 | 10 | :::{note} 11 | Connection profiles can be installed from *Preferences → Profiles*. 12 | ::: 13 | 14 | Download the desired region for the Hetzner Object Storage Connection Profile with preconfigured settings. 15 | 16 | - **eu-central** {download}`Fastly Object Storage (eu-central).cyberduckprofile` 17 | - **us-east** {download}`Fastly Object Storage (us-east).cyberduckprofile` 18 | - **us-west** {download}`Fastly Object Storage (us-west).cyberduckprofile` 19 | 20 | ### Access Keys 21 | 22 | You have to generate an access key with *Read and write* permissions before you can connect: 23 | 24 | 1. Log in to the [Fastly control panel](https://manage.fastly.com/). 25 | 2. Go to Resources → https://manage.fastly.com/resources/object-storage. 26 | 3. Click Create key and copy the _Access Key_ and _Secret Key_. 27 | 28 | 29 | ## References 30 | - [Fastly Documentation](https://docs.fastly.com/en/guides/working-with-object-storage#working-with-the-s3-compatible-api) 31 | -------------------------------------------------------------------------------- /protocols/s3/filebase.md: -------------------------------------------------------------------------------- 1 | Filebase 2 | ==== 3 | 4 | > [Filebase](https://docs.filebase.com/) is the first S3-compatible object storage platform that allows you to store data in a secure, redundant, and performant manner across multiple decentralized storage networks. 5 | 6 | ## Connecting 7 | 8 | {download}`Download` the *Filebase Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 9 | 10 | ## References 11 | 12 | - [Learn how to backup your data to Filebase using Cyberduck](https://docs.filebase.com/client-configurations/cyberduck) -------------------------------------------------------------------------------- /protocols/s3/garage.md: -------------------------------------------------------------------------------- 1 | Garage 2 | ==== 3 | 4 | :::{image} _images/garage.png 5 | :alt: Garage Logo 6 | :width: 128px 7 | ::: 8 | 9 | > [Garage](https://garagehq.deuxfleurs.fr/) is an open-source distributed object storage service tailored for self-hosting. 10 | 11 | ## Connecting 12 | 13 | {download}`Download` the *Garage Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 14 | -------------------------------------------------------------------------------- /protocols/s3/hetzner.md: -------------------------------------------------------------------------------- 1 | Hetzner Object Storage 2 | ==== 3 | 4 | > [Hetzner Object Storage](https://www.hetzner.com/storage/object-storage/) is the S3 compatible storage solution that grows with your data requirements - highly available, secure and flexible. 5 | 6 | ## Connecting 7 | 8 | ### Connection Profile 9 | 10 | :::{note} 11 | Connection profiles can be installed from *Preferences → Profiles*. 12 | ::: 13 | 14 | Download the desired region for the Hetzner Object Storage Connection Profile with preconfigured settings. 15 | 16 | - **Falkenstein** {download}`Hetzner Object Storage (Falkenstein).cyberduckprofile` 17 | - **Helsinki** {download}`Hetzner Object Storage (Helsinki).cyberduckprofile` 18 | - **Nürnberg** {download}`Hetzner Object Storage (Nürnberg).cyberduckprofile` 19 | 20 | ### Access Keys 21 | 22 | You have to generate an access key before you can connect: 23 | 24 | 1. Log into the [Hetzner Cloud Console](https://console.hetzner.cloud/). 25 | 2. Click on the *Sicherheit* link in the sidebar and choose _Zugangsdaten generieren_. 26 | 3. Copy the _Access Key_ and _Secret Key_ 27 | 28 | 29 | ## References 30 | - [Hetzner Docs](https://docs.hetzner.com/storage/object-storage/) 31 | -------------------------------------------------------------------------------- /protocols/s3/ibmcos.md: -------------------------------------------------------------------------------- 1 | IBM Cloud Object Storage (COS) 2 | ==== 3 | 4 | :::{attention} 5 | - [**Softlayer is now IBM Cloud.**](https://www.ibm.com/cloud/info/softlayer-is-now-ibm-cloud) 6 | - [**IBM Bluemix has been rebranded as IBM Cloud within October 2017.**](https://www.ibm.com/cloud/blog/announcements/bluemix-is-now-ibm-cloudMore) 7 | ::: 8 | 9 | > A highly scalable cloud [storage service](https://www.ibm.com/cloud/object-storage), designed for high durability, resiliency, and security. 10 | 11 | ## Connecting 12 | 13 | ### Connection Profile 14 | 15 | :::{note} 16 | Connection profiles can be installed from *Preferences → Profiles*. 17 | ::: 18 | 19 | - *IBM Cloud Object Storage (eu-geo)* 20 | - *IBM Cloud Object Storage (ap-geo)* 21 | - *IBM Cloud Object Storage (us-geo)* 22 | -------------------------------------------------------------------------------- /protocols/s3/ionos.md: -------------------------------------------------------------------------------- 1 | IONOS Cloud Object Storage 2 | === 3 | 4 | > IONOS S3 Object Storage is a service offered by IONOS for storing and accessing unstructured data. The Object Storage is fully S3-compliant, which means that it can be used to manage buckets and objects using existing S3 clients. 5 | 6 | ## Connection 7 | 8 | :::{note} 9 | Connection profiles can be installed from *Preferences → Profiles*. 10 | ::: 11 | 12 | ### Connection Profile 13 | 14 | - **Berlin (`eu-central-2`)** {download}`Download` the *IONOS Cloud Object Storage (Berlin) Connection Profile* for preconfigured settings. 15 | - **Frankfurt (`eu-central-1`)** {download}`Download` the *IONOS Cloud Object Storage (Frankfurt) Connection Profile* for preconfigured settings. 16 | - **Logrono (`eu-south-2`)** {download}`Download` the *IONOS Cloud Object Storage (Logrono) Connection Profile* for preconfigured settings. 17 | 18 | ### Object storage keys 19 | 20 | 1. Sign into your **IONOS Data Center Designer** and navigate to the **User Manager** via the menu bar **Resource Manager** section. 21 | 2. Select a user and click on the **Object Storage Keys** tab on the right. 22 | 3. Choose **Generate Key** and confirm the action with **OK**. The object storage key will be generated automatically. 23 | 24 | ## References 25 | 26 | - [IONOS Cloud documentation](https://docs.ionos.com/cloud/managed-services/s3-object-storage) -------------------------------------------------------------------------------- /protocols/s3/minio.md: -------------------------------------------------------------------------------- 1 | MinIO Cloud Storage 2 | ==== 3 | 4 | :::{image} _images/MINIO_wordmark.png 5 | :alt: MinIO Logo 6 | :height: 128px 7 | ::: 8 | 9 | > [MinIO](https://min.io/) is an object storage server built for cloud application developers and DevOps.
Store photos, videos, VMs, containers, log files, or any blob of data as objects. 10 | 11 | ## Connecting 12 | 13 | Download and install the [generic S3 profile](index.md#generic-s3-profiles). 14 | 15 | ### Virtual Host Style Requests 16 | 17 | :::{attention} 18 | Make sure to enable [virtual-host-style requests](https://github.com/minio/minio/tree/master/docs/config#domain) in your MinIO configuration. Alternatively, refer to [Connecting using Deprecated Path Style Requests](index.md#connecting-using-deprecated-path-style-requests). 19 | ::: -------------------------------------------------------------------------------- /protocols/s3/pilvio.md: -------------------------------------------------------------------------------- 1 | Pilvio 2 | ==== 3 | 4 | Located in Estonia. S3 compatible object storage with perfect cost and reliability ratio. An ideal solution for file, image, video, cad file, backup, or archive storage. 5 | 6 | [Pilvio](https://pilvio.com/) is a S3 compatible object storage. 7 | 8 | ## Connecting 9 | 10 | {download}`Download` the *Pilvio Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 11 | 12 | ## References 13 | 14 | - [Set Up Your Object Storage Space in 4 Steps](https://blog.pilw.io/set-up-your-object-storage-space-in-4-steps/) -------------------------------------------------------------------------------- /protocols/s3/polycloud.md: -------------------------------------------------------------------------------- 1 | Polycloud 2 | ==== 3 | 4 | > [Polycloud](https://crowdstorage.com/) is an object storage service offering secure and private data storage with immediate access and high reliability. Data are stored as objects within buckets and can be accessed and managed via our basic browser-based user interface, but full functionality is realized by utilizing our S3 compatible API. 5 | 6 | ## Connecting 7 | 8 | {download}`Download` the *Polycloud Connection Profile* for preconfigurated settings for authentication. 9 | 10 | Double-click on the downloaded file to activate the connection profile. Enter the following authentication credentials to the bookmark: 11 | - Server: `polycloud.crowdapis.com` 12 | - Access Key ID: Access Key Credentials 13 | - Secret Access Key: Access Key Credentials 14 | 15 | ### How to Create Application Keys 16 | 17 | 1. [Sign in](https://polycloud.crowdstorage.com/login) to your Polycloud account 18 | 2. Select *Generate Access Key* on the *My Buckets* page. 19 | 3. Select *Generate* to confirm that you want to generate an access key. 20 | 4. A window will show up containing the key information (Access Key ID, Secret Access Key) 21 | 22 | :::{note} 23 | The key information will only be shown once and can't be recovered. If you do lose them you can generate new keys, but you will then need to update all of your 3rd party applications with the new credentials. 24 | ::: 25 | 26 | ## References 27 | 28 | - [CrowdStorage Documentation](https://crowdstorage.com/documentation/connect-cyberduck-server/) -------------------------------------------------------------------------------- /protocols/s3/providers.md: -------------------------------------------------------------------------------- 1 | Third-Party Providers 2 | === 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | alibaba 8 | cloudflare 9 | cynny 10 | digitalocean 11 | dreamobjects 12 | dunkel 13 | exoscale 14 | fastly 15 | filebase 16 | garage 17 | hetzner 18 | ibmcos 19 | ionos 20 | linode 21 | minio 22 | oraclecloud 23 | pilvio 24 | polycloud 25 | scaleway 26 | seagate 27 | selectel 28 | spectra 29 | storadera 30 | storjdcs 31 | synology 32 | vitanium 33 | wasabi 34 | z1 35 | ::: 36 | 37 | There are a growing number of third parties besides Amazon offering S3 compatible cloud storage software or solutions. 38 | 39 | :::{note} 40 | Connection profiles can be installed from *Preferences → Profiles*. 41 | ::: 42 | 43 | ## More Providers 44 | 45 | - [Aruba Cloud](https://www.cloud.it/) 46 | - [Cloudian HyperStore Appliance](https://cloudian.com/products/hyperstore/) 47 | - [connectria Cloud Storage](https://www.mh.connectria.com/rp/order/cloud_storage_index) 48 | - [Eucalyptus](https://www.eucalyptus.cloud/) 49 | - [NetApp StorageGrid Webscale](https://docs.netapp.com/sgws-114/index.jsp) 50 | - [Outscale (using CEPH Opensource)](https://www.outscale.com/) 51 | - [OVH](../openstack/ovh.md) 52 | - [Seeweb](https://www.seeweb.it/) 53 | - [Swisscom S3 Dynamic Storage](https://www.swisscom.ch/en/business/enterprise/offer/cloud-data-center/dynamic-computing-services.html) 54 | - [Vultr Object Storage](https://www.vultr.com/docs/vultr-object-storage#Cyberduck_GUI_tool) -------------------------------------------------------------------------------- /protocols/s3/scaleway.md: -------------------------------------------------------------------------------- 1 | Scaleway Object Storage 2 | ==== 3 | 4 | > [Scaleway Object Storage](https://www.scaleway.com/docs/object-storage-feature/) is an Object Storage service based on the S3 protocol. It allows you to store any kind of object (documents, images, videos, etc.). 5 | 6 | ## Connecting 7 | 8 | :::{note} 9 | Connection profiles can be installed from *Preferences → Profiles*. 10 | ::: 11 | 12 | - **NL-AMS** {download}`Download` the *Scaleway Object Storage (NL-AMS) Connection Profile* for preconfigured settings. 13 | - **FR-PAR** {download}`Download` the *Scaleway Object Storage (FR-PAR) Connection Profile* for preconfigured settings. 14 | - **PL-WAW** {download}`Download` the *Scaleway Object Storage (PL-WAW) Connection Profile* for preconfigured settings. 15 | 16 | ## References 17 | 18 | - [How to store objects with Object Storage and Cyberduck](https://www.scaleway.com/docs/store-object-with-cyberduck/) -------------------------------------------------------------------------------- /protocols/s3/seagate.md: -------------------------------------------------------------------------------- 1 | Seagate Lyve Cloud 2 | ==== 3 | 4 | > Lyve™ is an edge-to-cloud mass storage platform from Seagate®—built for the distributed enterprise to capture the unstructured data explosion. 5 | 6 | ## Connection 7 | 8 | Use the `S3 (HTTPS)` profile to connect. Available [endpoints](https://help.lyvecloud.seagate.com/en/s3-api-endpoints.html) are: 9 | 10 | :::{hint} 11 | Available [endpoints](https://help.lyvecloud.seagate.com/en/s3-api-endpoint.html) are 12 | - US-East-1 (Virginia): `https://s3.us-east-1.lyvecloud.seagate.com` 13 | - US-West-1 (California): `https://s3.us-west-1.lyvecloud.seagate.com` 14 | - AP-Southeast-1 (Singapore): `https://s3.ap-southeast-1.lyvecloud.seagate.com` 15 | - EU-West-1 (London): `https://s3.eu-west-1.lyvecloud.seagate.com` 16 | - US-Central-2 (Texas): `https://s3.us-central-2.lyvecloud.seagate.com` 17 | ::: 18 | 19 | ### Create Access Keys 20 | 21 | You have to create service accounts within the *Lyve Cloud console* to use third party tools: 22 | 23 | 1. [Sign in](https://console.lyvecloud.seagate.com) to your Lyve Cloud via web browser. 24 | 2. Select *Service Accounts* from the sidebar menu and choose *Create Service Account*. 25 | 3. Enter the name and permissions. 26 | 4. Choose *Create*. The access key will be generated and the details of the key will be displayed in a popup window. 27 | 28 | :::{tip} 29 | The prompt containing the access key information will only be displayed once. Make sure to save the details for future use. 30 | ::: 31 | 32 | ## References 33 | 34 | - [Using Cyberduck with Lyve Cloud](https://help.lyvecloud.seagate.com/en/using-cyberduck.html) 35 | - [Using Mountain Duck with Lyve Cloud](https://help.lyvecloud.seagate.com/en/using-mountain-duck.html) -------------------------------------------------------------------------------- /protocols/s3/selectel.md: -------------------------------------------------------------------------------- 1 | Selectel S3 Storage 2 | ==== 3 | 4 | ```{image} _images/selectel.png 5 | :alt: Selectel Drive Icon 6 | :width: 128px 7 | ``` 8 | 9 | > [Selectel Cloud Storage](https://docs.selectel.ru/en/cloud/object-storage/) is a durable S3 for developers and businesses. 10 | 11 | ## Connecting 12 | 13 | {download}`Download` the *Selectel S3 Cloud Storage Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 14 | 15 | :::{tip} 16 | The container must have virtual-hosted addressing enabled, see the [Detailed instructions for connection](https://docs.selectel.ru/en/cloud/object-storage/tools/cyberduck/) for more details. 17 | ::: 18 | 19 | ### Configure Access 20 | 21 | Access can be configured by a user with role _Account Owner_ or _User Administrator_ in Selectel S3. Create a service user with a role with access to S3 object storage, see [Role Model Access](https://docs.selectel.ru/en/cloud/object-storage/manage/manage-access/) for details. 22 | Issue the user an S3 key. 23 | 24 | ### Configuration 25 | 26 | 1. Choose _[Open Connection…](../../cyberduck/connection.md)_ or add a _[New Bookmark](../../cyberduck/bookmarks.md)_ to save the connection settings. 27 | 2. Select the _S3 Selectel_ protocol or alterntively the generic Amazon S3 profile. 28 | 3. In the _Server_ field, enter the domain `s3.ru-1.storage.selcloud.ru`, where `ru-1` is the pool that hosts the object storage. 29 | 4. In the _Access Key ID_ field, insert the value of the _Access key_ field from your S3 key. 30 | 5. In the _Secret Access Key_ field, insert the value of the _Secret key_ field from your S3 key. 31 | 32 | ## Selectel S3 API Domains 33 | 34 | Only authorized access is possible through S3 API domains. You have to use S3-key to work with containers and upload objects via: 35 | 36 | - `s3.ru-1.storage.selcloud.ru/` domain with Path-Style addressing, used if Virtual-Hosted addressing is not enabled. 37 | - `.s3.ru-1.storage.selcloud.ru` domain with Virtual-Hosted addressing, used by default. 38 | 39 | We strongly recommend using Virtual-Hosted addressing. In this example, `ru-1` is the pool that hosts the object store. 40 | 41 | ## Selectel FTP API Domains 42 | 43 | - `ftp.ru-1.storage.selcloud.ru` domain, used if you need make a connection using FTP[](../ftp.md). -------------------------------------------------------------------------------- /protocols/s3/spectra.md: -------------------------------------------------------------------------------- 1 | Spectra BlackPearl Deep Storage Gateway 2 | ==== 3 | 4 | :::{image} https://cdn.cyberduck.io/img/providers/spectra.png 5 | :alt: DreamObject Cloud Storage 6 | :width: 128px 7 | ::: 8 | 9 | > S3 Gateway to Deep Storage. The Spectra Logic BlackPearl Converged Storage System provides an easy, cloud-like interface to on-premise storage solutions, including to disk, tape, and cloud targets for maximum protection. 10 | 11 | ## Connecting 12 | 13 | :::{note} 14 | Connection profiles can be installed from *Preferences → Profiles*. 15 | ::: 16 | 17 | - {download}`Download` the *Spectra S3 (HTTPS) Connection Profile* for preconfigured settings. 18 | - {download}`Download` the *Spectra S3 (HTTP) Connection Profile* for preconfigured settings. 19 | 20 | Refer to [Profiles](../../cyberduck/connection.md#connection-profiles) for documentation about connection profiles. Choose *Spectra BlackPearl Deep Storage Gateway (HTTP)* from the list of protocols when editing a [bookmark](../../cyberduck/bookmarks.md) or use the `spectra://` scheme when using the [CLI](../../cli/index). 21 | 22 | ## Additional Information 23 | 24 | ### Transfer → Retries 25 | 26 | Reading a file from Spectra S3 might trigger a retry wait for up to 300 seconds when the file is not yet in the cache. 27 | 28 | ![Cache Retries](_images/Cache_Retry.png) 29 | 30 | ### Transfer → Multiple Connections 31 | 32 | Use the lower right toggle to set the number of concurrent connections for file transfers. Refer to [Multiple Connections](../../cyberduck/transfer.md#connections). This allows saturating the bandwidth when running in a fast local network. 33 | 34 | ![Saturating 10GbE interface with file transfer](_images/10GbE_Transfer.png) 35 | 36 | ## Limitations 37 | 38 | - Rename and move files: not supported 39 | 40 | ## References 41 | 42 | - [S3 Gateway to Deep Storage](https://www.spectralogic.com/products/blackpearl/) 43 | - [The first RESTful interface to deep storage](https://www.spectralogic.com/products/spectra-s3/) 44 | - [Official Cyberduck BlackPearl Documentation](https://developer.spectralogic.com/cyberduck/) 45 | - [BlackPearl and Cyberduck Deliver End-to-End Hybrid Cloud Storage Solution](https://edge.spectralogic.com/index.cfm?&fuseaction=home.displayFile&DocID=4839) -------------------------------------------------------------------------------- /protocols/s3/storadera.md: -------------------------------------------------------------------------------- 1 | Storadera 2 | ==== 3 | 4 | > [Storadera](https://storadera.com/) is a secure and affordable unlimited data storage for creating archives and backups. 5 | 6 | ## Connecting 7 | 8 | ### Connection Profile 9 | 10 | - `eu-central-1` (Amsterdam, Netherlands, Europe) {download}`Download` the *Storadera (eu-central-1) Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 11 | - `eu-east-1` (Tallinn, Estonia, Europe) {download}`Download` the *Storadera (eu-east-1) Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 12 | 13 | ### Manual Configuration 14 | 15 | - **Protocol**: `Amazon S3` 16 | - **Server**: `eu-east-1.s3.storadera.com` 17 | - **Access Key ID**: your access key 18 | - **Secret Access Key**: your secret access key 19 | 20 | ## References 21 | 22 | - [How to use Storadera with Cyberduck](https://storadera.com/integrations/cyberduck/) -------------------------------------------------------------------------------- /protocols/s3/storjdcs.md: -------------------------------------------------------------------------------- 1 | Storj DCS 2 | === 3 | 4 | ## Connecting 5 | 6 | ### Connection Profile 7 | 8 | {download}`Download` the *Storj Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 9 | 10 | ### Manual Configuration 11 | 12 | - **Protocol**: `Amazon S3` 13 | - **Server**: `gateway.storjshare.io` 14 | - **Access Key ID**: your access key 15 | - **Secret Access Key**: your secret access key 16 | 17 | ### Credentials 18 | 19 | 1. Sign into your **Storj DCS** webinterface and navigate to the **Access** section. 20 | 2. Choose **Create S3 Credentials**, enter name and permissions, and select buckets. 21 | 3. Click **Encrypt My Access** to select the encryption and confirm your choice by selecting **Create my Access**. 22 | 23 | ## References 24 | 25 | - [How to use Cyberduck and Storj DCS](https://docs.storj.io/dcs/how-tos/how-to-use-cyberduck-and-storj-dcs/) -------------------------------------------------------------------------------- /protocols/s3/synology.md: -------------------------------------------------------------------------------- 1 | Synology C2 Object Storage 2 | ==== 3 | 4 | > [Synology C2 Object Storage](https://c2.synology.com/en-global/object-storage/overview) provides a secure, S3-compatible, and cost-effective cloud storage solution without API request, download fees, and deletion penalty. 5 | 6 | ## Connecting 7 | 8 | :::{note} 9 | Connection profiles can be installed from *Preferences → Profiles*. 10 | ::: 11 | 12 | 1. Download the desired region for the Synology C2 Object Storage Connection Profile with preconfigured settings. 13 | 2. Connect to S3 endpoint by following the quick start guide below. 14 | 15 | - **C2 Object Europe** 16 | - {download}`eu-001 cyberduckprofile` 17 | - {download}`eu-002 cyberduckprofile` 18 | - {download}`eu-003 cyberduckprofile` 19 | - {download}`eu-004 cyberduckprofile` 20 | - **C2 Object North America** 21 | - {download}`us-001 cyberduckprofile` 22 | - {download}`us-002 cyberduckprofile` 23 | - {download}`us-003 cyberduckprofile` 24 | - **C2 Object APAC** 25 | - {download}`tw-001 cyberduckprofile` 26 | 27 | ## References 28 | 29 | - [C2 Object Storage Quick Start Guide](https://kb.synology.com/en-global/C2/tutorial/Quick_Start_C2_Object_Storage) 30 | - [Explore and manage C2 Object Storage data on a client computer](https://kb.synology.com/en-global/C2/tutorial/C2_Object_Storage_client_device_exploring) 31 | -------------------------------------------------------------------------------- /protocols/s3/vitanium.md: -------------------------------------------------------------------------------- 1 | Vitanium Cloud 2 | === 3 | 4 | :::{image} https://cdn.cyberduck.io/img/providers/vitanium.png 5 | :alt: Vitanium Cloud 6 | :width: 128px 7 | ::: 8 | 9 | ## Connecting 10 | 11 | {download}`Download` the *Vitanium Object Storage Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. 12 | 13 | ## References 14 | 15 | - [Using Vitanium’s Object Storage with Cyberduck.](https://vitanium.com/using-vitaniums-object-storage-with-cyberduck/) -------------------------------------------------------------------------------- /protocols/s3/z1.md: -------------------------------------------------------------------------------- 1 | Z1 Storage 2 | ==== 3 | 4 | :::{image} https://cdn.cyberduck.io/img/providers/z1.png 5 | :alt: Z1 Storage 6 | :width: 128px 7 | ::: 8 | 9 | > Bringing affordable backups to Africa and the World. 10 | 11 | [Z1](https://www.z1storage.com/) is a S3 compatible object storage. 12 | 13 | ## Connecting 14 | 15 | {download}`Download` the *Z1 Connection Profile* or install it from *Preferences… → Profiles* for preconfigured settings. -------------------------------------------------------------------------------- /protocols/sftp/providers.md: -------------------------------------------------------------------------------- 1 | Third-Party Providers 2 | === 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | sftptogo 8 | ::: 9 | 10 | For some providers specific connection profiles are provided with pre-configured settings. 11 | 12 | :::{note} 13 | Connection profiles can be installed from *Preferences → Profiles*. 14 | ::: 15 | -------------------------------------------------------------------------------- /protocols/sftp/sftptogo.md: -------------------------------------------------------------------------------- 1 | SFTP To Go 2 | ==== 3 | 4 | > [SFTP To Go](https://sftptogo.com/) is a managed secure cloud storage that allows direct access to files using the SFTP, FTPS and S3 protocols. 5 | 6 | ## Connecting 7 | 8 | ### SFTP 9 | 10 | SFTP To Go allows both password and public-key authentication. 11 | 12 | To connect using username and password, login to SFTP To Go's dashboard and go to the credentials page: 13 | 14 | 1. Expand the credentials you'd like to use to connect to copy the hostname, username and password. 15 | 2. Create a new [bookmark](../../cyberduck/bookmarks.md) and enter the following information: 16 | 17 | - **Protocol**: `SFTP (SSH File Transfer Protocol)` 18 | - **Server**: Hostname copied from SFTP To Go's dashboard 19 | - **Username**: Username copied from SFTP To Go's dashboard 20 | - **Password**: Password copied from SFTP To Go's dashboard 21 | 22 | To connect using public key authentication, login to SFTP To Go's dashboard and go to the credentials page: 23 | 24 | 1. Expand the credentials you'd like to use to connect in order to copy the hostname and username. 25 | 2. Create a new [bookmark](../../cyberduck/bookmarks.md) and enter the following information: 26 | 27 | - **Protocol**: `SFTP (SSH File Transfer Protocol)` 28 | - **Server**: Hostname copied from SFTP To Go's dashboard 29 | - **Username**: Username copied from SFTP To Go's dashboard 30 | - **SSH Private key**: path to private key that matches the public key imported in SFTP To Go 31 | 32 | #### FTPS 33 | 34 | Login to SFTP To Go's dashboard and go to the credentials page: 35 | 36 | 1. Expand the credentials you'd like to use to connect in order to copy the hostname, username and password. 37 | 2. Create a new [bookmark](../../cyberduck/bookmarks.md) and enter the following information: 38 | 39 | - **Protocol**: `FTP-SSL (Explicit AUTH TLS)` 40 | - **Server**: Hostname copied from SFTP To Go's dashboard 41 | - **Username**: Username copied from SFTP To Go's dashboard 42 | - **Password**: Password copied from SFTP To Go's dashboard 43 | 44 | #### S3 45 | 46 | Login to SFTP To Go's dashboard and go to the credentials page: 47 | 48 | 1. Expand the root credentials to copy the S3 endpoint and secrets. 49 | 50 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 51 | 52 | - **Protocol**: `Amazon S3` 53 | - **Server**: Copy the bucket from SFTP To Go' dashboard and use them in the following pattern: `.s3.amazonaws.com` 54 | - **Access Key ID**: Access key ID copied from SFTP To Go's dashboard 55 | - **Secret Access Key**: Secret access key copied from SFTP To Go's dashboard 56 | - **Path**: Bucket name copied from SFTP To Go's dashboard 57 | 58 | ## References 59 | 60 | - [Connecting via SFTP](https://sftptogo.com/docs/how-to-connect/connect-using-sftp) 61 | - [Connecting via FTPS](https://sftptogo.com/docs/how-to-connect/connect-using-ftps) 62 | - [Connecting via Amazon S3](https://sftptogo.com/docs/how-to-connect/connect-using-amazon-s3) 63 | 64 | 65 | -------------------------------------------------------------------------------- /protocols/smb.md: -------------------------------------------------------------------------------- 1 | SMB 2 | ==== 3 | 4 | :::{image} _images/ftp.png 5 | :alt: FTP Drive Icon 6 | :width: 128px 7 | ::: 8 | 9 | :::{contents} Content 10 | :depth: 2 11 | :local: 12 | ::: 13 | 14 | > [SMB (Server Message Block)](https://en.wikipedia.org/wiki/Server_Message_Block) is used to access Windows File Shares 15 | > or a Samba Linux Server. 16 | 17 | ## Connecting 18 | 19 | :::{important} 20 | 21 | * Cyberduck [8.7.0](https://cyberduck.io/changelog/) or later required 22 | * Mountain Duck 5.0.0 required (not yet available) 23 | ::: 24 | 25 | To connect to a SMB server, choose _SMB (Server Message Block)_. 26 | 27 | :::{image} _images/SMB_Connection.png 28 | :alt: SMB Connection 29 | :width: 700px 30 | ::: 31 | 32 | ### Authentication 33 | 34 | Username and password must be provided for authentication using NTLM. The optional domain name defaults to `WORKGROUP` 35 | and can be customized as part of the username in the format `REALM\username` in the _Username_ input field when adding a 36 | bookmark. Depending on the server setup, this can be 37 | 38 | - `COMPUTERNAME\username` 39 | - `NETBIOSDOMAINNAME\username` 40 | 41 | The default domain can be set using the [hidden configuration option](../tutorials/hidden_properties.md) 42 | 43 | smb.domain.default=WORKGROUP 44 | 45 | ### Share Name 46 | 47 | To connect to a specific share, you can configure a _Path_ in the bookmark. When omitted an attempt is made to list all 48 | available shares from the server. On failure retrieving share names from the server, a prompt is displayed to enter the 49 | share name when connecting. 50 | 51 | :::{image} _images/SMB_Share.png 52 | :alt: SMB Share Input 53 | :width: 700px 54 | ::: 55 | 56 | ### Interoperability 57 | 58 | SMB protocol support has been tested with connections to the following server implementations 59 | 60 | - Windows 2016 Server (`SMB_3_1_1` dialect) 61 | - Windows 2022 Server (`SMB_3_1_1` dialect) 62 | - Linux Samba (`SMB_3_1_1` dialect) 63 | - macOS 13.5 (22G74) (`SMB_3_0_2` dialect) 64 | - SMB [Azure file shares](https://learn.microsoft.com/en-us/azure/storage/files/files-smb-protocol) 65 | 66 | ### Encryption 67 | 68 | By default, SMB connections are secured by signing and encrypting requests when supported by the server using SMBv3. 69 | Alternatively, use the connection profile with support for signing and encryption disabled. 70 | 71 | - {download}Install the *SMB (No Encryption) connection profile* from *Preferences… → Profiles*. 72 | 73 | ### Cyberduck CLI 74 | 75 | You can list shares with [Cyberduck CLI](https://duck.sh/) using 76 | 77 | ``` 78 | duck --list smb:/server/share/ 79 | ``` 80 | 81 | ## Limitations 82 | 83 | - Copying or moving files between shares is not supported -------------------------------------------------------------------------------- /protocols/spectra.md: -------------------------------------------------------------------------------- 1 | Spectra BlackPearl Deep Storage Gateway 2 | ==== 3 | 4 | ![Spectra Drive Icon](_images/spectra_128x128.png) 5 | 6 | > S3 Gateway to Deep Storage. The Spectra Logic BlackPearl Converged Storage System provides an easy, cloud-like interface to on-premise storage solutions, including to disk, tape, and cloud targets for maximum protection. 7 | 8 | ## Connecting 9 | 10 | - {download}`Download` the Spectra S3 (HTTPS) Connection Profile for preconfigured settings. 11 | - {download}`Download` the Spectra S3 (HTTP) Connection Profile for preconfigured settings. 12 | 13 | Refer to [Profiles](../cyberduck/connection.md#connection-profiles) for documentation about connection profiles. Choose Spectra BlackPearl Deep Storage Gateway (HTTP) from the list of protocols when editing a [bookmark](../cyberduck/bookmarks.md) or use the `spectra://` scheme when using the [CLI](../cli/index.md). 14 | 15 | ## Additional Information 16 | 17 | ### Transfer → Retries 18 | 19 | Reading a file from Spectra S3 might trigger a Retry wait for up to 300 seconds when the file is not yet in the cache. 20 | 21 | ![Cache Retry](_images/Cache_Retry.png) 22 | 23 | ### Transfer → Multiple Connections 24 | 25 | Use the lower right toggle to set the number of concurrent connections for file transfers. Refer to [Multiple Connections](../cyberduck/transfer.md#connections). This allows saturating the bandwidth when running in a fast local network. 26 | 27 | ![10GbE Transfer](_images/10GbE_Transfer.png) 28 | 29 | ## Limitations 30 | 31 | ### Rename and Move File 32 | 33 | Not supported. 34 | 35 | ## References 36 | 37 | - [S3 Gateway to Deep Storage](https://www.spectralogic.com/products/blackpearl/) 38 | - [The first RESTful interface to deep storage](https://www.spectralogic.com/products/spectra-s3/) 39 | - [Official Cyberduck BlackPearl Documentation](https://developer.spectralogic.com/cyberduck/) 40 | - [BlackPearl and Cyberduck Deliver End-to-End Hybrid Cloud Storage Solution](https://edge.spectralogic.com/index.cfm?&fuseaction=home.displayFile&DocID=4839) -------------------------------------------------------------------------------- /protocols/webdav/_images/NextCloud_Bookmark_Window.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/NextCloud_Bookmark_Window.png -------------------------------------------------------------------------------- /protocols/webdav/_images/Nextcloud_Download_Everyone.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/Nextcloud_Download_Everyone.png -------------------------------------------------------------------------------- /protocols/webdav/_images/Nextcloud_Drive_icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/Nextcloud_Drive_icon.png -------------------------------------------------------------------------------- /protocols/webdav/_images/Nextcloud_Share_Passphrase.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/Nextcloud_Share_Passphrase.png -------------------------------------------------------------------------------- /protocols/webdav/_images/WebDAV_Bookmark_Client_Certificate.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/WebDAV_Bookmark_Client_Certificate.png -------------------------------------------------------------------------------- /protocols/webdav/_images/Windows-Security-Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/Windows-Security-Prompt.png -------------------------------------------------------------------------------- /protocols/webdav/_images/ownCloud_Drive_icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/protocols/webdav/_images/ownCloud_Drive_icon.png -------------------------------------------------------------------------------- /protocols/webdav/bigcommerce.md: -------------------------------------------------------------------------------- 1 | BigCommerce 2 | ==== 3 | 4 | ## Connecting 5 | 6 | ### Manual Configuration 7 | 1. Obtain your WebDAV credentials and setup details from your BigCommerce control panel ([Server Settings → File Access (WebDAV)](http://login.bigcommerce.com/deep-links/settings/file-access)). 8 | 2. Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 9 | - **Protocol**: `WebDAV (HTTPS)` 10 | - **Server**: The domain name of your WebDAV Path with the protocol scheme `https://` and path `/dav` removed. 11 | - **Username**: Your WebDAV username 12 | - **Password**: Your WebDAV password 13 | - **Path**: `dav` 14 | 15 | ### Connection Profile 16 | Go to [Settings → File access (WebDAV)](http://login.bigcommerce.com/deep-links/settings/file-access) and click _Download_ next to _Cyberduck Connection Profile_ file. Open the [connection profile](../../protocols/profiles/index.md) with Cyberduck to create a bookmark with pre-configured settings. 17 | 18 | ## Interoperability 19 | 20 | :::{warning} 21 | Ensure that that filenames contain no whitespace. 22 | ::: 23 | 24 | ## References 25 | 26 | - [File Access (WebDAV)](https://support.bigcommerce.com/s/article/File-Access-WebDAV) 27 | - [Connecting to WebDAV with Cyberduck](https://support.bigcommerce.com/s/article/File-Access-WebDAV#cyberduck) 28 | - [Uploading and Linking to a File in Your Store](https://support.bigcommerce.com/s/article/How-do-I-add-and-link-to-a-file-in-my-store?language=en_US) -------------------------------------------------------------------------------- /protocols/webdav/gmx.md: -------------------------------------------------------------------------------- 1 | GMX Cloud 2 | ==== 3 | 4 | > Die sichere [GMX Cloud](https://www.gmx.net/cloud/) steht Ihnen als Nutzer kostenlos im Postfach zur Verfügung. Über die Cloud können Sie online auf Ihre Dateien zugreifen – überall und jederzeit. 5 | 6 | ## Connecting 7 | 8 | ### Connection Profile 9 | 10 | {download}`Download` the *GMX Cloud Connection Profile* for preconfigured settings. 11 | 12 | ### Manual Configuration 13 | 14 | - **Protocol**: `WebDAV (HTTPS)` 15 | - **Server**: `webdav.mc.gmx.net` 16 | - **Username**: `GMX Kundenummer` or `GMX email` 17 | 18 | ## References 19 | 20 | - [GMX Kundennummer](https://hilfe.gmx.net/account/verwalten/kundennummer.html?pos=1#) -------------------------------------------------------------------------------- /protocols/webdav/ikeepincloud.md: -------------------------------------------------------------------------------- 1 | iKeepinCloud 2 | ==== 3 | 4 | > [iKeepinCloud](https://www.ikoula.com/en/ikeepincloud) is a cloud storage with online storage space from IKoula. 5 | 6 | ## Connecting 7 | 8 | - **Protocol**: `WebDAV (HTTP)`, `WebDAV (HTTPS)`, `SFTP`, `FTPS` or `FTP` 9 | - **Server**: `.ikeepincloud.com` or public.`.ikeepincloud.com` 10 | - **Username**: Your subscription ID 11 | - **Password**: the one sent by IKoula 12 | 13 | ## References 14 | 15 | - [Utilisation d'iKeepinCloud avec Cyberduck](https://support.ikoula.com/index-1-2-214-2448-ikeepincloud-ikic-stockage-cloud-mac-cyberduck.html) 16 | - [Utilisation du protocole SFTP/Rsync over SSH avec iKeepinCloud](https://support.ikoula.com/index-1-2-217-2458-ikeepincloud-ikic-stockage-cloud-protocole-sftp-rsync-over-ssh-bitkinex-filezilla-cyberduck-fireftp.html) -------------------------------------------------------------------------------- /protocols/webdav/kdrive.md: -------------------------------------------------------------------------------- 1 | Infomaniak kDrive 2 | ==== 3 | 4 | > kDrive is an online platform which enables you to retain a copy of your files and share them with employees. 5 | 6 | ## Connecting 7 | 8 | Enter the following information in the [bookmark](../../cyberduck/bookmarks.md): 9 | 10 | - **Protocol**: `WebDAV (HTTPS)` 11 | - **Server**: `connect.drive.infomaniak.com` 12 | - **Username**: Your kDrive login email. 13 | - **Password**: 14 | - If two-step authentication is not activated, use the password for your Infomaniak account 15 | - If two-step authentication is activated, generate an [application password](https://manager.infomaniak.com/v3/profile/application-password) 16 | 17 | ## Known Issues 18 | 19 | ### Can't Upload Files (Mountain Duck) 20 | 21 | kDrive doesn't accept uploads with unknown file sizes. Because of this files can't be uploaded within the *Online* mode as the actual file size can't be reported at the beginning of the upload. The *Smart Synchronization* mode can be used instead as a workaround. 22 | 23 | ## References 24 | 25 | - [kDrive: logging in to your Drive via WebDAV](https://www.infomaniak.com/en/support/faq/2409/kdrive-logging-in-to-your-drive-via-webdav) 26 | -------------------------------------------------------------------------------- /protocols/webdav/pcloud.md: -------------------------------------------------------------------------------- 1 | pCloud 2 | ==== 3 | 4 | > [pCloud](https://www.pcloud.com/) is encrypted cloud storage, where you can store your personal files, backup your PC or share your business documents with your colleagues. 5 | 6 | ## Connecting 7 | 8 | :::{attention} 9 | WebDAV access is only available for paid plans. 10 | ::: 11 | 12 | ### Connection Profiles 13 | 14 | :::{note} 15 | Connection profiles can be installed from *Preferences → Profiles*. 16 | ::: 17 | 18 | - **pCloud Europe (Luxemburg):** {download}`Download` the *pCloud Europe (Luxemburg) Connection Profile* for preconfigured settings. 19 | - **pCloud Texas (USA):** {download}`Download` the *pCloud Texas (USA) Connection Profile* for preconfigured settings. 20 | 21 | ### Manual Configuration 22 | 23 | #### Data Region: USA (Texas) 24 | 25 | - **Server**: `https://webdav.pcloud.com` 26 | - **Port**: `443` 27 | - **Username**: pCloud login Email 28 | - **Password**: pCloud login password 29 | 30 | #### Data Region: Europe (Luxemburg) 31 | 32 | - Server: `https://ewebdav.pcloud.com` 33 | - Port: `443` 34 | - Username: pCloud login Email 35 | - Password: pCloud login password 36 | 37 | ## Interoperability 38 | 39 | Using Mountain Duck and pCloud Client simultaneously can cause issues for the pCloud Client. The Client requires an older version of the device driver than Mountain Duck and can't deal with the newer version installed by Mountain Duck. 40 | 41 | :::{note} 42 | Reported for pCloud Client version 4.0.0 (Windows). 43 | ::: 44 | 45 | ## References 46 | 47 | - [pCloud via WebDAV ansprechen](https://www.techstream.at/pcloud-via-webdav-ansprechen-geht-das/) -------------------------------------------------------------------------------- /protocols/webdav/providers.md: -------------------------------------------------------------------------------- 1 | Third-Party Providers 2 | === 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | bigcommerce 8 | gmx 9 | ikeepincloud 10 | nextcloud 11 | pcloud 12 | seafile 13 | kdrive 14 | ::: 15 | 16 | For some providers specific connection profiles are provided with pre-configured settings. 17 | 18 | :::{note} 19 | Connection profiles can be installed from *Preferences → Profiles*. 20 | ::: 21 | -------------------------------------------------------------------------------- /protocols/webdav/seafile.md: -------------------------------------------------------------------------------- 1 | Seafile 2 | ==== 3 | 4 | > [Seafile](https://seafile.com/) Enterprise file sync and share platform with high reliability and performance. 5 | 6 | ## References 7 | 8 | - [Seafile WebDAV Server (SeafDAV)](https://manual.seafile.com/extension/webdav/) -------------------------------------------------------------------------------- /requirements.txt: -------------------------------------------------------------------------------- 1 | myst-parser 2 | sphinx-tabs 3 | sphinx_rtd_theme 4 | 5 | # Pin docutils 6 | docutils~=0.18.0 -------------------------------------------------------------------------------- /tutorials/_images/1Password_Authorize_SSH_Key_Usage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/1Password_Authorize_SSH_Key_Usage.png -------------------------------------------------------------------------------- /tutorials/_images/1Password_SSH_Agent_Edit_Automatically.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/1Password_SSH_Agent_Edit_Automatically.png -------------------------------------------------------------------------------- /tutorials/_images/1Password_SSH_Agent_Settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/1Password_SSH_Agent_Settings.png -------------------------------------------------------------------------------- /tutorials/_images/1Password_SSH_Key_Create.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/1Password_SSH_Key_Create.png -------------------------------------------------------------------------------- /tutorials/_images/APIs_Services_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/APIs_Services_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/Access_Cryptomator_Vault_Cyberduck.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Access_Cryptomator_Vault_Cyberduck.png -------------------------------------------------------------------------------- /tutorials/_images/Access_Cryptomator_Vault_Mountain_Duck.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Access_Cryptomator_Vault_Mountain_Duck.png -------------------------------------------------------------------------------- /tutorials/_images/App_Information_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/App_Information_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/Application_Type_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Application_Type_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/Bitwarden_Confirm_SSH_Key_Usage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Bitwarden_Confirm_SSH_Key_Usage.png -------------------------------------------------------------------------------- /tutorials/_images/Bitwarden_SSH_Agent_Settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Bitwarden_SSH_Agent_Settings.png -------------------------------------------------------------------------------- /tutorials/_images/Bitwarden_SSH_Key_Create.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Bitwarden_SSH_Key_Create.png -------------------------------------------------------------------------------- /tutorials/_images/Bookmark_Panel.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Bookmark_Panel.png -------------------------------------------------------------------------------- /tutorials/_images/Client_ID_Credentials.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Client_ID_Credentials.png -------------------------------------------------------------------------------- /tutorials/_images/Consent_Screen_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Consent_Screen_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/Create_New_Project_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Create_New_Project_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/Enable_APIs_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Enable_APIs_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/List_of_Scopes_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/List_of_Scopes_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/Local_Disk_Connection.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Local_Disk_Connection.png -------------------------------------------------------------------------------- /tutorials/_images/OAuth_Client_ID_Credentials.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/OAuth_Client_ID_Credentials.png -------------------------------------------------------------------------------- /tutorials/_images/Search_Google_API.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Search_Google_API.png -------------------------------------------------------------------------------- /tutorials/_images/Test_Users_Client_ID.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/Test_Users_Client_ID.png -------------------------------------------------------------------------------- /tutorials/_images/YubiKey_Agent_PIN_Prompt.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/iterate-ch/docs/aa9f185e0eea20a3047335288a65187ce7ef9b42/tutorials/_images/YubiKey_Agent_PIN_Prompt.png -------------------------------------------------------------------------------- /tutorials/cli_github_action.md: -------------------------------------------------------------------------------- 1 | Use Cyberduck CLI GitHub Action 2 | === 3 | 4 | Use Cyberduck CLI in a [GitHub Actions](https://docs.github.com/en/actions) workflow conveniently in a docker container. 5 | 6 | ## Usage in Custom Workflow 7 | 8 | 1. Add the `[cyberduck-cli-action](https://github.com/iterate-ch/cyberduck-cli-action)` action to a workflow `.yml` with a step like 9 | 10 | ``` 11 | - name: Upload 12 | uses: iterate-ch/cyberduck-cli-action@v1 13 | env: 14 | USERNAME: ${{secrets.S3_ACCESS_KEY}} 15 | PASSWORD: ${{secrets.S3_SECRET_KEY}} 16 | with: 17 | mode: upload 18 | url: 's3:/bucket/path/' 19 | path: 'release/*' 20 | args: '--verbose' 21 | ``` 22 | 23 | 2. Choose a `mode`. Several modes are supported like `download`, `list` and `upload` probably the most common usage. If you want to any of the supported command line parameters use `raw` and omit the `path` and `url` options. 24 | 25 | 3. Set the `url` input option to a valid URI that references the protocol, optional server and destination upload file or directory as [documented](https://docs.duck.sh/cli/#uri). For [S3](https://docs.duck.sh/protocols/s3/) this would be `s3://` or for [SFTP](https://docs.duck.sh/protocols/sftp/) `sftp:////`. 26 | 27 | :::{attention} 28 | Make sure to include a trailing `/` in `url` input to denote a directory. 29 | ::: 30 | 31 | 4. Specify credentials in the environment with `USERNAME`, `PASSWORD`. Additionally `IDENTITY` can be used for SFTP connections equivalent to the `--identity` parameter. The example assumes you have `S3_ACCESS_KEY` and `S3_SECRET_KEY` defined as a [secret](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions). Alternatively specify `--username ${{secrets.USER}} --password ${{secrets.PASSWORD}}` in `args`. 32 | 33 | 5. Add additional arguments for Cyberduck CLI. Any of the available [generic options](https://docs.duck.sh/cli/#generic-options) can be passed with the `args` input. 34 | 35 | :::{tip} 36 | Only overwrite existing files on changes using `args: '--existing compare'`. 37 | ::: 38 | 39 | 6. Read output in a next step using the key `log` using `jobs..outputs.log` [output](https://docs.github.com/en/actions/sharing-automations/creating-actions/metadata-syntax-for-github-actions#outputsoutput_id). 40 | 41 | ## References 42 | 43 | * Cyberduck CLI GitHub Action [README](https://github.com/iterate-ch/cyberduck-cli-action/blob/main/README.md) -------------------------------------------------------------------------------- /tutorials/iam.md: -------------------------------------------------------------------------------- 1 | AWS Identity & Access Management (IAM) 2 | ==== 3 | 4 | IAM allows you to create credentials for third parties accessing your S3 account with permission constraints. 5 | 6 | ## Console 7 | 8 | You can manage IAM users using the [AWS Console](https://console.aws.amazon.com/iam/home). 9 | 10 | ## IAM Tools Setup 11 | 12 | 1. Download the [IAM Command Line Toolkit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/index.html). Unzip the download and move the folder `IAMCli-1.2.0` into the `bin` folder in your user home directory. 13 | 1. In a Terminal.app window, set the home environment for IAM 14 | ``` 15 | echo 'export JAVA_HOME=`/usr/libexec/java_home`' >> ~/.bash_profile 16 | echo 'export AWS_IAM_HOME=~/bin/IAMCli-1.2.0' >> ~/.bash_profile 17 | ``` 18 | 1. Set the environment variable to point to the credentials file. 19 | ``` 20 | echo 'export AWS_CREDENTIAL_FILE=$AWS_IAM_HOME/aws-credential.template' >> ~/.bash_profile 21 | ``` 22 | 1. Add the path to the IAM programs to your path 23 | ``` 24 | echo 'export PATH=$AWS_IAM_HOME/bin:$PATH' >> ~/.bash_profile 25 | ``` 26 | 1. Update the environment of the current shell (alternatively open a new Terminal.app window). 27 | ``` 28 | . ~/.bash_profile 29 | ``` 30 | 1. Edit the credentials file `aws-credential.template` with your AWS identifiers. 31 | 32 | ## Create a new IAM User 33 | 34 | Add a new IAM user and generate the access credentials. This will print out the *Access Key ID* and *Secret Access Key* to use when logging in with Cyberduck. 35 | 36 | ``` 37 | iam-usercreate -u ;iam-useraddkey -u 38 | ``` 39 | 40 | ## Attach a Policy 41 | 42 | Add a new policy for the user. This example gives the user access to all of your S3 resources. 43 | 44 | ``` 45 | iam-useraddpolicy -u -e Allow -a s3:* -r arn:aws:s3:::* -o -p `uuidgen` 46 | ``` 47 | 48 | ### Restrict Access to a Specific Bucket 49 | 50 | - Allow user to list contents of the bucket. 51 | ``` 52 | iam-useraddpolicy -u -e Allow -a s3:ListBucket -r arn:aws:s3:::bucketname -o -p `uuidgen` 53 | ``` 54 | - Allow users to download files in the bucket. 55 | ``` 56 | iam-useraddpolicy -u -e Allow -a s3:GetObject -r arn:aws:s3:::bucketname/* -o -p `uuidgen` 57 | ``` 58 | 59 | ## Connecting 60 | 61 | When you only have access to a specific bucket in the AWS account and don't have the permission to list all buckets, make sure to put `bucketname.s3.amazonaws.com` in the *Server* field of the bookmark. 62 | 63 | ## References 64 | 65 | - [AWS Identity and Access Management (IAM) Documentation](http://aws.amazon.com/documentation/iam/) -------------------------------------------------------------------------------- /tutorials/index.md: -------------------------------------------------------------------------------- 1 | Tutorials 2 | ==== 3 | 4 | :::{toctree} 5 | :hidden: 6 | :titlesonly: 7 | hidden_properties 8 | custom_oauth_client_id 9 | iam 10 | vault_localdisk 11 | sftp_publickeyauth 12 | sftp_publickeyauth_1password 13 | sftp_publickeyauth_bitwarden 14 | sftp_publickeyauth_yubikey 15 | cli_github_action 16 | ::: 17 | 18 | Find detailed step-by-step instructions for setup, connecting and most common use-cases as well as tutorials for more complicated workarounds. 19 | 20 | ## [Setup a Custom OAuth Client ID for Google Drive & Google Cloud Storage](custom_oauth_client_id.md) 21 | Workaround to register your own Custom OAuth 2.0 Client ID for [Google Cloud Storage](../protocols/googlecloudstorage.md) and [Google Drive](../protocols/googledrive.md) and use it with a custom connection profile instead when encountering `This app is blocked` error when accessing Google Drive or Google Cloud Storage. 22 | 23 | ## [Add Hidden Configuration Options to Mountain Duck and Cyberduck](hidden_properties.md) 24 | Configure hidden preferences. 25 | 26 | ## [AWS Identity & Access Management (IAM)](iam.md) 27 | IAM allows you to create credentials for third parties accessing your S3 account with permission constraints. 28 | 29 | ## [Access Vaults on Local Disk](vault_localdisk.md) 30 | Both [Cyberduck](../cyberduck/index.md) and [Mountain Duck](../mountainduck/index.md) support accessing vaults on your local disk. 31 | 32 | ## [Configure Public Key Authentication for SFTP](sftp_publickeyauth.md) 33 | Configure Public Key Authentication for SFTP using OpenSSH tools. 34 | 35 | ### [Configure 1Password SSH Agent](sftp_publickeyauth_1password.md) 36 | Authenticate with SSH private key saved in 1Password. 37 | 38 | ### [Configure Bitwarden SSH Agent](sftp_publickeyauth_bitwarden.md) 39 | Authenticate with SSH private key saved in Bitwarden. 40 | 41 | ### [Use YubiKey](sftp_publickeyauth_yubikey.md) 42 | Authenticate with SSH private key saved on YubiKey. 43 | 44 | ## [Use Cyberduck CLI GitHub Action](cli_github_action.md) 45 | Use Cyberduck CLI Docker Container in GitHub Actions -------------------------------------------------------------------------------- /tutorials/sftp_publickeyauth.md: -------------------------------------------------------------------------------- 1 | Configure Public Key Authentication for SFTP using OpenSSH 2 | ==== 3 | 4 | Public-key authentication allows you to connect to a remote server without a password. Instead, public-key authentication uses two keys: 5 | - Private key kept in a file and protected with a password. 6 | - Public key placed on the server. 7 | 8 | 1. Run the command `ssh-keygen` from the _Terminal.app_ (macOS) or _Console_ (Windows) to generate a public/private pair 9 | of keys. They will be put in your directory `~/.ssh`, though you will probably be asked to approve or change this 10 | location. When you generate the keys you will be asked for a passphrase. If you use a *passphrase*, then you will 11 | have to enter it when connecting. Use the key format (`-m PEM`) to create the keys in OpenSSL `PEM` format. Specify the type of key with the parameter `-t` as either `ecdsa`, `ed25519` or `rsa`. 12 | 13 | ``` 14 | ssh-keygen -m PEM -t rsa 15 | ``` 16 | 17 | 2. Copy the public key to the server you wish to access and add it to the file `authorized_keys` in your `~/.ssh` 18 | directory. This will cause the server to allow authenticating with your corresponding private key. 19 | ``` 20 | ssh user@remotehost < ~/.ssh/id_rsa.pub 'cat >> .ssh/authorized_keys' 21 | ``` 22 | 3. In the [Bookmark](../cyberduck/bookmarks.md) or [Connection](../cyberduck/connection.md) window, in *SSH Private Key* select the private key in your `~/.ssh` directory. When connecting, you will be prompted to enter the password for the private key. Choose *Save Password* to [save the password](../cyberduck/connection.md#passwords). 23 | -------------------------------------------------------------------------------- /tutorials/vault_localdisk.md: -------------------------------------------------------------------------------- 1 | Access Cryptomator Vaults on Local Disk 2 | === 3 | 4 | 1. Create a new [bookmark](../cyberduck/bookmarks) to connect to your local disk in Cyberduck or Mountain Duck. You can 5 | access any directory on your local disk that you may preset in the _Path_ option. This includes for example the 6 | folders of your local synchronized [Dropbox](../protocols/dropbox), [Google Drive](../protocols/googledrive) 7 | and [OneDrive](../protocols/onedrive) contents. 8 | 9 | :::{image} _images/Local_Disk_Connection.png 10 | :alt: Local Disk Connection 11 | :width: 600px 12 | ::: 13 | 14 | 1. Choose _Connect_ and navigate to the directory containing your vault. 15 | 16 | 1. Double-clicking the vault in Cyberduck or opening the vault in Finder or Windows Explorer when connected with Mountain Duck will show _Unlock Vault_ prompt if you have _[Auto Detect](../cryptomator/index.md#auto-detect)_ enabled. Alternatively choose to _[Unlock Vault](../cryptomator/index.md#unlock-vault)_. 17 | 18 | 1. Enter the vault _Passphrase_ required to unlock and decrypt the vault contents. Optionally choose _[Save Password](../cryptomator/index.md#save-passphrase)_ if you want to store the passphrase for future usage. 19 | 20 | :::::{tabs} 21 | ::::{group-tab} Mountain Duck 22 | 23 | :::{image} _images/Access_Cryptomator_Vault_Mountain_Duck.png 24 | :alt: Mountain Duck Cryptomator Vault 25 | :width: 600px 26 | ::: 27 | 28 | :::: 29 | ::::{group-tab} Cyberduck 30 | 31 | :::{image} _images/Access_Cryptomator_Vault_Cyberduck.png 32 | :alt: Cyberduck Access Cryptomator Vault 33 | :width: 600px 34 | ::: 35 | 36 | :::: 37 | ::::: 38 | 39 | 2. Choose the _Continue_ button to show the decrypted contents of the vault. 40 | --------------------------------------------------------------------------------