github.com/argoproj/argo-cd/v3@v3.2.1/docs/operator-manual/git_configuration.md (about)

     1  
     2  # Git Configuration
     3  
     4  ## System Configuration
     5  
     6  Argo CD uses the Git installation from its base image (Ubuntu), which
     7  includes a standard system configuration file located at
     8  `/etc/gitconfig`. This file is minimal, just defining filters
     9  necessary for Git LFS functionality.
    10  
    11  You can customize Git's system configuration by mounting a file from a
    12  ConfigMap or by creating a custom Argo CD image.
    13  
    14  ## Global Configuration
    15  
    16  Argo CD runs Git with the `HOME` environment variable set to
    17  `/dev/null`. As a result, global Git configuration is not supported.
    18  
    19  ## Built-in Configuration
    20  
    21  The `argocd-repo-server` adds specific configuration parameters to the
    22  Git environment to ensure proper Argo CD operation. These built-in
    23  settings override any conflicting values from the system Git
    24  configuration.
    25  
    26  Currently, the following built-in configuration options are set:
    27  
    28  - `maintenance.autoDetach=false`
    29  - `gc.autoDetach=false`
    30  
    31  These settings force Git's repository maintenance tasks to run in the
    32  foreground. This prevents Git from running detached background
    33  processes that could modify the repository and interfere with
    34  subsequent Git invocations from `argocd-repo-server`.
    35  
    36  You can disable these built-in settings by setting the
    37  `argocd-cmd-params-cm` value `reposerver.enable.builtin.git.config` to
    38  `"false"`. This allows you to experiment with background processing or
    39  if you are certain that concurrency issues will not occur in your
    40  environment.
    41  
    42  > [!NOTE]
    43  > Disabling this is not recommended and is not supported!