Symlinks in Windows

Nanobox launches your app and mounts your local codebase in a virtualized Linux environment. Creating symlinks in a codebase that mounted into a Linux environment, but actually resides in a Windows host filesystem can be tricky.

The Problem

Windows and Linux/Unix have completely separate implementations for creating symlinks. Symlinks created in a Linux environment will not be honored by Windows and vice versa.

The Solution

In order for symlinks created in Nanobox to work on a Windows host, there needs to be a "translation" layer. The mfsymlinks option available when creating a CIFS (the mounting technology used in Windows) provides this layer.

To enable mfsymlinks, use nanobox config to set netfs_mount_opts to mfsymlinks:

nanobox config set netfs_mount_opts mfsymlinks

Information is also available in the Configuring Nanobox documentation.

There are important things to know when using mfsymlinks.

If you create symlinks on Windows and then commit it into your source code, no other operating system will recognized it and it will cause issues for collaborators.

Don't commit symlinks to version control. All other collaborators need to create the symlinks themselves.

Reach out to and we'll try to help.