Client configuration files

Refer to the list of configuration files that you can use to configure your client.

Find or create the following configuration files in the following specified locations:

  • In the plastic4 directory:
    • Under $HOME/.plastic on Linux or macOS systems.
    • Under C:\Users\user\AppData\Local\plastic4 on Windows systems.
  • In the root directory of your workspace.
  • In the client installation directory.
  • In the plastic-global-config repository so all clients have the same settings.

Note: The locations are listed in order of lowest to highest precedence. For example, a rule in the client installation directory overrules a rule in the plastic4 directory.

Configuration fileDescriptionLocations
  • branchexplorer.cfg (Windows)
  • branchexplorer.conf (Linux and macOS)
Store the configuration information for the branch explorer. Refer to Create a branchexplorer.conf global configuration file.
  • plastic4 directory
  • plastic-global-config repository
client.confStore client configuration settings, such as the default server, user credentials, and merge and diff tools.
  • plastic4 directory
cloaked.confStore the paths of the controlled files you want to cloak. Refer to how to use filter pattern files.
  • Root directory of the workspace
  • plastic-global-configrepository
compression.confUse patterns to select the compression type that UVCS uses. Refer to how to use filter value pattern files.
  • plastic4 directory
  • Root directory of the workspace
customextensions.confStore custom extensions, such as your own issue tracker integration extensions.
  • Client installation directory
eolconversion.confDefine the EOL conversion based on the file extension. Refer to how to configure the EOL conversion.
  • plastic4 directory
externaldata.confStore the external locations (paths) of stored revisions when you archive a revision.
  • Client installation directory.
  • plastic4 directory
externaltools.confDefine external applications and how to receive selected object properties. Refer to how to configure the external tools.
  • Client installation directory
  • plastic4 directory
  • plastic-global-config repository
filetypes.confDefine if UVCS considers a file as a binary file or text file. For example, so that UVCS uses the correct diff or merge tool. Refer to how to use filter value pattern files.
  • plastic4 directory
  • Root directory of the workspace
  • plastic-global-config repository
gitsync.confAdd information that UVCS uses for GitSync operations. Refer to the GitSync guide.
  • Client installation directory
  • plastic4 directory
guiclient.confStore the UVCS GUI settings, such as pending changes, annotate, and merge configurations.
  • plastic4 directory
hidden_changes.confStore the paths of controlled files that you want to hide from your list of pending changes. Refer to how to use filter pattern files.
  • plastic4 directory
  • Root directory of the workspace
  • plastic-global-config repository
ignore.confStore the path of private files that you want to hide from your list of pending changes. Refer to how to use filter pattern files.
  • Root directory of the workspace
  • plastic-global-config repository
languages.confCustomize the language extensions you use to syntax highlight code when you compare files or revisions in the diff tool. Refer to how to configure syntax language.
  • Root directory of the workspace
  • plastic-global-config repository
openwith.confStore the Open with context menu applications and shortcuts. Refer to how to customize the tools to display in the Open with menu.
  • plastic4 directory
readonly.confStore the paths of controlled items that you want to retain the readonly status after an update. Refer to how to use filter pattern files.
  • plastic4 directory
  • plastic-global-config repository
serveralias.confStore a pair of connections that are aliases of each other so you can reach the same server by different IP addresses and protocols. Refer to how to support alternative connections to a server.
  • Client installation directory
  • plastic-global-config repository
writable.confStore the paths of controlled items that you want to retain the writable status after an update. Refer to how to use filter pattern files.
  • plastic4 directory
  • plastic-global-config repository