aidevops 2.52.1 → 2.53.2

package/.agent/tools/deployment/coolify-setup.md

@@ -1,353 +0,0 @@
----
-description: Coolify server installation and configuration
-mode: subagent
-tools:
-  read: true
-  write: true
-  edit: true
-  bash: true
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# Coolify Setup Guide
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: Self-hosted alternative to Vercel/Netlify/Heroku
-- **Install**: `curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash`
-- **Requirements**: 2GB+ RAM, Ubuntu 20.04+/Debian 11+, ports 22/80/443/8000
-- **Dashboard**: `https://your-server-ip:8000`
-- **Helper**: `.agent/scripts/coolify-helper.sh`
-- **Commands**: `list` | `connect [server]` | `open [server]` | `status [server]` | `apps [server]` | `exec [server] [cmd]`
-- **Config**: `configs/coolify-config.json`
-- **Features**: Git deployments, databases (PostgreSQL/MySQL/MongoDB/Redis), SSL automation, Docker containers
-- **Docs**: https://coolify.io/docs
-<!-- AI-CONTEXT-END -->
-
-Coolify is a self-hosted alternative to Vercel, Netlify, and Heroku that allows you to deploy applications with ease using Docker containers.
-
-## What is Coolify?
-
-Coolify is an open-source, self-hostable cloud platform that:
-
-- **Deploys applications** from Git repositories automatically
-- **Manages databases** (PostgreSQL, MySQL, MongoDB, Redis, etc.)
-- **Handles SSL certificates** automatically via Let's Encrypt
-- **Provides monitoring** and logging for your applications
-- **Supports multiple languages** (Node.js, Python, PHP, Go, Rust, static sites)
-- **Uses Docker** for containerization and isolation
-
-## 📋 **Prerequisites**
-
-### **Server Requirements:**
-
-- **VPS or dedicated server** with at least 2GB RAM (4GB+ recommended)
-- **Ubuntu 20.04+ or Debian 11+** (recommended)
-- **Root access** or sudo privileges
-- **Domain name** pointing to your server
-- **Open ports**: 22 (SSH), 80 (HTTP), 443 (HTTPS), 8000 (Coolify dashboard)
-
-### **Local Requirements:**
-
-- **SSH key** for server access
-- **Git repositories** for your applications
-- **Domain DNS** configured to point to your server
-
-## 🛠️ **Installation**
-
-### **1. Server Setup**
-
-#### **Install Coolify:**
-
-```bash
-# Connect to your server
-ssh root@your-server-ip
-
-# Install Coolify (one-line installer)
-curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
-```
-
-#### **Post-Installation:**
-
-```bash
-# Check Coolify status
-systemctl status coolify
-
-# View Coolify logs
-docker logs coolify
-
-# Access Coolify dashboard
-# Open: https://your-server-ip:8000
-```
-
-### **2. Initial Configuration**
-
-#### **Access Web Interface:**
-
-1. **Open browser**: `https://your-server-ip:8000`
-2. **Create admin account**: Set username and password
-3. **Configure server**: Add your server details
-4. **Setup domain**: Configure your domain name
-5. **Generate SSH keys**: For Git repository access
-
-#### **Security Setup:**
-
-```bash
-# Configure firewall (if using ufw)
-ufw allow 22/tcp
-ufw allow 80/tcp
-ufw allow 443/tcp
-ufw allow 8000/tcp
-ufw enable
-
-# Update system packages
-apt update && apt upgrade -y
-
-# Setup automatic security updates
-apt install unattended-upgrades -y
-dpkg-reconfigure -plow unattended-upgrades
-```
-
-## 🔧 **Framework Configuration**
-
-### **1. Copy Configuration Template:**
-
-```bash
-cp configs/coolify-config.json.txt configs/coolify-config.json
-```
-
-### **2. Edit Configuration:**
-
-```json
-{
-  "servers": {
-    "coolify-main": {
-      "name": "Main Coolify Server",
-      "host": "coolify.yourdomain.com",
-      "ip": "your-server-ip",
-      "coolify_url": "https://coolify.yourdomain.com",
-      "ssh_key": "~/.ssh/id_ed25519"
-    }
-  },
-  "api_configuration": {
-    "main_server": {
-      "api_token": "your-coolify-api-token",
-      "base_url": "https://coolify.yourdomain.com/api/v1"
-    }
-  }
-}
-```
-
-### **3. Generate API Token:**
-
-1. **Login to Coolify dashboard**
-2. **Go to Settings** → API Tokens
-3. **Create new token** with required permissions
-4. **Copy token** to your configuration file
-
-## 🚀 **Deploying Your First Application**
-
-### **1. Static Site (React/Vue/Angular):**
-
-```bash
-# In Coolify dashboard:
-# 1. Create new application
-# 2. Connect Git repository
-# 3. Set build command: npm run build
-# 4. Set output directory: dist (or build)
-# 5. Configure domain name
-# 6. Deploy!
-```
-
-### **2. Node.js Application:**
-
-```bash
-# In Coolify dashboard:
-# 1. Create new application
-# 2. Connect Git repository
-# 3. Set start command: npm start
-# 4. Configure environment variables
-# 5. Set port (usually 3000)
-# 6. Configure domain name
-# 7. Deploy!
-```
-
-### **3. Database Setup:**
-
-```bash
-# In Coolify dashboard:
-# 1. Go to Databases
-# 2. Create new database (PostgreSQL/MySQL/MongoDB/Redis)
-# 3. Configure database name and credentials
-# 4. Connect to your application via environment variables
-```
-
-## 🔧 **Using the Framework Helper**
-
-### **Server Management:**
-
-```bash
-# List Coolify servers
-./.agent/scripts/coolify-helper.sh list
-
-# Connect to server via SSH
-./.agent/scripts/coolify-helper.sh connect coolify-main
-
-# Open Coolify web interface
-./.agent/scripts/coolify-helper.sh open coolify-main
-
-# Check server status
-./.agent/scripts/coolify-helper.sh status coolify-main
-```
-
-### **Application Management:**
-
-```bash
-# List applications on server
-./.agent/scripts/coolify-helper.sh apps main_server
-
-# Execute commands on server
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
-```
-
-### **SSH Configuration:**
-
-```bash
-# Generate SSH configs for easy access
-./.agent/scripts/coolify-helper.sh generate-ssh-configs
-
-# Then you can simply use:
-ssh coolify-main
-```
-
-## 🛡️ **Security Best Practices**
-
-### **Server Security:**
-
-- **Use SSH keys** instead of passwords
-- **Configure firewall** to allow only necessary ports
-- **Enable automatic security updates**
-- **Regular backups** of applications and databases
-- **Monitor server resources** and logs
-
-### **Application Security:**
-
-- **Use environment variables** for sensitive configuration
-- **Enable HTTPS** for all applications (automatic with Coolify)
-- **Regular updates** of application dependencies
-- **Implement proper logging** and monitoring
-- **Use strong database passwords**
-
-### **Access Control:**
-
-- **Limit SSH access** to specific IP addresses
-- **Use strong passwords** for Coolify dashboard
-- **Regular API token rotation**
-- **Monitor access logs** for suspicious activity
-
-## 🔍 **Monitoring & Maintenance**
-
-### **Health Checks:**
-
-```bash
-# Check Coolify service status
-./.agent/scripts/coolify-helper.sh exec coolify-main 'systemctl status coolify'
-
-# Check Docker containers
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
-
-# Check disk space
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
-
-# Check memory usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'free -h'
-```
-
-### **Log Management:**
-
-```bash
-# View Coolify logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs coolify'
-
-# View application logs (in Coolify dashboard)
-# Go to Application → Logs tab
-
-# System logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'journalctl -u coolify -f'
-```
-
-### **Backup Strategy:**
-
-- **Database backups**: Configure automatic backups in Coolify
-- **Application code**: Stored in Git repositories
-- **Server snapshots**: Regular VPS/server snapshots
-- **Configuration backups**: Backup Coolify configuration
-
-## 🚨 **Troubleshooting**
-
-### **Common Issues:**
-
-#### **Deployment Fails:**
-
-```bash
-# Check build logs in Coolify dashboard
-# Verify build commands and dependencies
-# Check environment variables
-# Ensure sufficient disk space and memory
-```
-
-#### **SSL Certificate Issues:**
-
-```bash
-# Verify domain DNS points to server
-# Check firewall allows ports 80 and 443
-# Ensure domain is properly configured in Coolify
-# Check Let's Encrypt rate limits
-```
-
-#### **Application Not Accessible:**
-
-```bash
-# Check application logs in Coolify dashboard
-# Verify port configuration
-# Check health check endpoints
-# Ensure application is running (docker ps)
-```
-
-#### **Database Connection Issues:**
-
-```bash
-# Verify database is running
-# Check connection strings and credentials
-# Ensure network connectivity between containers
-# Check database logs
-```
-
-## 📚 **Additional Resources**
-
-- **Official Documentation**: https://coolify.io/docs
-- **GitHub Repository**: https://github.com/coollabsio/coolify
-- **Community Discord**: https://discord.gg/coolify
-- **Video Tutorials**: Available on YouTube
-- **Example Applications**: https://github.com/coollabsio/coolify-examples
-
-## 🎯 **Benefits for AI-Assisted Development**
-
-- **Automated deployments** from Git pushes
-- **Environment management** for different stages
-- **Database provisioning** with one click
-- **SSL certificate automation**
-- **Container orchestration** without complexity
-- **Monitoring and logging** built-in
-- **Cost-effective** compared to cloud platforms
-- **Full control** over your infrastructure
-
----
-
-**Coolify provides a powerful, self-hosted alternative to expensive cloud platforms while maintaining simplicity and automation!** 🚀

