AnchorOS/DEPLOYMENT_README.md

🚀 AnchorOS Deployment Guide

📋 Pre-requisitos

• VPS con Ubuntu/Debian 20.04+
• Docker y Docker Compose instalados
• Dominio apuntando a tu VPS
• Certificados SSL (Let's Encrypt recomendado)

🛠️ Configuración Inicial

1. Clonar y configurar

git clone https://github.com/your-repo/anchoros.git
cd anchoros
cp .env.example .env
# Editar .env con tus valores reales

2. Variables críticas

# Requeridas para funcionamiento básico
NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJxxxxx
SUPABASE_SERVICE_ROLE_KEY=eyJxxxxx
RESEND_API_KEY=re_xxxxx
NEXT_PUBLIC_APP_URL=https://tu-dominio.com

3. SSL Certificates

# Instalar Certbot
sudo apt install certbot

# Generar certificados
sudo certbot certonly --standalone -d tu-dominio.com

# Copiar a directorio ssl/
sudo mkdir ssl
sudo cp /etc/letsencrypt/live/tu-dominio.com/fullchain.pem ssl/
sudo cp /etc/letsencrypt/live/tu-dominio.com/privkey.pem ssl/

🚀 Deployment

Opción 1: Script Automático

./deploy.sh production

Opción 2: Manual

# Build e iniciar
docker-compose -f docker-compose.prod.yml up -d --build

# Verificar
curl http://localhost/health

📊 Monitoreo

Logs

# Todos los servicios
docker-compose -f docker-compose.prod.yml logs -f

# Servicio específico
docker-compose -f docker-compose.prod.yml logs -f anchoros

Recursos

# Uso de CPU/Memoria
docker stats

# Espacio en disco
df -h

Health Checks

# API health
curl https://tu-dominio.com/api/health

# Nginx status
curl -H "Host: tu-dominio.com" http://localhost/health

🔧 Mantenimiento

Updates

# Pull latest changes
git pull origin main

# Redeploy
./deploy.sh production

Backup

# Database backup (si usas PostgreSQL local)
docker exec anchoros_db pg_dump -U postgres anchoros > backup.sql

# Logs backup
docker-compose -f docker-compose.prod.yml logs > logs_backup.txt

SSL Renewal

# Renew certificates
sudo certbot renew

# Restart nginx
docker-compose -f docker-compose.prod.yml restart nginx

🚨 Troubleshooting

App no responde

# Verificar contenedores
docker ps

# Logs de la app
docker logs anchoros_app

# Reiniciar app
docker-compose -f docker-compose.prod.yml restart anchoros

Error 502 Bad Gateway

# Nginx no puede conectar con Next.js
docker logs anchoros_nginx

# Verificar que Next.js esté corriendo
curl http://localhost:3000

Alta carga de CPU

# Verificar procesos
docker stats

# Restart services
docker-compose -f docker-compose.prod.yml restart

📈 Optimizaciones de Performance

Nginx Caching

• Static files: 1 año cache
• API responses: No cache
• Rate limiting: 10 req/s

Next.js Optimizations

• Standalone build
• Gzip compression
• Image optimization
• Console removal en prod

Database

• Conexión pool
• Query optimization
• Redis caching (opcional)

🔒 Seguridad

• SSL/TLS 1.2+
• Rate limiting
• Security headers
• No exposición de puertos internos
• Variables de entorno seguras

📞 Soporte

Para issues, revisar:

1. Docker logs
2. Network connectivity
3. Environment variables
4. SSL certificates
5. Database connections