### Example Setup Commands for GitKraken Agents

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/agents.md

Use setup commands to prepare a repository for a coding agent session. Each command should be on its own line and will run sequentially before the agent launches.

```shell
npm install
pnpm install
pnpm build
```

--------------------------------

### Start Docker Service

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Starts the Docker service on a Linux host. Ensure Docker is installed before running this command.

```bash
sudo systemctl start docker
```

--------------------------------

### Example Git and Git LFS Version Output

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/llms-full.txt

This is an example of the expected output when verifying Git and Git LFS installations.

```bash
git version 2.39.3
git-lfs/3.0.0 (GitHub; windows 386; go 1.8.1; git bd2c9987)
```

--------------------------------

### Install GitKraken Desktop on Linux (.rpm)

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install.md

Use this command to install GitKraken Desktop on Red Hat-based Linux distributions.

```bash
wget https://release.gitkraken.com/linux/gitkraken-amd64.rpm && sudo dnf install ./gitkraken-amd64.rpm
```

--------------------------------

### Install GitKraken Serverless on Linux

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/serverless.md

Use this command to download and install the GitKraken Serverless .deb package on Linux systems.

```bash
wget https://release.gitkraken.com/linux-standalone/gitkraken-amd64.deb && dpkg -i gitkraken-amd64.deb
```

--------------------------------

### Install GitKraken Desktop for Linux

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/windows-subsystem-for-linux.md

Download and install the GitKraken Desktop Debian package on Ubuntu.

```bash
wget https://api.gitkraken.dev/releases/production/linux/x64/active/gitkraken-amd64.deb
sudo apt install ./gitkraken-amd64.deb
```

--------------------------------

### Install GitKraken Desktop on Linux (.deb)

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install.md

Use this command to install GitKraken Desktop on Debian-based Linux distributions.

```bash
wget https://release.gitkraken.com/linux/gitkraken-amd64.deb && sudo apt install ./gitkraken-amd64.deb
```

--------------------------------

### Install GitKraken on Fedora/RHEL

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/serverless.md

Download and install the GitKraken .rpm package using dnf on Fedora or RHEL 8+.

```bash
wget https://release.gitkraken.com/linux-standalone/gitkraken-amd64.rpm
sudo dnf install ./gitkraken-amd64.rpm
```

--------------------------------

### Start GitKraken Self-Hosted Server

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Starts the GitKraken Self-Hosted Server using Docker Compose. This command should be run from the directory containing the docker-compose.yml file.

```bash
sudo docker-compose up
```

--------------------------------

### Install Docker CE on RHEL7 (Online)

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Commands to install Docker CE on RHEL7, including repository configuration and daemon setup.

```bash
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```

```bash
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
```

```bash
sudo yum makecache fast
```

```bash
sudo yum install --setopt=obsoletes=0 docker-ce-17.03.2.ce-1.el7.centos.x86_64 docker-ce-selinux-17.03.2.ce-1.el7.centos.noarch
```

```bash
yum list docker-ce --showduplicates | sort -r
```

```json
{
  "storage-driver": "devicemapper"
}
```

```bash
sudo systemctl start docker
```

```bash
sudo su
```

```bash
curl -L https://github.com/docker/compose/releases/download/1.14.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
```

```bash
sudo chmod +x /usr/local/bin/docker-compose
```

--------------------------------

### Start Docker and Docker Compose on CentOS/RHEL7

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Alternative commands for starting Docker and Docker Compose on CentOS or RHEL7 systems, using full paths for systemctl and docker-compose.

```bash
sudo systemctl start docker.service
sudo /usr/local/bin/docker-compose up
```

--------------------------------

### Pre-commit Hook Example for Email Validation

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/llms-full.txt

This script runs before a commit is finalized to validate the global Git user email. Ensure GitKraken Desktop and a text editor are installed.

