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.
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.
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
/usr/local/bin/sail
If you're still having trouble installing or configuring sail, check out our getting help section.