Updatweb

docs/SERVER_MANAGEMENT.md

@@ -0,0 +1,187 @@
+# SkyArtShop Server Management
+
+Your SkyArtShop server is now configured to run persistently on **localhost:5000** using PM2 process manager.
+
+## ✅ What's Been Set Up
+
+1. **PM2 Process Manager** - Manages your Node.js server
+2. **Auto-Restart** - Server automatically restarts if it crashes
+3. **Boot Startup** - Server starts automatically when system boots
+4. **Zero restarts** - Currently running with 0 crashes (stable!)
+
+## 🚀 Server Status
+
+Your server is currently **ONLINE** and running at:
+
+- **URL**: <http://localhost:5000>
+- **Mode**: Development
+- **Database**: PostgreSQL (skyartshop)
+- **Process Manager**: PM2
+
+## 📝 Quick Commands
+
+### Check Server Status
+
+```bash
+cd /media/pts/Website/SkyArtShop
+./manage-server.sh status
+```
+
+### View Live Logs
+
+```bash
+./manage-server.sh logs
+```
+
+(Press Ctrl+C to exit)
+
+### Restart Server
+
+```bash
+./manage-server.sh restart
+```
+
+### Stop Server
+
+```bash
+./manage-server.sh stop
+```
+
+### Start Server
+
+```bash
+./manage-server.sh start
+```
+
+## 🔍 Advanced PM2 Commands
+
+```bash
+# Detailed status
+pm2 show skyartshop
+
+# Monitor CPU/Memory in real-time
+pm2 monit
+
+# View logs (last 100 lines)
+pm2 logs skyartshop --lines 100
+
+# Clear logs
+pm2 flush
+
+# List all PM2 processes
+pm2 list
+```
+
+## 🌐 Accessing Your Website
+
+- **Homepage**: <http://localhost:5000>
+- **Shop Page**: <http://localhost:5000/shop.html>
+- **Admin Login**: <http://localhost:5000/admin/login.html>
+
+## 🔄 Auto-Restart Features
+
+Your server will automatically:
+
+- ✅ Restart if it crashes
+- ✅ Start when you boot your computer
+- ✅ Stay running even when VS Code is closed
+- ✅ Recover from unexpected errors
+
+## 📊 Log Files
+
+Logs are stored in two locations:
+
+**PM2 Logs:**
+
+- Output: `/var/log/skyartshop/pm2-output.log`
+- Errors: `/var/log/skyartshop/pm2-error.log`
+
+**View logs:**
+
+```bash
+tail -f /var/log/skyartshop/pm2-output.log
+tail -f /var/log/skyartshop/pm2-error.log
+```
+
+## ⚙️ Configuration Files
+
+- **PM2 Config**: `ecosystem.config.js`
+- **Environment**: `backend/.env`
+- **Server Script**: `backend/server.js`
+
+## 🛑 Stopping Auto-Start
+
+If you want to disable auto-start on boot:
+
+```bash
+pm2 unstartup systemd
+```
+
+To re-enable:
+
+```bash
+sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u pts --hp /home/pts
+pm2 save
+```
+
+## 🔧 Troubleshooting
+
+### Server not responding?
+
+```bash
+./manage-server.sh status
+# Check if status shows "online"
+```
+
+### Check for errors in logs
+
+```bash
+./manage-server.sh logs
+# or
+pm2 logs skyartshop --err
+```
+
+### Force restart
+
+```bash
+pm2 delete skyartshop
+cd /media/pts/Website/SkyArtShop
+pm2 start ecosystem.config.js
+pm2 save
+```
+
+### Check what's using port 5000
+
+```bash
+sudo lsof -i :5000
+```
+
+## 📁 Project Structure
+
+```
+/media/pts/Website/SkyArtShop/
+├── backend/
+│   ├── server.js          # Main server file
+│   ├── .env               # Environment variables
+│   └── ...
+├── website/
+│   ├── public/            # Public HTML pages
+│   ├── admin/             # Admin panel
+│   └── assets/            # CSS, JS, images
+├── ecosystem.config.js    # PM2 configuration
+└── manage-server.sh       # Server management script
+```
+
+## 🎯 Key Benefits
+
+1. **No VS Code Required** - Server runs independently
+2. **Automatic Recovery** - Restarts on crashes
+3. **Boot Persistence** - Starts with your system
+4. **Easy Management** - Simple commands via manage-server.sh
+5. **Production Ready** - PM2 is industry standard for Node.js
+
+---
+
+**Server Manager Script**: `./manage-server.sh {start|stop|restart|status|logs}`
+
+For help: `./manage-server.sh` (shows usage)