From d1a1ae62361bdb1ff5fe8378362af8698a5bd460 Mon Sep 17 00:00:00 2001 From: Cassie205 Date: Tue, 26 Mar 2024 17:07:21 +0100 Subject: [PATCH] Update Cyberduck FAQ --- cyberduck/connection.md | 12 +++- cyberduck/faq.md | 118 ++++++-------------------------------- cyberduck/index.md | 1 + cyberduck/installation.md | 96 +++++++++++++++++++++++++++++++ 4 files changed, 124 insertions(+), 103 deletions(-) create mode 100644 cyberduck/installation.md diff --git a/cyberduck/connection.md b/cyberduck/connection.md index c9b58a99..0b9298a1 100644 --- a/cyberduck/connection.md +++ b/cyberduck/connection.md @@ -95,14 +95,22 @@ Drag an URL from any third-party application to a browser window. ## Problems Connecting -### I get an Error `IO Error: Broken pipe` +### Error `IO Error: Broken pipe` There was a problem with the underlying network stream either because the connection was too slow or the server wouldn't give a response anymore. Often this is caused when you run out of quota on the server - meaning that your user account is not allowed to use any more disk space. -### I get an Error `IO Error: Read Timed Out` +### Error `IO Error: Read Timed Out` When attempting to open a connection, there is either a firewall blocking requests, or no server is listening at the given address and port. If you get this error while already connected to the server, the network connection to the server is too slow or has too high latency. You can try to increase the connection timeout in *Preferences → Connection → Timeouts*. +### Autofill of Passwords + +Passwords will be autofilled as long as you choose to enable the _Use Keychain_ option and saved a corresponding credentials. + +### Reachability Alert + +A warning sign next to the URL indicates the server may not be reachable due to a missing or invalid hostname in the _Server_ field. + ## Passwords `````{tabs} diff --git a/cyberduck/faq.md b/cyberduck/faq.md index 7020e7b1..1d0030ef 100644 --- a/cyberduck/faq.md +++ b/cyberduck/faq.md @@ -21,17 +21,21 @@ Cyberduck is free software. Free software is a matter of the users' freedom to r :width: 600px ``` -### Mac App Store +#### What payment options are available? + +Donations can be made by using PayPal or Credit card. Alternatively, you can purchase Cyberduck via App Store. + +#### Mac App Store The presence of Cyberduck is important for the visibility of the project in particular for new and average users on the Mac platform. The caveat is that the donation key model is not supported in the App Store per the developer agreement. Software asking for voluntary contributions does not get approved. We have therefore opted to distribute Cyberduck in the App Store for a fixed price with no donation prompt. It is your choice to buy the version from the App Store or download from the website and opt in for a payment if you feel like. Cyberduck is libre (FLOSS) software and will remain so in the future. Your purchase receipt from the App Store version is copied to the Application Support folder and recognized as a key when running any version of Cyberduck. -### Windows App Store +#### Windows App Store The Windows Store does not support the donation key model. We have therefore opted to distribute Cyberduck in the Windows Store for a fixed price with no donation prompt. It is your choice to buy the version from the Windows Store or download from the website and opt-in for a payment if you feel like. Cyberduck is libre (FLOSS) software and will remain so in the future. -#### Troubleshooting +##### Troubleshooting If you bought Cyberduck on Windows Store, but you are not allowed to use Cyberduck due to a Trial Expired error message, please execute the following steps to ensure that your local app license cache is up-to-date – a reinstall of Cyberduck via Windows Store does not refresh your license. @@ -52,6 +56,14 @@ If these steps are not resolving the trial expired message please follow these a 3. Paste it into the window 4. Run it and wait for completion. +### What are the System requirements for Cyberduck? + +The system requirements are listed in the [installation section](installation.md#system-requirements). + +#### Can I install older version if necessary? + +The recent release can be found on our [website](https://cyberduck.io/download/). In case your operating system requires an older version of Cyberduck you can download installers for previous versions in our [changelog](https://cyberduck.io/changelog/). + ## Registration Keys As a contributor to Cyberduck, you receive a registration key that disables the donation prompt that is displayed when quitting Cyberduck. @@ -74,78 +86,6 @@ The registration key is sent to you by email automatically after the Paypal tran - Contact you hosting service provider how to download attachments. - Forward the mail to a different mail account where you possibly don't have an issue downloading attachments. -## System Requirements - -`````{tabs} -````{group-tab} macOS - -- Cyberduck [8.1](https://trac.cyberduck.io/milestone/8.1) or later requires *Mac OS X 10.12* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) or [Apple silicon](https://support.apple.com/en-us/HT211814) architecture -- Cyberduck [7.7](https://trac.cyberduck.io/milestone/7.7.0) or later requires *Mac OS X 10.9* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture -- Cyberduck 7.1 or later requires *Mac OS x 10.8* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture -- Cyberduck 4.7 or later requires *Mac OS X 10.7* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture -- Cyberduck 4.4 or later requires *Mac OS X 10.6* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture -- Cyberduck [3.3](https://trac.cyberduck.io/milestone/3.3) or later requires *Mac OS X 10.5* or later. -- Cyberduck [3.0](https://trac.cyberduck.io/milestone/3.0) or later requires *Mac OS X 10.4* or later. The latest version [available](http://cyberduck.ch/changelog) is [3.2.1](http://update.cyberduck.ch/Cyberduck-3.2.1.dmg) supporting *Mac OS X 10.4*. -- Cyberduck 2.5 or later requires *Mac OS X 10.3.9* or later. The latest version [available](http://cyberduck.ch/changelog) is [2.8.5](http://update.cyberduck.ch/Cyberduck-2.8.5.dmg) supporting *Mac OS X 10.3.9*. -- Cyberduck 2.3 or later requires *Mac OS X 10.2* or later. The latest version [available](http://cyberduck.ch/changelog) is [2.3.3](http://update.cyberduck.ch/Cyberduck-2.3.3.dmg) supporting *Mac OS X 10.2*. - -```` -````{group-tab} Windows - -Requires *.NET Framework 4.7.2*. If the [.NET Framework installation](https://dotnet.microsoft.com/download/dotnet-framework/net472) fails, download it manually. - -- Cyberduck [7.1](https://trac.cyberduck.io/milestone/7.1) or later requires *Windows 7 SP1, Windows 8.1, or Windows 10 (14393)* or later on 64bit. -- Cyberduck [5.3](https://trac.cyberduck.io/milestone/5.3) or later requires *Windows 7* or later -- Cyberduck [4.8](https://trac.cyberduck.io/milestone/4.8) or later requires *Windows Vista* or later. -- Cyberduck [4.0](https://trac.cyberduck.io/milestone/4.0) or later requires *Windows XP or Windows 7* or later. - -```` -````` - -## Installation - -`````{tabs} -````{group-tab} macOS - -Move the unzipped application bundle *Cyberduck.app* from the *Downloads* to the */Applications* folder on your harddisk. - -```` -````{group-tab} Windows - -**EXE Installer** - -Run the *Cyberduck Installer* executable. For an unattached installation, use the silent option (command line option `/s`). - - -**MSI Installer** - -Download *MSI Installer* for corporate environments. Requires prior installation of [Microsoft .NET Framework 4.5.1](https://www.microsoft.com/en-us/download/details.aspx?id=40779). - - -**Chocolatey** - -There is also a [Chocolatey](http://chocolatey.org/packages?q=cyberduck) package maintained. - -**What to do if Windows Installer goes haywire?** -In some cases, the windows gets confused over the installed product and goes haywire. As a result the product can't be modified anymore. To fix the state, run the following command: - `reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" /s /f "Product Name"` - `reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Installer\Products" /s /f "Product Name"` - -You should get an output like this: - `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{23067521-119B-4B0A-BCDD-38835D58077B} - DisplayName REG_SZ Cyberduck` - -Delete the key using the following command: - `reg delete "output" /f` - -Based on the example output it should look like this: - `reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{23067521-119B-4B0A-BCDD-38835D58077B}" /f` - -After restarting the system, the installer shouldn't complain anymore. - -```` -````` - ### Preferences and Application Support Files Location `````{tabs} @@ -173,31 +113,7 @@ Preferences are stored in `%AppData%\Cyberduck\cyberduck.user.config`. Please no ```` ````` -### Complete Uninstall - -Follow the steps below to uninstall Cyberduck completely. - -`````{tabs} -````{group-tab} macOS - -1. Close the application and navigate to the application folder using the shortcut `⌘⇧A`. Select *Cyberduck.app* and delete the application by choosing *File → Move to Trash*. -2. Navigate to the *Group Containers* folder within *~/Library/* and delete the folder *G69SCX94XU.duck*. -3. **Optional:** Delete all saved login credentials in *Keychain Access.app*. - -```` - -````{group-tab} Windows - -1. Close the application and open the start menu using the shortcut `Ctrl Esc`. Search for *Apps & Features* and move to the entry *Cyberduck*. Click on the application, choose *Uninstall*, and confirm your intentions by clicking *Uninstall* again. -2. Navigate to the `%AppData%`and delete the folder *Cyberduck* -3. Navigate to `%LocalAppData%`and delete the folder *Cyberduck* -4. **Optional:** Delete all saved login credentials in *Windows Credential Manager*. - -```` - -````` - -## Bug Reports and Feature Requests +## Where can I issue Bug Reports and Feature Requests? To get help with bugs, feature requests, or other issues please refer to the [support page](support.md). @@ -209,4 +125,4 @@ See _[Preferences → Update](preferences.md#update)_ to switch the update feed. - *WindowDragon*. Cyberduck is [not compatible](http://sourceforge.net/tracker/index.php?func=detail&aid=1942730&group_id=208546&atid=1006129) with WindowDragon. - Sophos Anti-Virus *On-access Scanning* -- Opening the web browser to authenticate using OAuth does not work with [Browser Chooser 2](https://browserchooser2.com/). \ No newline at end of file +- Opening the web browser to authenticate using OAuth does not work with [Browser Chooser 2](https://browserchooser2.com/). diff --git a/cyberduck/index.md b/cyberduck/index.md index 319953d5..9ba347dd 100644 --- a/cyberduck/index.md +++ b/cyberduck/index.md @@ -4,6 +4,7 @@ Cyberduck ```{toctree} :hidden: :titlesonly: +installation bookmarks connection browser diff --git a/cyberduck/installation.md b/cyberduck/installation.md new file mode 100644 index 00000000..2bfc563c --- /dev/null +++ b/cyberduck/installation.md @@ -0,0 +1,96 @@ +Installation +=== + +`````{tabs} +````{group-tab} macOS + +Move the unzipped application bundle *Cyberduck.app* from the *Downloads* to the */Applications* folder on your harddisk. + +```` +````{group-tab} Windows + +**EXE Installer** + +Run the *Cyberduck Installer* executable. For an unattached installation, use the silent option (command line option `/s`). + + +**MSI Installer** + +Download *MSI Installer* for corporate environments. Requires prior installation of [Microsoft .NET Framework 4.5.1](https://www.microsoft.com/en-us/download/details.aspx?id=40779). + + +**Chocolatey** + +There is also a [Chocolatey](http://chocolatey.org/packages?q=cyberduck) package maintained. + +**What to do if Windows Installer goes haywire?** +In some cases, the windows gets confused over the installed product and goes haywire. As a result the product can't be modified anymore. To fix the state, run the following command: + `reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" /s /f "Product Name"` + `reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Installer\Products" /s /f "Product Name"` + +You should get an output like this: + `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{23067521-119B-4B0A-BCDD-38835D58077B} + DisplayName REG_SZ Cyberduck` + +Delete the key using the following command: + `reg delete "output" /f` + +Based on the example output it should look like this: + `reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{23067521-119B-4B0A-BCDD-38835D58077B}" /f` + +After restarting the system, the installer shouldn't complain anymore. + +```` +````` + +## System Requirements + +`````{tabs} +````{group-tab} macOS + +- Cyberduck [8.1](https://trac.cyberduck.io/milestone/8.1) or later requires *Mac OS X 10.12* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) or [Apple silicon](https://support.apple.com/en-us/HT211814) architecture +- Cyberduck [7.7](https://trac.cyberduck.io/milestone/7.7.0) or later requires *Mac OS X 10.9* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture +- Cyberduck 7.1 or later requires *Mac OS x 10.8* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture +- Cyberduck 4.7 or later requires *Mac OS X 10.7* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture +- Cyberduck 4.4 or later requires *Mac OS X 10.6* or later and a [64Bit Intel](http://support.apple.com/kb/ht3696) architecture +- Cyberduck [3.3](https://trac.cyberduck.io/milestone/3.3) or later requires *Mac OS X 10.5* or later. +- Cyberduck [3.0](https://trac.cyberduck.io/milestone/3.0) or later requires *Mac OS X 10.4* or later. The latest version [available](http://cyberduck.ch/changelog) is [3.2.1](http://update.cyberduck.ch/Cyberduck-3.2.1.dmg) supporting *Mac OS X 10.4*. +- Cyberduck 2.5 or later requires *Mac OS X 10.3.9* or later. The latest version [available](http://cyberduck.ch/changelog) is [2.8.5](http://update.cyberduck.ch/Cyberduck-2.8.5.dmg) supporting *Mac OS X 10.3.9*. +- Cyberduck 2.3 or later requires *Mac OS X 10.2* or later. The latest version [available](http://cyberduck.ch/changelog) is [2.3.3](http://update.cyberduck.ch/Cyberduck-2.3.3.dmg) supporting *Mac OS X 10.2*. + +```` +````{group-tab} Windows + +Requires *.NET Framework 4.7.2*. If the [.NET Framework installation](https://dotnet.microsoft.com/download/dotnet-framework/net472) fails, download it manually. + +- Cyberduck [7.1](https://trac.cyberduck.io/milestone/7.1) or later requires *Windows 7 SP1, Windows 8.1, or Windows 10 (14393)* or later on 64bit. +- Cyberduck [5.3](https://trac.cyberduck.io/milestone/5.3) or later requires *Windows 7* or later +- Cyberduck [4.8](https://trac.cyberduck.io/milestone/4.8) or later requires *Windows Vista* or later. +- Cyberduck [4.0](https://trac.cyberduck.io/milestone/4.0) or later requires *Windows XP or Windows 7* or later. + +```` +````` + +## Complete Uninstall + +Follow the steps below to uninstall Cyberduck completely. + +`````{tabs} +````{group-tab} macOS + +1. Close the application and navigate to the application folder using the shortcut `⌘⇧A`. Select *Cyberduck.app* and delete the application by choosing *File → Move to Trash*. +2. Navigate to the *Group Containers* folder within *~/Library/* and delete the folder *G69SCX94XU.duck*. +3. **Optional:** Delete all saved login credentials in *Keychain Access.app*. + +```` + +````{group-tab} Windows + +1. Close the application and open the start menu using the shortcut `Ctrl Esc`. Search for *Apps & Features* and move to the entry *Cyberduck*. Click on the application, choose *Uninstall*, and confirm your intentions by clicking *Uninstall* again. +2. Navigate to the `%AppData%`and delete the folder *Cyberduck* +3. Navigate to `%LocalAppData%`and delete the folder *Cyberduck* +4. **Optional:** Delete all saved login credentials in *Windows Credential Manager*. + +```` + +````` \ No newline at end of file