package/.agent/tools/deployment/coolify.md

@@ -1,345 +0,0 @@
----
-description: Self-hosted PaaS deployment with Coolify
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: true
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# Coolify Provider Guide
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Type**: Self-hosted PaaS (Docker-based)
-- **Install**: `curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash`
-- **Access**: `https://server-ip:8000`
-- **Config**: `configs/coolify-config.json`
-- **Commands**: `coolify-helper.sh [list|connect|open|status|apps|exec] [server] [args]`
-- **Features**: Auto SSL, GitHub/GitLab/Bitbucket integration, PostgreSQL/MySQL/MongoDB/Redis
-- **SSH**: Ed25519 keys recommended
-- **Ports**: 22 (SSH), 80 (HTTP), 443 (HTTPS), 8000 (Coolify UI)
-<!-- AI-CONTEXT-END -->
-
-Coolify is a self-hosted, open-source alternative to Vercel, Netlify, and Heroku that simplifies application deployment using Docker containers.
-
-## Provider Overview
-
-### **Coolify Characteristics:**
-
-- **Deployment Type**: Self-hosted PaaS (Platform as a Service)
-- **Technology**: Docker-based containerization
-- **Git Integration**: GitHub, GitLab, Bitbucket, self-hosted Git
-- **Languages**: Node.js, Python, PHP, Go, Rust, static sites, Docker
-- **Databases**: PostgreSQL, MySQL, MongoDB, Redis, and more
-- **SSL**: Automatic Let's Encrypt certificate management
-- **Monitoring**: Built-in application and server monitoring
-
-### **Best Use Cases:**
-
-- **Self-hosted deployments** with full control
-- **Cost-effective alternative** to cloud platforms
-- **Docker-based applications** and microservices
-- **Rapid prototyping** and development environments
-- **Multi-environment deployments** (dev, staging, prod)
-- **Team collaboration** with shared deployment platform
-
-## 🔧 **Configuration**
-
-### **Setup Configuration:**
-
-```bash
-# Copy template
-cp configs/coolify-config.json.txt configs/coolify-config.json
-
-# Edit with your actual server details
-```
-
-### **Multi-Server Configuration:**
-
-```json
-{
-  "servers": {
-    "coolify-main": {
-      "name": "Main Coolify Server",
-      "host": "coolify.yourdomain.com",
-      "ip": "your-server-ip",
-      "coolify_url": "https://coolify.yourdomain.com",
-      "ssh_key": "~/.ssh/id_ed25519"
-    },
-    "coolify-staging": {
-      "name": "Staging Coolify Server",
-      "host": "staging-coolify.yourdomain.com",
-      "ip": "staging-server-ip",
-      "coolify_url": "https://staging-coolify.yourdomain.com",
-      "ssh_key": "~/.ssh/id_ed25519"
-    }
-  },
-  "api_configuration": {
-    "main_server": {
-      "api_token": "your-coolify-api-token",
-      "base_url": "https://coolify.yourdomain.com/api/v1"
-    }
-  }
-}
-```
-
-### **Initial Server Setup:**
-
-```bash
-# Install Coolify on your server
-curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
-
-# Access Coolify dashboard
-# https://your-server-ip:8000
-```
-
-## 🚀 **Usage Examples**
-
-### **Server Management:**
-
-```bash
-# List Coolify servers
-./.agent/scripts/coolify-helper.sh list
-
-# Connect to server
-./.agent/scripts/coolify-helper.sh connect coolify-main
-
-# Open Coolify web interface
-./.agent/scripts/coolify-helper.sh open coolify-main
-
-# Check server status
-./.agent/scripts/coolify-helper.sh status coolify-main
-```
-
-### **Application Management:**
-
-```bash
-# List applications
-./.agent/scripts/coolify-helper.sh apps main_server
-
-# Execute commands on server
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
-
-# Check Docker containers
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs container-name'
-```
-
-### **SSH Configuration:**
-
-```bash
-# Generate SSH configs
-./.agent/scripts/coolify-helper.sh generate-ssh-configs
-
-# Then use simplified SSH
-ssh coolify-main
-```
-
-## 🛡️ **Security Best Practices**
-
-### **Server Security:**
-
-```bash
-# Configure firewall
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 22/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 80/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 443/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw allow 8000/tcp'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'ufw enable'
-```
-
-### **SSH Key Management:**
-
-- **Use Ed25519 keys**: More secure and faster
-- **Key rotation**: Regular key rotation schedule
-- **Access control**: Limit SSH access to specific IPs
-- **Backup keys**: Maintain backup access methods
-
-### **Application Security:**
-
-- **Environment variables**: Secure configuration management
-- **HTTPS enforcement**: Automatic SSL for all applications
-- **Container isolation**: Docker provides application isolation
-- **Regular updates**: Keep Coolify and applications updated
-
-## 🔍 **Troubleshooting**
-
-### **Common Issues:**
-
-#### **Deployment Failures:**
-
-```bash
-# Check build logs in Coolify dashboard
-# Verify build commands and dependencies
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs build-container'
-
-# Check disk space
-./.agent/scripts/coolify-helper.sh exec coolify-main 'df -h'
-
-# Check memory usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'free -h'
-```
-
-#### **SSL Certificate Issues:**
-
-```bash
-# Verify domain DNS
-nslookup yourdomain.com
-
-# Check Let's Encrypt logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs coolify'
-
-# Manual certificate renewal
-./.agent/scripts/coolify-helper.sh exec coolify-main 'certbot renew'
-```
-
-#### **Application Not Accessible:**
-
-```bash
-# Check application status
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps'
-
-# Check application logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs app-container'
-
-# Verify port configuration
-./.agent/scripts/coolify-helper.sh exec coolify-main 'netstat -tlnp'
-```
-
-## 📊 **Performance Optimization**
-
-### **Server Resources:**
-
-```bash
-# Monitor resource usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'htop'
-./.agent/scripts/coolify-helper.sh exec coolify-main 'iostat -x 1'
-
-# Docker resource usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker stats'
-```
-
-### **Application Performance:**
-
-- **Resource limits**: Set appropriate CPU/memory limits
-- **Health checks**: Configure application health checks
-- **Caching**: Implement Redis caching where appropriate
-- **CDN**: Use CDN for static assets
-
-### **Database Optimization:**
-
-```bash
-# Monitor database performance
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker exec postgres-container pg_stat_activity'
-
-# Database backups
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker exec postgres-container pg_dump dbname > backup.sql'
-```
-
-## 🔄 **Backup & Disaster Recovery**
-
-### **Application Backups:**
-
-- **Git repositories**: Source code in version control
-- **Database backups**: Automated database backups
-- **Volume backups**: Docker volume snapshots
-- **Configuration backups**: Coolify configuration exports
-
-### **Server Snapshots:**
-
-```bash
-# Create server snapshot (if on cloud provider)
-# Hetzner: Create snapshot via API
-# DigitalOcean: Create snapshot via API
-# AWS: Create AMI snapshot
-```
-
-## 🐳 **Docker & Container Management**
-
-### **Container Operations:**
-
-```bash
-# List containers
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker ps -a'
-
-# Container logs
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker logs -f container-name'
-
-# Execute in container
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker exec -it container-name bash'
-
-# Container resource usage
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker stats container-name'
-```
-
-### **Image Management:**
-
-```bash
-# List images
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker images'
-
-# Clean up unused images
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker image prune -a'
-
-# Clean up unused volumes
-./.agent/scripts/coolify-helper.sh exec coolify-main 'docker volume prune'
-```
-
-## 📚 **Best Practices**
-
-### **Deployment Workflow:**
-
-1. **Local development**: Develop and test locally
-2. **Git integration**: Push to Git repository
-3. **Automatic deployment**: Coolify deploys automatically
-4. **Health checks**: Monitor application health
-5. **Rollback capability**: Quick rollback if issues occur
-
-### **Environment Management:**
-
-- **Separate environments**: Dev, staging, production
-- **Environment variables**: Secure configuration management
-- **Database separation**: Separate databases per environment
-- **Domain management**: Clear domain naming conventions
-
-### **Monitoring & Maintenance:**
-
-- **Application monitoring**: Built-in Coolify monitoring
-- **Server monitoring**: System resource monitoring
-- **Log management**: Centralized log collection
-- **Backup verification**: Regular backup testing
-
-## 🎯 **AI Assistant Integration**
-
-### **Automated Deployment:**
-
-- **Git webhook integration**: Automatic deployments on push
-- **Build automation**: Automated build processes
-- **Testing integration**: Automated testing before deployment
-- **Rollback automation**: Automated rollback on failure
-
-### **Monitoring & Alerts:**
-
-- **Health monitoring**: Automated health checks
-- **Performance monitoring**: Resource usage tracking
-- **Error alerting**: Automated error notifications
-- **Capacity planning**: Automated scaling recommendations
-
-### **Development Workflows:**
-
-- **Environment provisioning**: Automated environment setup
-- **Database migrations**: Automated database updates
-- **SSL management**: Automated certificate renewal
-- **Backup scheduling**: Automated backup processes
-
----
-
-**Coolify provides a powerful, self-hosted deployment platform that combines the simplicity of modern PaaS with the control of self-hosting.** 🚀