Skip to content

Troubleshooting

CyberGems edited this page Sep 25, 2026 · 10 revisions

Troubleshooting

The development server says port 3000 is already in use

The browser command uses port 3000 with strict port selection and will fail if that port is occupied. The desktop development helper reuses a server it finds at 127.0.0.1:3000. If that server is an old or unrelated Vite process, stop it and restart CyberFiles so the desktop app connects to the intended frontend.

A folder or drive cannot be opened in the browser preview

The browser preview is only for UI testing. It cannot enumerate the computer like This PC in the desktop app. Folder selection depends on browser support for the File System Access API, a secure context, a user gesture, and browser permission. Use the Windows desktop app to test native drive and Shell behavior.

Delete is unavailable on a network share or mapped drive

This is an intentional current restriction. Native Recycle Bin deletion accepts only supported local fixed or removable drives. UNC paths and mapped network drives are rejected. See File Operations and Safety.

A file operation fails or reports partial completion

CyberFiles reports per-item failures for copy, move, and batch rename. Check the reported paths and reason, then retry only the items that did not complete. Symbolic links and unsupported item types are not copied. A folder cannot be copied or moved inside itself. See File Operations and Safety.

The Recycle Bin status is unavailable or looks different from the emptying result

The status indicator queries supported local fixed and removable drives, and may show unavailable if those queries fail or no eligible drives are present. Empty Recycle Bin uses the Windows Shell's all-drives behavior. Its scope can therefore exceed the displayed status total.

The global shortcut does not register

The shortcut is available only in the desktop app. Another application may already own the chosen key combination. Choose a different combination in Settings, or disable the shortcut.

The build command did not create an installer

npm run build:desktop creates only a debug executable. Use npm run build:installer for the distributable NSIS package, and confirm the Tauri Windows prerequisites and NSIS are installed. Public builds are available on the GitHub Releases page.

Clone this wiki locally