Sail Knowledgebase

Sail: Command not Found Error

You will see this error on a system, where the Sail CLI is not installed, or installed incorrectly. This means that the sail binary is missing, or not linked properly.

If you like Sail, don't forget to give us a star on GitHub!

Install Sail

The most common cause for the "sail: command not found" error, is that the Sail CLI software is not installed. The easiest way to install Sail is by using the Homebrew package manager:

brew install sail

For other installation options check out our full article on installing Sail.

If the Sail CLI software is installed but you're still seeing the "command not found" error, you should try re-installing Sail, or re-creating the symbolic link to the Sail executable.

Reinstall Sail CLI

If you installed Sail with Homebrew, the easiest way to uninstall it is by using:

brew uninstall sail

Then run a fresh installation with:

brew install sail

If you do not wish to use the Homebrew package manager, there are other installation options, with corresponding uninstall methods.

Another common problem with the "command not found" error is when Sail is installed correctly, however the sail executable is not within the system PATH variable.

To solve this problem, you will need to locate the sail executable on your system and create a symbolic link to it in a directory which is in your PATH environment variable.

You can check the value of PATH with:

echo $PATH

Pick one of the directories (we usually recommend /usr/local/bin/) and create the symlink there:

ln -s /path/to/sail /usr/local/bin/sail

If you do not know where the sail executable is, you could try and search for it using the find command:

find / -name sail

After creating the symlink, you can verify the sail executable is linked correctly:

$ which sail

If you're still having trouble installing or configuring sail, check out our getting help section.