Certain configuration of SmartGit has to be done by VM options, in files called
smartgit.vmoptions. Usually you will want to specify VM options just for your account (current user):
%APPDATA%is the path defined in the environment variable
Alternatively (but not recommended), VM options can also be specified system-wide in following files:
- Windows: the global file is
bin\smartgit.vmoptionsin SmartGit's installation directory
- Linux: the global file is
bin/smartgit.vmoptionsin SmartGit's installation directory
- Mac: the global file is
Contents/MacOS/smartgit.vmoptionsin SmartGit's installation directory
smartgit.vmoptions file contains a list of additional VM options which should be passed to the Java VM. VM options are basically arguments to Java and every argument must be declared on a separate line.
Location of the Settings Directory
The settings contains SmartGit's settings. See Installation and Files for information about the default location and contents of the settings directory. On Windows and Linux, you can change its location by modifying the VM option
Changing the settings directory's location is not supported on Mac OS X.
Within the value of
smartgit.settings, certain Java system properties are allowed, such as
user.home. Another accepted value is the special
smartgit.installation property, which refers to the SmartGit installation directory.
Location of the Updates Directory
The Updates directory contains downloaded program updates. See Installation and Files for information about the default location and contents of the Updates directory. On Windows and Linux, you can change its location by modifying the VM option
Used Java Runtime Environment
You can check Help|About, page Information to see which Java Version SmartGit is using. Depending on the operating system, you can change the Java VM as follows:
Use the Windows environment variable
SMARTGIT_JAVA_HOME to tell SmartGit which JRE to use.
You have to specify a 64-Bit JRE (starting with SmartGit 18.1). When running
bin/smartgit32.exe, you have to specify a 32-Bit JRE.
On Linux, you can configure the JRE to be used by adding
The memory limit (also known as maximum heap size) specifies how much RAM the SmartGit process is allowed to use. The memory limit can be configured by the VM option
If the set value is too low, SmartGit may run out of memory during memory-intensive operations.
32-Bit Java VMs only allow to configure a maximum memory limit of roughly
1200M. For almost all setups and repository sizes, this should be sufficient. If you nevertheless need to configure a higher limit, you will have to use a 64-bit VM and on Windows invoke
On Linux and Mac OS X, you can extend the PATH used by SmartGit (and all processes invoked by SmartGit, especially Git itself) by adding
path= lines can be used multiple times and will be appended to the PATH in the order of occurrence.
Do not specify the file path, but its parent directory's path - as for all usual path modifications!