# Perforce

> **TL;DR**
> `File | Settings | Version Control | Perforce` for Windows and Linux
>
>
>
> `CLion | Settings | Version Control | Perforce` for macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ![the Settings icon](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.settings.svg)

Use this page to specify the version control settings to be applied to those directories of your project that are under Perforce control

| Item | Description |
| --- | --- |
| Perforce is online | Select this checkbox to work with Perforce in the online mode. |
| Switch to offline mode automatically if Perforce is unavailable |  Select this checkbox to have CLion automatically [go offline](perforce-working-offline.html) as soon as Perforce becomes unavailable and display the corresponding message.  |
| Use P4CONFIG or default connection | If this option is selected, `P4CONFIG` or the default Perforce connection is used to connect to the Perforce server.                        Using `P4CONFIG` makes it trivial to switch between Perforce settings for different projects, when necessary.                 |
| Use connection parameters | If this option is selected, the connection credentials (port, client, user name, and charset) are specified manually. |
| Port | In this field, type the server and the port which your Perforce client will listen to. For the default Perforce server configuration, it looks like perforce:1666.  |
| Client | In this field, type the name of your Perforce workspace name. |
| User | In this field, type your user name to authenticate to the server. |
|  Charset  |  From this drop-down list, select the character set to be used.  |
| Dump Perforce commands to <path> | Select this checkbox to have CLion create a file `P4.output` and store the output of Perforce commands in it. |
| Use login authentication | When this checkbox is selected, Perforce requires a login to authenticate a user. |
| Test Connection | Click this button to check whether the specified settings ensure establishing connection to the Perforce server. |
| Path to P4 executable |  In this field, specify the path to the Perforce Command Line Client's executable file `P4`. Click Browse ![the Browse button](https://resources.jetbrains.com/help/img/idea/2026.2/app.general.ellipsis.svg) to open the Select Path - P4 Configuration dialog and select the executable file in the directories tree.  |
| Path to P4V executable |  In this field, specify the path to the Perforce Visual Client's executable file `P4V`. Click Browse ![the Browse button](https://resources.jetbrains.com/help/img/idea/2026.2/app.general.ellipsis.svg) to open the Select Path - P4 Configuration dialog and select the executable file in the directories tree.  |
| Show branching history ... | Select this checkbox to enable displaying the branch history of a specified file, including all file branch points, edits, and merges. |
| Show integrated changelists in committed changes |  Select this checkbox to have CLion point at committed changes that are also integrated to other changelists and provide information on the target changelists that received the content in question.  |
| Server timeout | In this field, specify the time period in seconds after when the Perforce client cancels its attempts to establish connection to the server. |
| Enable Perforce Jobs Support | When this checkbox is selected, user interface for attaching and detaching Perforce jobs to change lists is provided in the   Version Control tool window  `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS))  and in the Commit Changes dialog. |
| Find ignored files using P4 executable |    |
| Always sync local changelists with Perforce |  This setting automatically synchronizes changelists between CLion and Perforce. When enabled, [creating a new changelist](managing-changelists.html) also creates a corresponding Perforce changelist, and any local changelists without a Perforce match are deleted. Disable this setting for manual synchronization control.  |

## See also

### Procedures

[Perforce](using-perforce-integration.html)

### Reference

[Version Control window](version-control-tool-window.html)