juicedata/juicefs · error

Failed to start juicefs service by 'net use': %s, output: %s

Error message

Failed to start juicefs service by 'net use': %s, output: %s

What it means

Returned by the Windows mount path when starting the JuiceFS service via the winfsp launcher ('net use' style start) fails. It wraps the launcher's exit error and its combined output so the user can see why the service did not come up.

Source

Thrown at pkg/winfsp/winfs.go:1479

		// or the Explorer will not be able to disconnect the volume.
		cmd := exec.Command(winfspLauncher, "start", winfspServiceName, alias, alias, mountpoint)
		cmd.Dir = winFspBinPath
		logger.Debugf("Mounting command(using launchctl): %s", cmd.String())

		out, err := cmd.CombinedOutput()
		if err != nil {
			return fmt.Errorf("Failed to mount juicefs as system service: %s, output: %s", err, string(out))
		}

		if !checkIfMountProcessReady(mountpoint, 25) {
			return fmt.Errorf("Mount command succeeded, but the mountpoint %s did not become ready in %d seconds, please check the juicefs logs for more information.", mountpoint, 25)
		}
	} else {
		logger.Debugf("Trying to start juicefs service by 'net use' command.")
		cmd := exec.Command("net", "use", mountpoint, fmt.Sprintf("\\\\%s\\%s", winfspServiceName, alias), "/Y")
		out, err := cmd.CombinedOutput()
		if err != nil {
			return fmt.Errorf("Failed to start juicefs service by 'net use': %s, output: %s", err, string(out))
		}
	}

	logger.Info("Juicefs mount process started successfully.")

	return nil
}

View on GitHub (pinned to c9a67b23e8)

Solutions

1. Check that WinFsp is installed and the winfsp launcher path is correct
2. Review the captured command output for service startup errors and retry the mount

When it happens

Trigger: Thrown at pkg/winfsp/winfs.go:1479 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of juicedata/juicefs@c9a67b23e8 (2026-09-06). Data as JSON: /api/errors/90fba7c433c12c95. Report an issue: GitHub.