Docs/gitpassword/Installation and Updates (Windows)

Installation and Updates (Windows)

Install GitPassword on Windows, and understand basic methods for updating and uninstalling.

This document describes how to install, update, and uninstall GitPassword on Windows, and helps you understand the boundary between "program files" and "repository data".

System Requirements

Windows 10 or higher
Sufficient disk space (depending on the number of passwords/notes/files you save)
Access to your Git remote (if you configured a remote URL and want to sync)

Download

Please only obtain installation packages from official GitBraints channels (such as the official website Download page or the download area on the GitPassword product page) to avoid tampering risks from third-party distribution.

Installation (General Process)

Download the Windows installer package
Extract or follow the setup wizard to complete installation
Launch GitPassword

Upon first launch, the application will guide you through:

Repository Settings: Fill in the remote URL, local path (optional SSH username/SSH private key), and click "Continue".
Git Authentication: Enter your username and password (optional "Remember credentials"), then click "Login" or "Register".

For specific steps, please refer to:

Quick Start

Updates

When updating, we recommend following two principles:

Program and Repository Separation: Updates only replace GitPassword program files; do not overwrite or accidentally delete your repository directory.
Ensure Repository Recoverability Before Updating: If you use remote sync, we recommend performing a sync before updating to ensure you have a usable version in the remote.

General Update Steps:

Close GitPassword
Download the new version
Overwrite/replace program files (or uninstall the old version and install the new version)
Restart and confirm you can enter the "Passwords/Notes/Files" interface normally

Uninstall

Uninstalling GitPassword usually does not automatically delete your repository directory.

Before uninstalling, we recommend confirming:

You know the location of your repository directory (the folder pointed to by your "Local Path").
If you use remote sync, make sure recoverable data already exists in the remote repository.

Installation (General Process)

Download the Windows installer package

Extract or follow the setup wizard to complete installation

Launch GitPassword

Upon first launch, the application will guide you through:

Repository Settings: Fill in the remote URL, local path (optional SSH username/SSH private key), and click "Continue".

Git Authentication: Enter your username and password (optional "Remember credentials"), then click "Login" or "Register".

For specific steps, please refer to:

Updates

When updating, we recommend following two principles:

Program and Repository Separation: Updates only replace GitPassword program files; do not overwrite or accidentally delete your repository directory.

Ensure Repository Recoverability Before Updating: If you use remote sync, we recommend performing a sync before updating to ensure you have a usable version in the remote.

General Update Steps:

Close GitPassword

Download the new version

Overwrite/replace program files (or uninstall the old version and install the new version)

Restart and confirm you can enter the "Passwords/Notes/Files" interface normally

Uninstall

Uninstalling GitPassword usually does not automatically delete your repository directory.

Before uninstalling, we recommend confirming:

You know the location of your repository directory (the folder pointed to by your "Local Path").

If you use remote sync, make sure recoverable data already exists in the remote repository.