Skip to content
DocsErrorsHandling "Build Directory Not Writeable" Error in Next.js

Handling "Build Directory Not Writeable" Error in Next.js

This document explains the "Build Directory Not Writeable" error in Next.js and provides a solution to resolve this issue.

Why This Error Occurred

The "Build Directory Not Writeable" error usually occurs when the file system does not permit writing to the designated directory. A common scenario for this error is when you initiate a custom server in development mode on a production server.

These production servers often disallow writing to the filesystem after your application is built, causing this error.

Possible Ways to Fix It

If you're deploying a custom server with a server file (let's assume it's named server.js), you should modify the scripts key in your package.json to the following:

package.json
{
  "scripts": {
    "dev": "node server.js",
    "build": "next build",
    "start": "NODE_ENV=production node server.js"
  }
}

Ensure that your custom server starts Next.js in production mode when NODE_ENV is set to production:

server.js
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev })