Skip to content

Latest commit

 

History

History
31 lines (24 loc) · 1.8 KB

troubleshooting.md

File metadata and controls

31 lines (24 loc) · 1.8 KB

Troubleshooting installation

If you have trouble installing better-sqlite3, follow this checklist:

  1. Make sure you're using nodejs v8.9.4 or later

  2. Make sure you have node-gyp globally installed, including all of its dependencies. On Windows you may need to configure some things manually.

  3. If you're using Electron, try running electron-rebuild

  4. If you're using Windows, follow these steps. Do them in this order, and don't skip steps.

    1. Install the latest of node 8, node 10, or node 12. Earlier versions of node (like 10.2.x) will not compile.
    2. Start an Admin PowerShell: Right-click the start icon, then pick Windows PowerShell (Admin)
    3. Install both vs2015 and vs2017 libraries. Each line will take ~5-10 minutes.
      npm install --global --production --vs2015 --add-python-to-path windows-build-tools
      npm install --global --production --add-python-to-path windows-build-tools node-gyp
    4. In your project, make sure you're not fighting with old build configurations. Delete both
      • your %USERPROFILE%/.node-gyp and
      • your project's node_modules directories.
    5. Set up %USERPROFILE%/.npmrc correctly:
      msvs_version=2015
      python=python2.7
      (where %USERPROFILE% is your home directory).
    6. Run npm install or yarn install

If none of these solved your problem, try browsing previous issues or open a new issue.