{"type":"doc","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Looking to deploy your Next.js application with enhanced process management and the robustness of IIS? This guide will walk you through setting up your Next.js app to run with PM2, while using IIS as a reverse proxy."}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 1: Prepare Your Next.js Application"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Create your Next.js application if you haven't already"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Add a "},{"type":"text","marks":[{"type":"code"}],"text":"server.js"},{"type":"text","text":" file to your project root with the following content:"}]}]}]},{"type":"codeBlock","attrs":{"language":null},"content":[{"type":"text","text":"const { createServer } = require('http')\nconst { parse } = require('url')\nconst next = require('next')\n\nconst dev = process.env.NODE_ENV !== 'production'\nconst port = process.env.PORT || 3000\nconst app = next({ dev })\nconst handle = app.getRequestHandler()\n\napp.prepare().then(() => {\n createServer((req, res) => {\n const parsedUrl = parse(req.url, true)\n const { pathname, query } = parsedUrl\n\n if (pathname === '/a') {\n app.render(req, res, '/a', query)\n } else if (pathname === '/b') {\n app.render(req, res, '/b', query)\n } else {\n handle(req, res, parsedUrl)\n }\n })\n .once('error', err => {\n console.error(err)\n process.exit(1)\n })\n .listen(port, err => {\n if (err) throw err\n console.log(`> Ready on http://localhost:${port}`)\n })\n})"}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 2: Install and Configure PM2"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Install PM2 globally: "},{"type":"text","marks":[{"type":"code"}],"text":"npm install pm2 -g"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Create an "},{"type":"text","marks":[{"type":"code"}],"text":"ecosystem.config.js"},{"type":"text","text":" file in your project root:"}]}]}]},{"type":"codeBlock","attrs":{"language":null},"content":[{"type":"text","text":"module.exports = {\n apps: [\n {\n name: 'my-nextjs-app',\n script: 'server.js',\n max_memory_restart: '16G',\n env: {\n PORT: 4001\n // Add any additional environment variables here\n }\n }\n ]\n}"}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 3: Build and Run Your Next.js App with PM2"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Build your Next.js app: "},{"type":"text","marks":[{"type":"code"}],"text":"npm run build"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Start your app with PM2: "},{"type":"text","marks":[{"type":"code"}],"text":"pm2 start ecosystem.config.js"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Monitor your app: "},{"type":"text","marks":[{"type":"code"}],"text":"pm2 monit"}]}]}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 4: Prepare IIS"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Install the following modules:"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"iisnode"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"URL Rewrite"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"Application Request Routing (ARR)"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Restart your computer after installation"}]}]}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 5: Configure IIS as a Reverse Proxy"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Open IIS Manager"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Add a "},{"type":"text","marks":[{"type":"bold"}],"text":"new website"},{"type":"text","text":":"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Set a site name"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Set the "},{"type":"text","marks":[{"type":"bold"}],"text":"physical path"},{"type":"text","text":" to your Next.js app directory"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Configure \""},{"type":"text","marks":[{"type":"bold"}],"text":"Connect as"},{"type":"text","text":"\" with appropriate user credentials with "},{"type":"text","marks":[{"type":"bold"}],"text":"read/write permission"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Set an available "},{"type":"text","marks":[{"type":"bold"}],"text":"IP address"},{"type":"text","text":" and "},{"type":"text","marks":[{"type":"bold"}],"text":"port"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Add "},{"type":"text","marks":[{"type":"bold"}],"text":"Reverse Proxy rules"},{"type":"text","text":":"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Select your new website"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Open "},{"type":"text","marks":[{"type":"bold"}],"text":"URL Rewrite"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Click "},{"type":"text","marks":[{"type":"bold"}],"text":"Reverse Proxy "},{"type":"text","text":"then "},{"type":"text","marks":[{"type":"bold"}],"text":"add rules"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Put the "},{"type":"text","marks":[{"type":"bold"}],"text":"host name"},{"type":"text","text":" and "},{"type":"text","marks":[{"type":"bold"}],"text":"port"},{"type":"text","text":" of your "},{"type":"text","marks":[{"type":"bold"}],"text":"next.js app"},{"type":"text","text":" running using "},{"type":"text","marks":[{"type":"bold"}],"text":"pm2"},{"type":"text","text":" ex. "},{"type":"text","marks":[{"type":"code"}],"text":"locahost:4001"}]}]}]}]}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 6: Disable IIS Caching (Important for Next-auth)"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Select your website in IIS Manager"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Open "},{"type":"text","marks":[{"type":"bold"}],"text":"Output Caching"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Click \""},{"type":"text","marks":[{"type":"bold"}],"text":"Edit Feature Settings"},{"type":"text","text":"\""}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Uncheck \""},{"type":"text","marks":[{"type":"bold"}],"text":"Enable cache"},{"type":"text","text":"\" and \""},{"type":"text","marks":[{"type":"bold"}],"text":"Enable kernel cache"},{"type":"text","text":"\""}]}]}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 7: Configure web.config"}]},{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"The "},{"type":"text","marks":[{"type":"bold"}],"text":"adding of reverse proxy rules"},{"type":"text","text":" and "},{"type":"text","marks":[{"type":"bold"}],"text":"disabling the cache in IIS"},{"type":"text","text":" will generate a "},{"type":"text","marks":[{"type":"code"}],"text":"web.config"},{"type":"text","text":" file. You can put this "},{"type":"text","marks":[{"type":"code"}],"text":"web.config"},{"type":"text","text":" at the root directory of your Next.js app instead of "},{"type":"text","marks":[{"type":"bold"}],"text":"adding reverse proxy rules"},{"type":"text","text":" and "},{"type":"text","marks":[{"type":"bold"}],"text":"disabling the cache"},{"type":"text","text":" manually.⁠"}]},{"type":"codeBlock","attrs":{"language":null},"content":[{"type":"text","text":"\n\n \n \n \n \n \n \n \n \n \n \n \n"}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Step 8: Start Your Application"}]},{"type":"bulletList","attrs":{"tight":true},"content":[{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Ensure your Next.js app is running with PM2"}]}]},{"type":"listItem","content":[{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Start or restart your IIS website"}]}]}]},{"type":"heading","attrs":{"textAlign":"left","level":2},"content":[{"type":"text","text":"Conclusion"}]},{"type":"paragraph","attrs":{"textAlign":"left"},"content":[{"type":"text","text":"Congratulations! You've successfully set up your "},{"type":"text","marks":[{"type":"bold"}],"text":"Next.js application"},{"type":"text","text":" to run with "},{"type":"text","marks":[{"type":"bold"}],"text":"PM2"},{"type":"text","text":" for improved process management, while using "},{"type":"text","marks":[{"type":"bold"}],"text":"IIS"},{"type":"text","text":" as a "},{"type":"text","marks":[{"type":"bold"}],"text":"reverse proxy"},{"type":"text","text":". This configuration provides the benefits of Node.js application management with "},{"type":"text","marks":[{"type":"bold"}],"text":"PM2"},{"type":"text","text":", combined with the "},{"type":"text","marks":[{"type":"bold"}],"text":"robustness"},{"type":"text","text":" and "},{"type":"text","marks":[{"type":"bold"}],"text":"additional features"},{"type":"text","text":" of "},{"type":"text","marks":[{"type":"bold"}],"text":"IIS"},{"type":"text","text":" for hosting."}]}]}