Profiles

On the Profiles page, you can configure the main connection settings (i.e. profiles). The table shows all currently known profiles. You can Add, Copy, Edit or Delete a profile.

The profiles are arranged in a specific, customizable order. This order is used for profile selectors, used within various dialogs. It also affects the search for a matching profile, when connecting to a repository; the list is searched from top to bottom. In this way you can create multiple profiles for one repository with different settings, e.g. authenticated access for certain subdirectories and anonymous access for the whole repository. To change the order of the profiles, use Move Up and Move Down. Use Sort By to sort the profiles either based on their given Name or on their Location (host name); latter option will keep the order between profiles for the same host.

Use Show Passwords to add an additional Password/Passphrase column which displays the stored plain text passwords for each profile. For details on passwords refer to .

Tip

The column Last Used At shows the last time the Profile has been used for authentication against a repository. This time stamp can be helpful to detect obsolete profiles which may be removed after a while.

Add

By Add a wizard will come up, which lets you supply all necessary information to create a new profile.

Configuration

On the Location page you have to primarily specify which Protocol (protocol) shall be used to access the repository. In case of SVN+SSH, you can optionally specify whether to Prepend SSH login name to host. This option is not important for SmartSVN but may be convenient when also working with the command line.

Further mandatory parameters of a profile are Server Name, Repository Path and Server Port. For the Server Port you have the option to use the Default port, or use a Non-Default port.

Note

The Repository Path is interpreted differently depending on the Protocol. For HTTP, HTTPS it denotes the Location as specified in Apache's httpd.conf (or child configuration files). For SVN it denotes the path relative to the repository root, which svnserve serves; you will typically simply use '/' here. For SVN+SSH it denotes the absolute file system path to the repository, i.e. the same path which you would supply for the svnserve -r parameter.

Instead of typing the values into the various input fields, you can also use Enter SVN URL and supply the complete URL for the repository.

Details

Depending on the selected Protocol, there are different options which have to be configured on the Details page. Most of them are related to authentication.

SVN

For SVN connections, you have to specify the SVN Login. This can either be Anonymous or by User Name and Password. In the latter case you have to supply the User Name and Password. The Password can optionally be stored by Save password, see also Passwords.

If you are connecting to a local repository, i.e. either localhost or 127.0.0.1, you can choose to Automatically start 'svnserve'. In this case, specify the local Repository Directory and the path to the 'svnserve'-Executable. SmartSVN will then always try to start the corresponding svnserve process at the specified port before accessing this repository.

Note

For the autostarting of svnserve to work properly, it's necessary that anonymous read access for the corresponding repository has been configured. Before the process is started, SmartSVN checks for already running processes. Only if no running processing (serving the correct repository) has been found, SmartSVN will launch its own svnserve process. These processes will be shutdown automatically with the shutdown of SmartSVN itself. If SmartSVN is not shutdown gracefully, the svnserve processes will remain running and hence have to be shutdown manually.

HTTP

For HTTP connections, you have also to specify the SVN Login and you can optionally choose Use Proxy to connect via the specified proxy server (see Proxies for more details).

HTTPS

For HTTPS connections, you have to specify the same parameters as for HTTP connections. Furthermore you have the option to Use client authentication if this is required by your SSL server. In this case choose the required Certificate File and enter the corresponding Certificate Passphrase which is used to protect your certificate. You can optionally Save passphrase, see also Passwords.

SVN+SSH

For SVN+SSH connections, you have to specify a Login Name for the SSH login and you have following Authentication options:

When working over SVN+SSH, the username used for commit messages, etc. will default to the Login Name. If you prefer to use another name here, choose Custom for SVN User Name and enter the corresponding name.

Finally and common for all Protocols you can choose to Verify connection when pressing 'Next', which is recommended.

Name

The Name page shows the final URL for the profile to be created.

For displaying on the UI, a name is assigned to every profile. Choose either Use repository URL as profile name or Use following profile name and enter a corresponding name.

Click Finish to create the profile.

Edit

When editing a profile, you can change almost all parameters which also can be entered when creating a new profile.