-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathQUICKSTART.txt
More file actions
246 lines (233 loc) · 23.2 KB
/
QUICKSTART.txt
File metadata and controls
246 lines (233 loc) · 23.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
╔════════════════════════════════════════════════════════════════════════════╗
║ MDDS PLESK DEPLOYMENT - QUICK START GUIDE ║
║ ║
║ Project: MDDS (Node.js Backend + React Frontend) ║
║ Deployment: Plesk Windows Server + IIS + iisnode ║
║ Updated: 2025-11-30 ║
╚════════════════════════════════════════════════════════════════════════════╝
┌─ 🚀 FASTEST DEPLOYMENT (60 seconds) ──────────────────────────────────────┐
│ │
│ 1. Open Command Prompt (Admin) │
│ 2. Run: │
│ │
│ cd D:\httpdocs\yourdomain.com\httpdocs │
│ npm run plesk-deploy │
│ │
│ Done! Application will auto-start via IIS. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 📋 WHAT WAS ADDED ─────────────────────────────────────────────────────────┐
│ │
│ ✓ web.config Backend IIS configuration │
│ ✓ dist/public/web.config Frontend React routing │
│ ✓ plesk-deploy.bat Interactive menu script │
│ ✓ plesk-deploy.ps1 Advanced PowerShell script │
│ ✓ PLESK_DEPLOYMENT.md Full setup guide (Türkçe) │
│ ✓ PLESK_COMMANDS_REFERENCE.txt Quick reference │
│ ✓ SUBDOMAIN_SETUP.md Subdomain config │
│ ✓ DEPLOYMENT_SUMMARY.md This deployment summary │
│ ✓ package.json updates New npm scripts │
│ │
│ All files are Git-tracked and auto-deployed. │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ ⚙️ ONE-TIME PLESK SETUP ──────────────────────────────────────────────────┐
│ │
│ 1. Plesk Panel → Domains → yourdomain.com → Node.js │
│ │
│ 2. Click "Enable Node.js support" │
│ │
│ 3. Configure: │
│ Node.js version: 20.x LTS │
│ Startup file: dist/index.js │
│ │
│ 4. Environment Variables → Add: │
│ NODE_ENV = production │
│ FRONTEND_URL = https://yourdomain.com │
│ PORT = 3000 │
│ DATABASE_URL = your_db_url │
│ SESSION_SECRET = random_key │
│ │
│ 5. Git → Set repository URL: │
│ https://github.com/your-username/mdds-replit.git │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 🔄 DEPLOYMENT METHODS ────────────────────────────────────────────────────┐
│ │
│ METHOD 1: Batch Script (Windows CMD) │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ plesk-deploy.bat │ │
│ │ (Select from menu: 1=Full, 2=Quick, 3=Production) │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ METHOD 2: PowerShell (Recommended for automation) │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ .\plesk-deploy.ps1 -Scenario "full" │ │
│ │ .\plesk-deploy.ps1 -Scenario "quick" │ │
│ │ .\plesk-deploy.ps1 -Scenario "production" │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ METHOD 3: npm (Simple) │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ npm run plesk-deploy # Full build + start │ │
│ │ npm run plesk-build # npm install + build │ │
│ │ npm run plesk-build-prod # npm ci + build (production) │ │
│ │ npm run plesk-start # Start application │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ METHOD 4: GitHub Auto-Deploy │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ Set in Plesk: Additional Deployment Actions: │ │
│ │ │ │
│ │ powershell -NoProfile -ExecutionPolicy Bypass ^ │ │
│ │ -File "plesk-deploy.ps1" -Scenario "full" │ │
│ │ │ │
│ │ Now auto-deploys when you push to GitHub! │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 🛠️ COMMON COMMANDS ───────────────────────────────────────────────────────┐
│ │
│ Check Node.js running: │
│ > tasklist | findstr node │
│ │
│ Kill Node.js process: │
│ > taskkill /F /IM node.exe │
│ │
│ Restart IIS: │
│ > iisreset /restart │
│ │
│ View deployment log: │
│ > type deployment.log │
│ │
│ Check npm dependencies: │
│ > npm install │
│ │
│ Build frontend + backend: │
│ > npm run build │
│ │
│ Clean and rebuild: │
│ > npm cache clean --force && rmdir node_modules /s /q && npm install │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 🚨 TROUBLESHOOTING ───────────────────────────────────────────────────────┐
│ │
│ PROBLEM: Node.js app not responding │
│ SOLUTION: │
│ taskkill /F /IM node.exe │
│ iisreset /restart │
│ │
│ PROBLEM: Module not found errors │
│ SOLUTION: │
│ npm run plesk-build │
│ │
│ PROBLEM: 404 on page refresh (React routing) │
│ SOLUTION: │
│ Check dist/public/web.config exists │
│ Run: npm run build │
│ │
│ PROBLEM: Cannot execute PowerShell script │
│ SOLUTION: │
│ Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser │
│ │
│ PROBLEM: CORS errors (cross-origin requests fail) │
│ SOLUTION: │
│ Check Plesk: FRONTEND_URL environment variable │
│ Run: iisreset /restart │
│ │
│ PROBLEM: Build fails │
│ SOLUTION: │
│ npm run plesk-build-prod │
│ Or manually: npm ci --production && npm run build │
│ │
│ For more troubleshooting, see: PLESK_DEPLOYMENT.md │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 📊 FILE STRUCTURE AFTER BUILD ────────────────────────────────────────────┐
│ │
│ dist/ │
│ ├── index.js ........................ Backend entry point (Node.js) │
│ └── public/ ......................... Frontend static files │
│ ├── index.html .................. React app │
│ ├── web.config .................. Frontend IIS config │
│ └── assets/ ..................... CSS, JS, images │
│ │
│ web.config ........................... Backend IIS config │
│ plesk-deploy.bat ..................... Batch script │
│ plesk-deploy.ps1 ..................... PowerShell script │
│ deployment.log ....................... Deployment log (generated) │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ ✅ VERIFICATION CHECKLIST ─────────────────────────────────────────────────┐
│ │
│ After deployment, verify: │
│ │
│ ☐ Node.js process running │
│ > tasklist | findstr node │
│ │
│ ☐ IIS running │
│ > iisreset /status │
│ │
│ ☐ Backend accessible │
│ Browser: https://yourdomain.com/api/sessions │
│ │
│ ☐ Frontend loads │
│ Browser: https://yourdomain.com/ │
│ │
│ ☐ No errors in logs │
│ Check: deployment.log │
│ Check: %SystemDrive%\iisnode\ │
│ │
│ ☐ Database connection working │
│ Check: Browser console for API errors │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 📞 DOCUMENTATION ─────────────────────────────────────────────────────────┐
│ │
│ Main Documentation: │
│ • PLESK_DEPLOYMENT.md ..................... Full setup guide │
│ • PLESK_COMMANDS_REFERENCE.txt ........... Command reference │
│ • SUBDOMAIN_SETUP.md ....................... Subdomain config │
│ • DEPLOYMENT_SUMMARY.md ................... This summary │
│ │
│ For more details, read these files in order: │
│ 1. DEPLOYMENT_SUMMARY.md (overview) │
│ 2. PLESK_DEPLOYMENT.md (step-by-step) │
│ 3. PLESK_COMMANDS_REFERENCE.txt (commands) │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 💡 PRO TIPS ──────────────────────────────────────────────────────────────┐
│ │
│ • Test locally first: │
│ npm run dev │
│ │
│ • Check syntax before deploy: │
│ npm run check │
│ │
│ • Monitor in real-time: │
│ Get-Process node | Format-Table -AutoSize -Refresh (PowerShell) │
│ │
│ • Keep backups: │
│ xcopy dist dist.backup /E /I /Y │
│ │
│ • Use git before major changes: │
│ git status │
│ git pull origin main │
│ │
│ • Schedule automatic deployments: │
│ Windows Task Scheduler + plesk-deploy.ps1 │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
┌─ 🔐 SECURITY REMINDERS ────────────────────────────────────────────────────┐
│ │
│ • Store secrets in Plesk Environment Variables, not in .env file │
│ • Enable HTTPS/SSL on your domain │
│ • Use strong SESSION_SECRET (random string) │
│ • Keep Node.js and npm updated │
│ • Review CORS settings in environment │
│ • Regular backups of database and code │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
🎉 Ready to Deploy! 🎉
For questions, check PLESK_DEPLOYMENT.md
For commands, check PLESK_COMMANDS_REFERENCE.txt