Profiles

On the Profiles tab, you can configure the main connection settings resp. profiles. The table shows all currently known profiles. You can Add, Copy, Edit or Delete a profile. To change the order of the profiles, use Move Up and Move Down. The order of the profiles 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.

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 Access Method (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 Access Method. 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 Access Method, there a different options which have to be configured on the Details page. Most of them are related to authentication.

For SVN connections, you have to specify the SVN Login. This can either be Anonymous or by User Name/Password. In the latter case you have to supply the User Name and Password. The Password can optionally be stored on disk by Store password on disk, but note that passwords are NOT SAFE.

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

For HTTPS connections, you have to specify the same parameters as for HTTP connections. Furthermore you have the option to Enable Client Authentication if this is required by your SSL server. In this case choose the required Client Certificate File and enter the corresponding Client Certificate Passphrase which is used to protect your certificate. You can optionally Store passphrase on disk, but note that passwords are NOT SAFE.

For SVN+SSH connections, you have to specify a Login Name for the SSH login. You have the option to either authenticate by Password-Authentication or by Public/Private-Key-Authentication. In case of Password-Authentication, enter the corresponding password. You can optionally Store password on disk, but note that passwords are NOT SAFE. In case of Public/Private-Key-Authentication, enter the path to your Private Key File and the Passphrase, which is used to protect your Private Key. You can optionally Store passphrase on disk, but note that passwords are NOT SAFE!

Note

All passwords are stored in the passwords.xml file, which can be found in SmartSVN's home directory, which is by default the .smartsvn within your home directory. Passwords are encrypted in a simple way which is NOT SAFE! Therefore don't store valuable passwords on a machine, where other users can access passwords.xml file.

Finally and common for all Access Methods 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 repository profile. Choose either Use Repository URL As Profile Name or Use This Profile Name and enter a corresponding name.

Click Finish to create the profile.