Aug 27, 2026 · Troubleshooting · About 8 min read

v2rayN Crashes on Startup? Fix .NET Desktop Runtime, Folder Permissions, and Missing Core Files

Does v2rayN close immediately or do nothing when you double-click it? Common causes include a missing runtime, folder permissions, or blocked core files. Follow these checks and fixes in order.

At a glance

For Windows users who can’t open v2rayN after a first-time installation or upgrade. First check whether the main process is still running, then use any startup message to identify the required runtime. Test a clean extraction in a separate folder to rule out permission issues and old settings. If the failure occurs only when selecting a node, check the core logs instead of repeatedly reinstalling the main program.

Tell a closed app from a core startup failure

App launchRuntime loadingConfiguration accessInterface initializationCore startup

This sequence helps identify what to check; not every version starts the core at the same point. After double-clicking, check the taskbar notification area and expand hidden icons if needed. If you can open the main window from the tray, the app is still running. Check whether the window is minimized before installing a runtime.

Check the .NET Desktop Runtime against the error message

Don’t rely on the installed-apps list to see whether you have “.NET.” Windows desktop builds that depend on a shared runtime may require Microsoft.WindowsDesktop.App. Installing only the standard .NET Runtime or an older .NET Framework version won’t meet that requirement. Self-contained builds usually include the runtime they need, so check which type of build you downloaded before installing anything.

You must install or update .NET to run this application.

Cause: The app can’t find a compatible shared runtime. Fix: Note the Framework, version, and Architecture shown in the message. If the framework is Microsoft.WindowsDesktop.App, install the matching .NET Desktop Runtime version and architecture from Microsoft’s official source.

Only one usage of each socket address (protocol/network address/port) is normally permitted.

Cause: If this message appears in the core’s listener log, the local listening address or port may already be in use. Fix: Use the port shown in the log to find the process using it. If it’s an older duplicate instance, exit it normally. Don’t mistake this core error for a missing runtime.

For example, if the message requires Microsoft.WindowsDesktop.App 8.0.0 on x64, check that the x64 .NET Desktop Runtime 8.0 series is installed. You usually don’t need the original 8.0.0 patch, but installing only the 9.0 series won’t necessarily replace 8.0. Use the architecture shown in the app’s message; don’t assume the app is x64 just because Windows is 64-bit.

dotnet --list-runtimes

Run this command in a terminal. Look for a line starting with Microsoft.WindowsDesktop.App and check the installation path on the right. The command only lists runtimes visible to the dotnet executable it invokes. If runtimes for multiple architectures are installed, the list can’t confirm what’s available for another architecture. If the command isn’t found, check Settings → Apps → Installed apps for the Desktop Runtime, then restart the client to test.

Extract a fresh copy to rule out folder permissions and old settings

  1. Keep the old folder

    Exit any running instance normally first. If the tray menu still opens, use it to quit, then check Task Manager to confirm the main process has closed. Back up the old program folder and its configuration without overwriting the originals. Subscription URLs and node credentials may be stored there, so don’t upload the entire folder when asking for help.

  2. Extract all files

    In File Explorer, right-click the archive and select Extract All. Choose a local folder you can write to, such as %LOCALAPPDATA%\v2rayN-test. Don’t run the app from the archive preview or extract only v2rayN.exe.

  3. Launch without administrator privileges

    Double-click the main program in the new folder. Don’t use an old shortcut or copy over the old configuration. If the log reports a write failure, try creating and deleting an empty text file in the folder named in the error. Being able to write to the test folder doesn’t prove you can write to a different folder mentioned in the log.

  4. Restore settings in stages

    Once the fresh copy opens, exit and launch it again to confirm it can save basic settings. Then import just one working node or subscription to test it. Restore custom routing and other settings last. Restart after restoring each type of setting; if the problem returns, remove the most recently added item first.

To separate permission issues from upgrade problems, start with a clean extraction of the original build with the same version and architecture. If only a newer build starts successfully, that proves the newer build runs from a fresh folder, but it doesn’t prove the old version failed only because of folder permissions. If the app opens only as an administrator, check the error log for the exact write location. Don’t treat running it as an administrator every time as a fix.

Check core files and listening ports when the main window opens

netstat -ano -p tcp | findstr ":10808"

This command may also match remote addresses or longer port strings, so don’t assume every result indicates a conflict. Once you identify the process using the port, exit any duplicate instance normally. If the port belongs to an app you still need, check the local listening port in v2rayN under Settings → Parameter Settings. If you’ve configured proxy settings manually in a browser or other app, update the port there too.

Three common questions when v2rayN still won’t open

The shortcut does nothing, but the app opens when you launch it directly?

Right-click the old shortcut and select Properties → Shortcut. Check whether Target still points to the previous location of v2rayN.exe, then check Start in. If the target no longer exists, create a new shortcut from the current main program.

Installed the runtime, but still getting the same message?

Check the framework name and architecture in the message again, and confirm you installed the Desktop Runtime rather than the standard Runtime. Also make sure you’re launching the newly extracted copy, not an older version pinned to the taskbar. Different versions may require different runtime series.

No window or error message—what details should you include when asking for help?

Include your Windows version, system type, build filename, and the time you double-clicked the app. If Event Viewer has a matching entry, include the faulting application name, exception code, and faulting module. Note whether a clean copy opens, if you’ve tested one. Before sharing, remove personal folder names, subscription URLs, and node credentials.

Client Downloads