# TagneticAI Email Client - Server Deployment Summary\n\n**Domain**: email.tagneticai.com  \n**Server Type**: WHMCS (Linux-based)  \n**SSL**: You have a certificate  \n**Status**: Ready to deploy  \n\n---\n\n## 📋 What You Need Before Starting\n\n✅ Your mail server credentials:\n- Mail server hostname (e.g., mail.yourdomain.com)\n- Email account (e.g., your-email@yourdomain.com)\n- Email password\n- IMAP port (usually 993)\n- SMTP port (usually 465)\n\n✅ Server access:\n- SSH username/password or key\n- Server IP address\n- Root or sudo privileges\n\n✅ SSL certificate:\n- Certificate file (.crt or .pem)\n- Private key file (.key)\n- Or the path on your server if already installed\n\n---\n\n## 🚀 Quick Deployment Path (Fastest)\n\n### For Windows Users:\n\n1. **Download WinSCP**: https://winscp.net/\n\n2. **Connect to server**:\n   - Host: your-server-ip\n   - Username: root\n   - Protocol: SFTP or SCP\n\n3. **Create directory**: `/opt/tagneticai-email`\n\n4. **Upload these files from your project folder**:\n   ```\n   app/\n   components/\n   package.json\n   package-lock.json\n   .env.example\n   next.config.js\n   tsconfig.json\n   tailwind.config.ts\n   postcss.config.js\n   ```\n\n5. **SSH into server** (using PuTTY or PowerShell):\n   ```powershell\n   ssh root@your-server-ip\n   ```\n\n6. **Run deployment**:\n   ```bash\n   cd /opt/tagneticai-email\n   bash deploy.sh\n   ```\n\n7. **When prompted**:\n   - Enter domain: `email.tagneticai.com`\n   - Follow the on-screen instructions\n\n---\n\n## 📁 File Reference\n\nYou now have 4 deployment guides:\n\n1. **WHMCS-DEPLOYMENT.md** ← **START HERE** (Detailed step-by-step)\n2. **DEPLOYMENT_CHECKLIST.md** (Verification checkpoints)\n3. **deploy.sh** (Automated deployment script)\n4. **upload-to-server.bat** (For uploading files on Windows)\n\n---\n\n## 🎯 Step-by-Step Summary\n\n### Step 1: Upload Files (10 mins)\n- Use WinSCP to upload to `/opt/tagneticai-email`\n- Or use SCP from PowerShell\n\n### Step 2: SSH Into Server (1 min)\n```bash\nssh root@your-server-ip\ncd /opt/tagneticai-email\n```\n\n### Step 3: Run Automated Deployment (5-10 mins)\n```bash\nbash deploy.sh\n# Follow prompts\n```\n\n### Step 4: Configure Mail Credentials (2 mins)\n```bash\nnano .env\n# Edit the following:\n# EMAIL_HOST\n# EMAIL_USER\n# EMAIL_PASSWORD\n# EMAIL_IMAP_PORT\n# EMAIL_SMTP_PORT\n```\n\n### Step 5: Update SSL Paths (2 mins)\n```bash\nnano /etc/nginx/sites-available/tagneticai-email\n# Update:\n# ssl_certificate /path/to/cert.crt\n# ssl_certificate_key /path/to/key.key\n```\n\n### Step 6: Test & Verify (2 mins)\n```bash\npm2 status\npm2 logs tagneticai-email\n# Open browser: https://email.tagneticai.com\n```\n\n**Total Time: ~30 minutes**\n\n---\n\n## 📍 Critical SSL Certificate Paths\n\nFind your certificate on the server:\n\n```bash\n# If using Let's Encrypt\nls /etc/letsencrypt/live/email.tagneticai.com/\n# Use:\n# ssl_certificate /etc/letsencrypt/live/email.tagneticai.com/fullchain.pem;\n# ssl_certificate_key /etc/letsencrypt/live/email.tagneticai.com/privkey.pem;\n\n# If in cPanel\nls /usr/local/cpanel/ssl/installed/\n\n# If custom\nfind / -name '*.crt' -path '*email.tagneticai.com*' 2>/dev/null\nfind / -name '*.key' -path '*email.tagneticai.com*' 2>/dev/null\n```\n\n---\n\n## ✅ Verification Checklist\n\nAfter deployment:\n\n```bash\n# 1. Check if app is running\npm2 status\n\n# 2. Check logs for errors\npm2 logs tagneticai-email --lines 20\n\n# 3. Check if port 3000 is listening\nnetstat -tulpn | grep 3000\n\n# 4. Check if Nginx is running\nsudo systemctl status nginx\n\n# 5. Test SSL certificate\necho | openssl s_client -connect email.tagneticai.com:443 2>/dev/null | grep -A 2 \"subject=\"\n```\n\nThen open in browser:\n```\nhttps://email.tagneticai.com\n```\n\nYou should see the email client interface! ✨\n\n---\n\n## 🆘 Troubleshooting Quick Guide\n\n### \"502 Bad Gateway\"\n```bash\npm2 restart tagneticai-email\nsudo systemctl reload nginx\n```\n\n### \"Connection refused to mail server\"\n```bash\ntelnet mail.yourdomain.com 993\ntelnet mail.yourdomain.com 465\n# If hangs, check firewall on mail server\n```\n\n### \"SSL certificate error\"\n```bash\n# Verify certificate path in Nginx config\nnano /etc/nginx/sites-available/tagneticai-email\n# Check if files exist at those paths\nls /path/to/certificate.crt\nls /path/to/certificate.key\n```\n\n### \"Application won't start\"\n```bash\npm2 logs tagneticai-email  # Check errors\ncat .env                    # Verify .env format\nnpm run build               # Try building again\n```\n\n---\n\n## 📞 Key Commands to Remember\n\n```bash\n# Start/stop application\npm2 start/stop/restart tagneticai-email\n\n# View logs\npm2 logs tagneticai-email\npm2 logs --lines 50      # Last 50 lines\n\n# Monitor\npm2 monit                 # Real-time monitoring\npm2 status                # Current status\n\n# Nginx\nsudo nginx -t             # Test config\nsudo systemctl reload nginx\nsudo systemctl restart nginx\n\n# SSH into app directory\ncd /opt/tagneticai-email\n```\n\n---\n\n## 🎯 What Happens Next\n\n1. ✅ **Application starts** on port 3000 (private)\n2. ✅ **Nginx listens** on port 443 (public HTTPS)\n3. ✅ **Your domain** email.tagneticai.com redirects through Nginx\n4. ✅ **Users access** https://email.tagneticai.com\n5. ✅ **Email client** connects to your mail server via IMAP/SMTP\n6. ✅ **Emails appear** in the inbox\n\n---\n\n## 📚 Detailed Guides Location\n\n| Guide | Use When |\n|-------|----------|\n| **WHMCS-DEPLOYMENT.md** | First time deploying, need detailed steps |\n| **DEPLOYMENT_CHECKLIST.md** | Want to verify everything is correct |\n| **deploy.sh** | Using automated deployment |\n| **README.md** | Need general information |\n| **DEPLOYMENT.md** | Deploying to other cloud platforms |\n\n---\n\n## 💡 Pro Tips\n\n1. **Test mail server connection first** before deployment:\n   ```bash\n   telnet mail.yourdomain.com 993\n   telnet mail.yourdomain.com 465\n   ```\n\n2. **Backup your .env file**:\n   ```bash\n   cp .env .env.backup\n   ```\n\n3. **Monitor logs during first test**:\n   ```bash\n   pm2 logs --lines 100\n   ```\n\n4. **Update Nginx config gradually**:\n   - First test with HTTP (port 80)\n   - Then add SSL (port 443)\n   - Finally force redirect 80→443\n\n---\n\n## 🎉 You're Ready!\n\nYour complete, production-ready email client is prepared for deployment.\n\n**Next**: Follow the 6 steps in the \"Quick Deployment Path\" above.\n\n**Questions?** Check the detailed guides:\n- 📖 **WHMCS-DEPLOYMENT.md** has complete instructions with troubleshooting\n- ✓ **DEPLOYMENT_CHECKLIST.md** helps verify each step\n\n**Let's get your email client live!** 🚀\n"