CLion 2017.2 Help

Synchronizing and Sharing Settings

On this page:

Synchronizing settings

Prerequisite

Before you start working with Settings Repository, make sure that the Settings Repository plugin is installed and enabled, as described in Installing, Updating and Uninstalling Plugins.

Basics

CLion makes it possible to synchronize settings across several different CLion installations, or auto-configure new installations, using settings from the server.

Once logged in, the settings are synchronized with the server based on "updated" timestamp stored in each settings group. The most recent ones are used and are either sent to server or applied locally from the server.

CLion always works with settings stored locally. So, the local settings are used, if, at some moment, the server is not available. On the following connection all updated settings will be pushed to the server.

When logged in to the server, once some settings are updated locally inside CLion, they are subsequently sent to the server. But local settings are only updated on CLion startup.

The server stores only one set of settings for each user.

What is synched?

Settings Repository stores almost all of the IDE and project settings, except for some platform-specific ones, and those containing local paths. This includes code style settings, keymaps, fonts and colors scheme, inspection profiles, and others.

Connecting to Settings Repository

You can connect to the Settings Repository in various ways:

To connect to the Settings Repository during a session

  1. At any time during a session, click the IntelliJ Configuration Server Status button (ijConfigServerSGreenwhen connected to the server, or ijConfigServerSButton, when disconnected) on the Status bar.
  2. In the dialog box that opens, click the Login button.
  3. Specify the login and password of your JetBrains Account or create a JetBrains Account if you do not have it.

    To connect to the IntelliJ Configuration Server through a Proxy server, select the Use HTTP Proxy check box and specify the Proxy server parameters in the dialog box controls. See a detailed description of controls in the Login to IntelliJ Configuration Server dialog box reference.

Configuring login to Settings Repository

To configure login to the Server during the next CLion startup

  1. Click the IntelliJ Configuration Server Status button ijConfigServerSGreen/ijConfigServerSButton on the Status bar.
  2. In the dialog box that opens, specify whether you want to log in to the IntelliJ Configuration Server during the next startup and how you want to do it. The following options are available:
    • Show login dialog box
    • Login silently
    • Do not login

    Select the desired option and click OK.

Sharing settings

For sharing project settings, .idea project configuration directory should be shared via version control.

If you decide to share CLion project files with the other developers, follow these guidelines.

Directory based project format (.idea directory) is used by all the CLion versions by default. Here is what you need to share:

  • All the files under .idea directory in the project root, except the workspace.xml and tasks.xml files, which store user-specific settings.

Be careful about sharing the following:

  • dataSources.ids, datasources.xml (can contain database passwords)

You may consider not to share the following:

  • user dictionaries folder (to avoid conflicts if another developer has the same name).
Last modified: 15 December 2017

See Also