Connecting to an HTTP Server

  1. Select File > Add Repository… (or click the button located at the bottom of the source list and select Add Repository…)
  2. Select the HTTP Server button at the top of the displayed sheet:

    HTTP Server

  3. Select the protocol to use (http:// or https://).
  4. Use the Server field to enter the name or IP address of the HTTP server. Do not include the scheme (i.e. http://) in this field.
  5. If your server is listening on a non-standard port (80 for http:// and 443 for https://) then enter the port number into the Port field. Leave this field blank if your server is using the standard port.
  6. Enter the relative path of the repository into the Repository Path field. You may also specify the path to a folder in the repository.
  7. For example, for the URL:
    enter into the Server field, 8888 into the Port field and repos/project/trunk into the Repository Path field.
    The path entered into the Repository Path field should not be URL-encoded.
  8. Use the Nickname field to specify the name used to represent the repository in the source list.
  9. Specify the account name and password you use to access the repository. You can leave the Name field blank if you only require anonymous access.
    The value entered into the Name field should not be URL-encoded.
  10. Click the Add button to connect to the repository.

Cornerstone will attempt to contact the server and query information about the repository. The server must be reachable to successfully add a repository.

The sheet will autofill if the pasteboard contains an http:// or https:// URL when the sheet is opened. You can click the Reset button to clear the autofilled contents if required.

Your account information is stored in your login keychain.

Security Considerations

The HTTP protocol—the same protocol used to access web servers on the Internet—provides no security when accessing a Subversion repository. Traffic sent to and from the server is transmitted in the clear and can be inspected (and potentially modified) by a third party.

Many Subversion repositories on the Web offer both secure (HTTPS) and non-secure access (HTTP). HTTPS is slightly slower than HTTP but is nonetheless recommended when connecting to a repository over a public network such as the Internet.