Skip to content

Commit

Permalink
Review sample Web URL configuration.
Browse files Browse the repository at this point in the history
  • Loading branch information
@dkocher
dkocher committed Nov 5, 2024
1 parent ca79628 commit 54a04f7
Showing 1 changed file with 22 additions and 23 deletions.
45 changes: 22 additions & 23 deletions cyberduck/bookmarks.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -104,20 +104,21 @@ Select *Bookmark → Edit Bookmark (macOS `⌘E` Windows `Strg+E`)*. A panel whe

### Bookmark Options

| Setting | Description |
| :--- | :--- |
| Protocol | Your hosting service provider will let you know what protocol to use. Change the [protocol](connection.md#supported-protocols) in the<br/>topmost popup menu. |
| Nickname | Any name for the bookmark describing it for easy access using the bookmark filter. You can<br/>also type this name in the bookmark view to select it by name. |
| Server | The hostname of the server. This is not editable if you have chosen a protocol with a predefined,<br/>non-configurable hostname. *Make sure no server path is included but only the domain name and instead set any server path in _Path_.* |
| Username | The login credentials from your service provider. |
| SSH Private<br/>Key | For [SFTP](../protocols/sftp/index.md) connections only. Choose a private key for public key authentication instead of a<br/>password. If the key is password-protected, you are prompted to enter the passphrase to<br/>decrypt the key. |
| Client<br/>Certificate | For [HTTPS](../protocols/webdav/index.md#mutual-tls-mtls) connections only. Choose a client certificate for mutual transport level security (TLS). |
| Path | The initial working directory when connecting to the server. This must be the document root of<br/>the webserver if you want to configure HTTP URLs ([see below](#http-url)) to work. |
| Download<br/>Folder | Default location for files downloaded from this server. |
| Transfer<br/>Files | Choose to open a new connection for transfers in the [transfers](transfer.md#connections) window or to use the existing<br/>browser connection. When using the browser connection, transfers block other operations. |
| Connect<br/>Mode | For [FTP](../protocols/ftp.md) connections only. Refer to [FTP Connect Mode](../protocols/ftp.md#ftp-connect-mode). |
| Encoding | For [FTP](../protocols/ftp.md) connections only. Character encoding of filenames on the server. You can also change<br/>the encoding used when the connection is open using *View → Text Encoding* if characters<br/>are not displayed properly. Try `UTF-8` (the default), `ISO-8859-1`, and `Windows-1252`.<br/>Refer to [Character Encoding](../protocols/ftp.md#character-encoding). |
| Timezone | For all protocols except [FTP](../protocols/ftp.md), timestamps are reported in [UTC](http://en.wikipedia.org/wiki/Coordinated_Universal_Time) from the server and there is no<br/>need for configuration. All timestamps in the browser are automatically converted to the timezone<br/>you have configured in the *System Preferences* and displayed in local time. For [FTP](../protocols/ftp.md)<br/>however, the local timezone is assumed for timestamps in directory listings If the server<br/>is configured with a different timezone that your Mac and returning the local time for<br/>modification dates, there will be an offset by the timezone difference. To get the correct local<br/>time for modification dates in the browser, you can choose the timezone of the server in the<br/>bookmark settings. Select *Bookmark → Edit Bookmark*. |
| Setting | Description |
|:-----------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Protocol | Your hosting service provider will let you know what protocol to use. Change the [protocol](connection.md#supported-protocols) in the<br/>topmost popup menu. |
| Nickname | Any name for the bookmark describing it for easy access using the bookmark filter. You can<br/>also type this name in the bookmark view to select it by name. |
| Server | The hostname of the server. This is not editable if you have chosen a protocol with a predefined,<br/>non-configurable hostname. *Make sure no server path is included but only the domain name and instead set any server path in _Path_.* |
| Username | The login credentials from your service provider. |
| SSH Private<br/>Key | For [SFTP](../protocols/sftp/index.md) connections only. Choose a private key for public key authentication instead of a<br/>password. If the key is password-protected, you are prompted to enter the passphrase to<br/>decrypt the key. |
| Client<br/>Certificate | For [HTTPS](../protocols/webdav/index.md#mutual-tls-mtls) connections only. Choose a client certificate for mutual transport level security (TLS). |
| Path | The initial working directory when connecting to the server. This must be the document root of<br/>the webserver if you want to configure HTTP URLs ([see below](#web-url)) to work. |
| Web URL | HTTP server address |
| Download<br/>Folder | Default location for files downloaded from this server. |
| Transfer<br/>Files | Choose to open a new connection for transfers in the [transfers](transfer.md#connections) window or to use the existing<br/>browser connection. When using the browser connection, transfers block other operations. |
| Connect<br/>Mode | For [FTP](../protocols/ftp.md) connections only. Refer to [FTP Connect Mode](../protocols/ftp.md#ftp-connect-mode). |
| Encoding | For [FTP](../protocols/ftp.md) connections only. Character encoding of filenames on the server. You can also change<br/>the encoding used when the connection is open using *View → Text Encoding* if characters<br/>are not displayed properly. Try `UTF-8` (the default), `ISO-8859-1`, and `Windows-1252`.<br/>Refer to [Character Encoding](../protocols/ftp.md#character-encoding). |
| Timezone | For all protocols except [FTP](../protocols/ftp.md), timestamps are reported in [UTC](http://en.wikipedia.org/wiki/Coordinated_Universal_Time) from the server and there is no<br/>need for configuration. All timestamps in the browser are automatically converted to the timezone<br/>you have configured in the *System Preferences* and displayed in local time. For [FTP](../protocols/ftp.md)<br/>however, the local timezone is assumed for timestamps in directory listings If the server<br/>is configured with a different timezone that your Mac and returning the local time for<br/>modification dates, there will be an offset by the timezone difference. To get the correct local<br/>time for modification dates in the browser, you can choose the timezone of the server in the<br/>bookmark settings. Select *Bookmark → Edit Bookmark*. |

### Passwords

Expand All @@ -134,28 +135,26 @@ Passwords are saved in the *Credential Manager*. You can view and delete your sa
:::
::::

## HTTP URL
## Web URL

With a valid configuration, you can open the corresponding HTTP URL of a file selected with your default web browser or copy the URL to the clipboard. You can select multiple files in the browser for a list of URLs.

Enter the HTTP URL of the web server using a different hostname than what you connect to using FTP. You also have to specify a reasonable default path in your bookmark (e.g. `/home/dkocher/public_html/`). That must be the directory accessed by the web server as your document root. Using an Apache web server this is equivalent to the `DocumentRoot` directive.

Example configuration:

| Server | sudo.ch | *Hostname configured in bookmark to<br/>connect to* |
| :--- | --- | ---: |
| Bookmark<br/>Path | `/usr/home/dkocher/public_html/` | *The Web Server Document Root* |
| Selected File | `/home/dkocher/public_html/stylsheet.css` | *A file selected in the browser* |
| HTTP URL | [http://sudo.ch/stylesheet.css](http://sudo.ch/stylesheet.css) | *Accessible in the web browser* |
| Server | example.net | *Hostname configured in bookmark to<br/>connect to* |
|:------------------|------------------------------------------------------------------------|----------------------------------------------------:|
| Bookmark<br/>Path | `/home/user/public_html/` | *The Web Server Document Root* |
| Selected File | `/home/user/public_html/stylsheet.css` | *A file selected in the browser* |
| HTTP URL | [http://example.net/stylesheet.css](http://example.net/stylesheet.css) | *Accessible in the web browser* |

:::{image} _images/HTTP_URL.png
:alt: HTTP URL
:width: 600px
:::

Web URLs are supported for [FTP](../protocols/ftp.md), [SFTP](../protocols/sftp/index.md) and [WebDAV](../protocols/webdav/index.md).

See also [Open or copy HTTP URL](browser.md#open-or-copy-http-url).
Web URLs are supported for [FTP](../protocols/ftp.md), [SFTP](../protocols/sftp/index.md) and [WebDAV](../protocols/webdav/index.md). See also [Open or copy HTTP URL](browser.md#open-or-copy-http-url).

## Exporting Bookmarks

Expand Down

0 comments on commit 54a04f7

Please sign in to comment.