← Back to Documentation

Quick Start Guide

Get PatchPulse up and running in 10 minutes

Prerequisites

Installation Steps

1 Add PatchPulse Helm Repository

Add our Helm repository to your local Helm configuration.

helm repo add patchpulse https://charts.patchpulse.io
helm repo update
2 Create Namespace

Create a dedicated namespace for PatchPulse components.

kubectl create namespace patchpulse
3 Configure Secrets

Create secrets for Git integration and API keys.

kubectl create secret generic patchpulse-secrets \
  --from-literal=github-token=YOUR_TOKEN \
  --from-literal=deepseek-api-key=YOUR_KEY \
  -n patchpulse
4 Install Backend

Deploy the PatchPulse backend service.

helm install patchpulse-backend patchpulse/backend \
  --namespace patchpulse \
  --set policy.mode=advisory
5 Install Agent

Deploy the Kubernetes agent to monitor your cluster.

helm install patchpulse-agent patchpulse/agent \
  --namespace patchpulse \
  --set backend.url=http://patchpulse-backend:8000
6 Configure Git Integration

Set up webhooks or polling for your Git repositories.

kubectl apply -f - <<EOF
apiVersion: v1
kind: ConfigMap
metadata:
  name: git-config
data:
  repos: "org/repo1,org/repo2"
EOF

Verify Installation

Check that all components are running:

kubectl get pods -n patchpulse
kubectl get svc -n patchpulse

Access the dashboard at the service URL or via port-forward:

kubectl port-forward -n patchpulse svc/patchpulse-backend 8000:8000

Next Steps