How to Set Up a Development Workflow with Git on Your Breeze

How to Set Up a Development Workflow with Git on Your Breeze

Using Git on your Breeze enables version-controlled deployments, collaborative development, and reliable rollback capabilities. Whether you are a solo developer pushing code from your laptop or part of a team, a well-structured Git workflow on your server ensures that deployments are consistent, auditable, and reversible.

Installing Git

Git is typically pre-installed on most Breeze OS templates. Verify and install if needed:

# Ubuntu/Debian
sudo apt update && sudo apt install -y git

# AlmaLinux/Rocky
sudo dnf install -y git

# Verify installation
git --version

Configuring Git on Your Breeze

Set your identity for commit history:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

Setting Up SSH Key Authentication

Generate an SSH key pair for secure communication with your Git remote:

ssh-keygen -t ed25519 -C "your-breeze-server"
cat ~/.ssh/id_ed25519.pub

Add the public key to your Git hosting platform (Gitea, GitHub, GitLab, etc.) under SSH Keys in your account settings.

Creating a Bare Repository for Deployments

A bare repository on your Breeze acts as a remote that you push to, triggering automated deployments:

# Create the bare repo
sudo mkdir -p /var/repo/myapp.git
sudo chown $USER:$USER /var/repo/myapp.git
cd /var/repo/myapp.git
git init --bare

Setting Up a Post-Receive Hook

The post-receive hook runs after every push, deploying code to your web directory:

cat > /var/repo/myapp.git/hooks/post-receive