diff --git a/assets/images/getting-started/install-git/win-components.png b/assets/images/getting-started/install-git/win-components.png new file mode 100644 index 0000000..b5b3798 Binary files /dev/null and b/assets/images/getting-started/install-git/win-components.png differ diff --git a/assets/images/getting-started/install-git/win-components.webp b/assets/images/getting-started/install-git/win-components.webp new file mode 100644 index 0000000..e823d08 Binary files /dev/null and b/assets/images/getting-started/install-git/win-components.webp differ diff --git a/assets/images/getting-started/install-git/win-cred-helper.png b/assets/images/getting-started/install-git/win-cred-helper.png new file mode 100644 index 0000000..eb1e76f Binary files /dev/null and b/assets/images/getting-started/install-git/win-cred-helper.png differ diff --git a/assets/images/getting-started/install-git/win-cred-helper.webp b/assets/images/getting-started/install-git/win-cred-helper.webp new file mode 100644 index 0000000..57f05dd Binary files /dev/null and b/assets/images/getting-started/install-git/win-cred-helper.webp differ diff --git a/content/getting-started/install-git.md b/content/getting-started/install-git.md index b25a1af..e8e35e4 100644 --- a/content/getting-started/install-git.md +++ b/content/getting-started/install-git.md @@ -53,10 +53,18 @@ To install with administrator rights, either log in as administrator, or run the -From there, follow the steps in the setup wizard. It is okay to just accept the defaults, when in doubt. -There are two steps for which you have to pay attention: +From there, follow the steps in the setup wizard. It is okay to just accept the defaults when in doubt. +There are some steps for which you might have to pay attention: -1. Choose your editor: +1. Select Components: +This is where you can choose whether you want a desktop icon or not, and whether you want Git to automatically check for updates daily. + + + + win-components + + +2. Choose your editor: By default, [Vim](https://www.vim.org/) will be used for Git. But if you prefer to use another one, select it here. @@ -64,14 +72,22 @@ By default, [Vim](https://www.vim.org/) will be used for Git. But if you prefer win-editor -2. PATH environment: +3. PATH environment: +This makes sure that Git can be used by 3rd party software ([Git clients](#git-clients)). It is recommended (and the default anyway). win-path -This makes sure that Git can be used by 3rd party software (Git clients). It is recommended (and the default) anyway. +4. Choose credential helper: +By default, the `Git Credential Manager` will be used. However, this manager is no longer maintained and has been replaced by the `Git Credential Manager Core` (third option). When using either of these credential managers, your Git/Codeberg credentials will be stored in Windows' [Credential Manager](https://support.microsoft.com/en-us/help/4026814/windows-accessing-credential-manager) when you enter them for your first pull/push (see [Clone & Commit via HTTP](/git/clone-commit-via-http)). Windows' Credential Manager is also where you have to go in order to change them. Follow the links on the installation wizard for more details. +If you prefer not to store your credentials in Windows but e.g. in a password manager, select the first option (`None`). You will have to enter your credentials at every push/pull. + + + + win-cred-helper + > You may get the error message displayed below, that the release notes cannot be displayed. That error message can be safely ignored. You can find the release notes in `Start Menu > Git > Git Release Notes`. > @@ -80,18 +96,17 @@ This makes sure that Git can be used by 3rd party software (Git clients). It is > win-error > - ### Run -Git can be used through the `Command Prompt` (the traditional Windows command line interpreter), the `Windows Powershell` (the "replacement" of the `Command Prompt`), the interface of your Git client, or `Git Bash`. The latter two options are recommended. +Git can be used through the `Command Prompt` (the traditional Windows command line interpreter), the `Windows Powershell` (the "replacement" of the `Command Prompt`), the interface of your [Git client](#git-clients), or `Git Bash`. The latter two options are recommended. `Git Bash` is what comes with your Git installation. You can access it from the Start Menu: `Git > Git Bash`. ### Configure You now managed to get Git up and running. Please proceed as described in the article [Configuring Git](/git/configuring-git) to set up your name and email address for Git. -Note that the first time you push/pull (see [Clone & Commit via HTTP](/git/clone-commit-via-http)), Git will ask for your Codeberg credentials. If you did not change this setting during installation, these credentials will be saved by Windows in its [Credential Manager](https://support.microsoft.com/en-us/help/4026814/windows-accessing-credential-manager). This is also where you have to go in order to change them. - ### Update +If you ticked the box to check for updates during installation, Git will inform you that a new version is available. + To update Git, the easiest way is to download and run the latest version of the installer and follow the previous steps. Make sure that you run the new installer with the same rights (administrator or user) as for the original installation. If not, it will be installed twice and that will create a mess. If you want to keep all your settings, simply tick the box `Only show new options` in the installation wizard (see screenshots above). Here, "new options" refer to the options that were not available in the previous version.