ipfs/kubo · error

Mount isn't compatible with Windows yet

Error message

Mount isn't compatible with Windows yet

What it means

Platform guard for `ipfs mount` on Windows builds: core/commands/mount_windows.go is a build-tagged stub whose Run always returns this sentinel error, because FUSE mounting is not implemented on Windows. The command is unusable there by design, not a transient failure.

Source

Thrown at core/commands/mount_windows.go:16

package commands

import (
	"errors"

	cmds "github.com/ipfs/go-ipfs-cmds"
)

var MountCmd = &cmds.Command{
	Helptext: cmds.HelpText{
		Tagline:          "Not yet implemented on Windows.",
		ShortDescription: "Not yet implemented on Windows. :(",
	},

	Run: func(req *cmds.Request, res cmds.ResponseEmitter, env cmds.Environment) error {
		return errors.New("Mount isn't compatible with Windows yet")
	},
}

View on GitHub (pinned to 329838acdf)

Solutions

1. Run Kubo on Linux or macOS where FUSE mount is supported
2. Use the HTTP gateway or the RPC API to access files on Windows instead
3. Track upstream FUSE-on-Windows efforts (e.g. WinFsp support) for future availability

When it happens

Trigger: Thrown at core/commands/mount_windows.go:16 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ipfs/kubo@329838acdf (2026-09-03). Data as JSON: /api/errors/2827642b03f366a0. Report an issue: GitHub.