Quick Start

Get TRIGRA up and running on your Kubernetes cluster in under 3 minutes.

⚠️ AUTOMATIC DEPLOYMENT WARNING

TRIGRA automatically applies ALL changes from Git to your cluster. A misconfigured manifest can delete resources or cause outages. Always test in a non-production environment first. Read full security considerations →

Prerequisites

Before you begin, ensure you have:

• ✅ A running Kubernetes cluster
• ✅ kubectl installed and configured
• ✅ Access to create namespaces and deployments

One-Command Install

The fastest way to install TRIGRA:

curl -fsSL https://raw.githubusercontent.com/Taiwrash/trigra/main/quick-install.sh | bash -s -- default

This will:

1. ✅ Create the default namespace (or use existing)
2. ✅ Generate a secure webhook secret
3. ✅ Deploy TRIGRA controller
4. ✅ Install Cloudflare Tunnel (optional)
5. ✅ Display your webhook URL

What Happens Next

After installation, you’ll see output like:

╔══════════════════════════════════════════════════════════════════╗
║  🔗 YOUR WEBHOOK URL (copy this to GitHub):                     ║
╠══════════════════════════════════════════════════════════════════╣
║                                                                  ║
║  https://random-words.trycloudflare.com/webhook
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

✓ Tunnel running in background (PID: 12345)

Configure GitHub Webhook

1. Go to your GitHub repository → Settings → Webhooks
2. Click Add webhook
3. Configure:
   • Payload URL: The webhook URL from installation
   • Content type: application/json
   • Secret: Your webhook secret (shown during install)
   • Events: Just the push event

Verify Installation

Check that everything is running:

# Check deployment
kubectl get deployment trigra

# Check pods
kubectl get pods -l app=trigra

# View logs
kubectl logs -f deployment/trigra

Test Your Setup

Create a simple deployment in your repository:

test-app.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: test-nginx
spec:
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:alpine

Commit and push:

git add test-app.yaml
git commit -m "Test GitOps deployment"
git push

Watch it deploy:

kubectl get deployments -w

Next Steps

• 📖 Read the full Installation Guide for more options
• 🔗 Learn about GitHub Webhooks configuration
• 🌐 Set up Cloudflare Tunnel for external access
• 📦 Deploy pre-built examples