Project Settings

Configure individual project settings and behavior.

Accessing Settings

Right-click on any project in the sidebar and select "Settings" to open the configuration panel.

Node Version

Specify which Node version to use for this project:

• Auto: Use the bundled Node.js v20.18.0

• Specific Version: Choose any downloaded version (e.g., v18, v22, v25)

• .nvmrc: Read from project's .nvmrc file

Download additional Node.js versions from Settings → Versions. Versions are stored in ~/.nodev/versions/ and available to all projects.

The server console displays the actual running version by executing node -v on the configured binary. This confirms which version is active.

Port Configuration

Set which port your development server uses:

• Auto: Let Nodev detect from framework config

• Custom: Specify a port number (1025-65535)

• Increment: Auto-increment if port is busy

Nodev automatically switches ports if your preferred port is in use, so you never have to manually resolve port conflicts. This is one of the key benefits of using Nodev.

Custom Dev Command

Override the default development command:

• Leave empty to use the default (npm run dev, yarn dev, etc.)

• Enter a custom command like npm start or node server.js

• Include any necessary arguments or flags

Domain Assignment

Assign a custom .nodev domain to your project:

• Enter a name like myapp for myapp.nodev

• Domains must be unique across all projects

• Access your project at http://yourdomain.nodev

• Perfect for OAuth callbacks and CORS

Use meaningful domain names that match your project names or purposes. This makes it easier to remember URLs.

Auto-Start

Configure when this project automatically starts:

• Never: Only start manually

• On Launch: Start when Nodev opens

• On Session Restore: Start when restoring previous session