════════════════════════════════════════════════════════════════
    myFidelityTracker - Linux Deployment Quick Reference
════════════════════════════════════════════════════════════════

📦 TRANSFER TO LINUX SERVER
────────────────────────────────────────────────────────────────
From your Mac:
  scp -r /Users/chris/Desktop/fidelity USER@SERVER_IP:~/

Or with rsync:
  rsync -avz /Users/chris/Desktop/fidelity/ USER@SERVER_IP:~/fidelity/

════════════════════════════════════════════════════════════════

🚀 FIRST-TIME SETUP ON LINUX
────────────────────────────────────────────────────────────────
ssh USER@SERVER_IP
cd ~/fidelity

# Make scripts executable
chmod +x start-linux.sh stop.sh

# Configure CORS (edit .env file)
cp .env.example .env
nano .env
# Change: CORS_ORIGINS=http://localhost:3000,http://YOUR_SERVER_IP:3000

# Start the app
./start-linux.sh

════════════════════════════════════════════════════════════════

🌐 ACCESS URLs
────────────────────────────────────────────────────────────────
From the server:        http://localhost:3000
From other computers:   http://SERVER_IP:3000
API Documentation:      http://SERVER_IP:8000/docs

════════════════════════════════════════════════════════════════

🔥 FIREWALL SETUP (Ubuntu)
────────────────────────────────────────────────────────────────
sudo ufw allow 22/tcp
sudo ufw allow 3000/tcp
sudo ufw allow 8000/tcp
sudo ufw enable

════════════════════════════════════════════════════════════════

📝 DAILY COMMANDS
────────────────────────────────────────────────────────────────
Start:        ./start-linux.sh
Stop:         ./stop.sh
View logs:    docker-compose logs -f
Status:       docker-compose ps
Restart:      docker-compose restart

════════════════════════════════════════════════════════════════

🌱 LOAD DEMO DATA
────────────────────────────────────────────────────────────────
cp History_for_Account_X38661988.csv imports/
docker-compose exec backend python seed_demo_data.py

════════════════════════════════════════════════════════════════

⚙️ WHAT CHANGED FROM macOS?
────────────────────────────────────────────────────────────────
✓ Use start-linux.sh (not start.sh)
✓ Add server IP to CORS_ORIGINS in .env
✓ Configure firewall to allow ports 3000, 8000
✓ Everything else works the same!

════════════════════════════════════════════════════════════════

🆘 TROUBLESHOOTING
────────────────────────────────────────────────────────────────
Port in use:
  sudo lsof -i :3000
  sudo kill <PID>

Can't access from other computers:
  1. Check firewall: sudo ufw status
  2. Check CORS in .env has your server IP
  3. Verify services running: docker-compose ps

Permission errors:
  sudo usermod -aG docker $USER
  newgrp docker

Out of space:
  docker system prune -a

════════════════════════════════════════════════════════════════

📚 FULL DOCUMENTATION
────────────────────────────────────────────────────────────────
See LINUX_DEPLOYMENT.md for complete guide
See README.md for full application documentation

════════════════════════════════════════════════════════════════