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
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
Use the Windows environment variable
SMARTGIT_JAVA_HOME to tell SmartGit which JRE to use. In case of using a 64-Bit JRE, you will have run to SmartGit using
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.