macOS installation

Choose arm64 for Apple Silicon or 64 for Intel. Open the DMG, drag the app into Applications and launch it there. For a portable ZIP, extract everything, run chmod +x v2rayN in its folder, then ./v2rayN as a normal user.

The official installation instructions describe unsigned DMGs that may trigger a “damaged” message. After checking the official download and its signature, the command below clears extended attributes on this specific application before reopening it. It does not repair an incomplete download.

macOS · TerminalCopy
xattr -cr /Applications/v2rayN.app
macOS downloadsVerify the download

Make the first connection

Copy your own share link and import it through the menu or Ctrl+V outside text fields. For a subscription, save its URL in a group and update it. Activate a profile and enable automatic system proxy.

Visit your destination in a browser. If it fails, check core startup and logs. Importing a profile or completing a latency test does not itself configure browser traffic.

Subscription workflowConnection troubleshooting

Upgrade, back up and restore

Use Backup and restore to save guiConfigs as a ZIP before upgrading; explicitly use the .zip extension on non-Windows systems. Record client/core versions and architecture.

For portable use, extract the new package to a new folder and restore the backup there. Keep the old folder until connections and subscriptions work. Upgrade installed editions with the same platform and architecture; uninstalling the app does not necessarily remove user data. Restore restarts the client; reopen manually if needed.

Version 7.25.6 changes core compatibility and generated configuration, so check the active profile, routing, DNS, subscriptions and TUN after upgrading.

Current release notesBackup reference