Desktop App Options


The Copia Desktop application has a number of additional settings that can be adjusted by users. The page will describe each of them, as well as provide recommendations for which settings to enable if applicable.

You can find your Desktop App Options by clicking File > Options. This should open a window like the one seen below. The Options are grouped by category on the left side.


There are two types of Copia accounts. The most common type is a standard Copia account that uses Copia to host your repositories. If your account falls into this category, you should use the Sign In button beneath If you are a customer using Copia in a Self-Hosted environment, you should use the Sign In button beneath Copia Enterprise.


The Copia Desktop app can sometimes need to interact with external 3rd-party applications, such as resolving merge conflicts in text files or executing Git commands in a command line interface.

External Editor

This options sets the default application to use when opening text files from the Copia Desktop App. We recommend that you set it to your preferred text editor, whether that be Notepad++, Visual Studio Code, or even just the standard Notepad application that ships with Windows.


This option sets the default shell application that Copia will open when required, such as when you need to run Git commands. You can use your preferred application for this option, but for the majority of Copia users we recommend that you set it to use Command Prompt.


This section of Options is related to how Copia manages Git on your local computer.


This section is for entering the username and password that you want associated with your Git history. While this doesn't technically need to match your Copia username and email, we strongly recommend that you match them.

Default branch for new repositories

Copia will use the value of this option when creating a new local repository. When creating new repositories from scratch in the Copia Web App, new repos will always be created with the default branch main.

Changing any of these settings will modify your global Git config file, which may impact new repos that are created with a different Git client.


The section allows you to modify the appearance of your Copia Desktop App. It allows you change the brightness, contrast, and preferring bold-text.


The Copia Desktop App gives prompts when users perform actions that may be irreversible or otherwise potentially dangerous. For new users to Copia and Git, we recommend that you enable all of these options as they can help prevent you from making mistakes.


This section includes options for advanced users and for those options that don't fall into the other categories.

If I have changes and I switch branches...

This setting dictates the behavior Copia should have when switching branches when you have uncommitted changes. The safest option for avoiding losing your work is "Ask me where I want the changes to go".

Background Updates

Enabling this feature periodically (every 15 minutes) performs a Fetch operation on all on your repositories. This can be useful in case you forget to Fetch before working in a repository. We recommend that you have this option enabled, but you should still get in the habit of fetching prior to working on your repository.

Enable Auto-Archive

This enables the Auto-Archive feature and is discussed in detail in this section.

Last updated