IDE Services 2024.4 Help

Configure settings and VM options

IDE Services allows you to configure IDE settings and Java Virtual Machine options in the Web UI, deliver them to developer machines, and apply using the JetBrains IDE Services plugin. The settings are fetched from the IDE Services Server, applied during the IDE start, and checked every hour afterwards.

Add VM options

  1. On the Profiles page, click the name of the profile you want to edit.

  2. In the Settings section, click the Plus icon and select VM Option.

  3. In the Configure Virtual Machine options dialog, use filters to configure what JetBrains applications will receive VM options.

    Specify VM Options

    Click Add filter and fill in the following details in the Add Filter dialog:

    Add filter
    • Type: select one of the filter types. Select the Include type if you want to configure plugins only for the applications specified in the filter. To configure plugins for all applications except for the ones specified, use the Exclude type.

    • IDE: select one or multiple names of the IDEs to use in your filter. Click the field to see the dropdown with available options.

    • Build: select one or multiple IDE build versions to use in the filter.

    • OS: if necessary, select the operating systems to use in the filter.

    • Architecture: if necessary, select the architectures to use in the filter.

    Click OK to save the filter.

  4. In the VM Option field, specify the VM options you want to set up. IDE Services will add these options to the .vmoptions file of the selected IDEs after you update the profile.

  5. Click Save.

Manage access to JetBrains Marketplace

By default, IDE Services Server acts as a proxy between IDEs and JetBrains Marketplace, meaning that the server handles and routes requests to JetBrains Marketplace. It is recommended to keep this functionality enabled, for example, when developer machines operate offline or have limited internet access.

In profiles, you can allow or deny access to JetBrains Marketplace:

  1. On the Profiles page, click the name of the profile you want to edit.

  2. In the Settings section, click the Plus icon and select Marketplace settings.

  3. In the Configure Marketplace Settings dialog, change the value of the Access to JetBrains Marketplace option as required.

    Access to JetBrains Marketplace is allowed

    Click Save.

Add IDE settings

IDE Services enables you to select the necessary settings from the list of predefined templates, modify them to fit your specific use cases, and distribute them to developers' IDEs.

You can customize any predefined setting to meet your company-specific requirements or use one of the blank templates to configure an IDE setting from scratch.

Add settings via templates

  1. On the Profiles page, click the name of the profile you want to edit.

  2. In the Settings section, click the Plus icon and select IDE Setting.

  3. In the Add IDE settings dialog, use filters to configure what IDEs will receive settings from the IDE Services Server.

    Click Add filter and fill in the following details in the Add Filter dialog:

    Add filter
    • Type: select one of the filter types. Select the Include type if you want to apply settings only to the applications specified in the filter. If you want to apply settings to all applications except for the ones specified, use the Exclude type.

    • IDE: select one or multiple names of the IDEs to use in your filter. Click the field to see the dropdown with available options.

    • Build: select one or multiple IDE build versions to use in the filter.

    • OS: if necessary, select the operating systems to use in the filter.

    • Architecture: if necessary, select the architectures to use in the filter.

    Click OK to save the filter.

  4. Click Add setting and select the template you want to use from the list of predefined options.

    Add a setting from a template

    IDE Services will automatically fill in the setting details.

  5. Click Save to submit the changes.

Fine-tune IDE settings

  1. Add a new setting from the list of predefined templates, as described in Add settings via templates.

  2. Click Configure below the setting name.

    Configure a setting
  3. Provide setting details by filling in the fields in the Configure dialog or editing a JSON.

    The Confiugure dialog
  4. (Optional) Click Open JSON editor to configure the setting in the JSON format.

  5. Once you've configured the setting, click Back. Then, click Save to submit the changes.

Postpone IDE restart

IDE settings, VM options, and auto-installed plugins require restarting the IDE to take effect. If a setting is configured as "forced," the user is prompted to restart their IDE as soon as the delivered setting or plugin update is detected. At that point, the IDE will pause until the developer chooses to either restart immediately or delay if they wish to finish and save their current work. By default, the prompt will reappear every 5 minutes until the restart option is selected.

IDE Restart Prompt

You can adjust the prompt's timeout period to better suit the developers' workflow by adding a custom IDE setting to the relevant profiles.

Adjust restart prompt timeout

  1. On the Profiles page, click the name of the profile you want to edit.

  2. In the Settings section, click the Plus icon and select IDE Setting.

  3. In the Add IDE settings dialog, use filters to configure what IDEs will receive settings from the IDE Services Server.

    Click Add filter and fill in the following details in the Add Filter dialog:

    Add filter
    • Type: select one of the filter types. Select the Include type if you want to apply settings only to the applications specified in the filter. If you want to apply settings to all applications except for the ones specified, use the Exclude type.

    • IDE: select one or multiple names of the IDEs to use in your filter. Click the field to see the dropdown with available options.

    • Build: select one or multiple IDE build versions to use in the filter.

    • OS: if necessary, select the operating systems to use in the filter.

    • Architecture: if necessary, select the architectures to use in the filter.

    Click OK to save the filter.

  4. Click Add setting and select Blank setting of type "properties component".

    Add A Properties Component Setting Type
  5. Click Configure.

  6. Enter the following parameters:

    Configure IDE Restart Setting

    Parameter

    Value

    Description

    Blank setting of type "properties component"

    Value

    Specify desired timeout in minutes. The default is 5. For no delay option, forcing users to restart immediately, enter 0.

    Key

    jetbrains.tbe.postpone.restart.minutes

    Scope

    Application

    Forced

    Check

    Alternatively, click Open JSON editor and copy the following settings in the JSON format. Replace the default "value": "5" with your own:

    { "key": "jetbrains.tbe.postpone.restart.minutes", "value": "5", "kind": "PROPERTIES_COMPONENT", "description": "IDE restart postpone interval in minutes", "scope": "APPLICATION", "forced": true }
  7. Once you've configured the setting, click Back. Then, click Save to submit the changes.

Reference: Configure Dialog

Description

Provide a short description for the setting. This text will be used to distinguish a particular setting in the Web UI.

Forced

Select this option if you want to prohibit changing the value of the setting in the IDE.

If selected, IDE Services will overwrite any local changes in the setting value every seven minutes.

If not selected, the setting value from the IDE Services Server will be propagated to IDEs once. IDE Services will not overwrite consecutive local changes introduced via the IDE settings or Version Control.

Scope

Select one of the options that will define the level for applying the setting: project or application (global).

Key

Specify the key of the key-value pair.

Available for: Properties component, Registry

Value

Specify the value of the key-value pair.

Available for: Properties component, Registry

Fully qualified name

Provide a fully qualified name of the setting. For example, com.intellij.openapi.wm.impl.status.widget.StatusBarWidgetSettings.

Available for: Persistent state

Plugin ID

If a setting comes as part of a particular plugin, provide its identifier. For example, org.intellij.scala.

Available for: Persistent state

Last modified: 06 November 2024