```shell
#!/bin/sh

# Get the global Git user email
EMAIL=$(git config --global user.email)

# Define the allowed email pattern (e.g., your company domain)
ALLOWED_EMAIL_PATTERN=".*@example.com"

# Check if the email matches the allowed pattern
if ! echo "$EMAIL" | grep -qE "$ALLOWED_EMAIL_PATTERN"; then
  echo "Error: Your global Git user email ($EMAIL) does not match the required pattern ($ALLOWED_EMAIL_PATTERN)."
  echo "Please update your Git email configuration before committing."
  exit 1
fi

exit 0
```

--------------------------------

### Install Docker CE on Ubuntu (Online)

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Steps to install Docker CE via apt repositories and download Docker Compose.

```bash
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
```

```bash
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
```

```bash
sudo apt-key fingerprint 0EBFCD88
```

```bash
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
```

```bash
sudo apt-get update
```

```bash
sudo apt-get install docker-ce
```

```bash
sudo su
```

```bash
curl -L https://github.com/docker/compose/releases/download/1.14.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
```

```bash
sudo chmod +x /usr/local/bin/docker-compose
```

--------------------------------

### Install GitKraken .tar.gz Archive on Linux

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install.md

Download the .tar.gz archive using wget and then extract it using tar. This method provides a portable installation.

```bash
wget https://release.gitkraken.com/linux/gitkraken-amd64.tar.gz
sudo tar -xvzf gitkraken-amd64.tar.gz
```

--------------------------------

### Install Required Packages on CentOS

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Installs essential packages for Docker installation on CentOS systems. This command requires root privileges.

```bash
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
```

--------------------------------

### Update WSL 2 and Install Ubuntu

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/llms-full.txt

Update your WSL 2 installation and install Ubuntu as the Linux distribution. This is a prerequisite for running Linux applications like GitKraken Desktop within WSL.

```bash
wsl --update
wsl --install -d ubuntu
```

--------------------------------

### Launch GitKraken Desktop on Linux

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install.md

After installation, run this command in the terminal to launch GitKraken Desktop.

```bash
gitkraken
```

--------------------------------

### Install GPG on Fedora

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/llms-full.txt

Install the gnupg2 package on Fedora systems using dnf.

```bash
dnf install gnupg2
```

--------------------------------

### Install Docker CE on Ubuntu (Offline)

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install-self-hosted.md

Commands for installing Docker CE from a local .deb file and setting up Docker Compose.

```bash
lsb_release -a
```

```bash
sudo dpkg -i /path/to/package.deb
# Example:
sudo dpkg -i docker-ce_17.06.0-ce-0-ubuntu_amd64.deb
```

```bash
sudo mv docker-compose-Linux-x86_64 /usr/local/bin/docker-compose
```

```bash
sudo chmod +x /usr/local/bin/docker-compose
```

--------------------------------

### Verify GPG Installation

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/commit-signing-with-gpg.md

Check the installed version of GPG to ensure it is correctly configured.

```bash
gpg --version
```

--------------------------------

### Install GPG via Homebrew

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/commit-signing-with-gpg.md

Use this command to install GPG on macOS systems.

```bash
brew install gpg
```

--------------------------------

### Start Docker Service on CentOS

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/llms-full.txt

Starts the Docker daemon service using systemctl.

```bash
sudo systemctl start docker
```

--------------------------------

### Install GPG on CentOS/RHEL

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/llms-full.txt

Install the gnupg2 package on CentOS or RHEL systems using yum.

```bash
yum install gnupg2
```

--------------------------------

### Install GitKraken .rpm Package on Linux

Source: https://github.com/gitkraken/gitkraken-desktop-docs/blob/main/gitkraken-desktop/how-to-install.md

Use wget to download the .rpm package and then dnf to install it. This method is suitable for RHEL and Fedora-based systems.

```bash
wget https://release.gitkraken.com/linux/gitkraken-amd64.rpm
sudo dnf install ./gitkraken-amd64.rpm
```