Examples of common errors and their solutions
If the error output includes something like
curl: (22) The requested URL returned error: 403 Forbidden
the problem was with the downloading itself (see how the error came from curl). Homebrew Cask itself is fine and the problem is generally one of:
- Software vendor or the file in their server is down.
- Cask is outdated.
- A problem in your setup or connection.
If the error output includes something like
Error: Permission denied - (/usr/local/Caskroom/someapp/0.1/Someapp.app, /Applications/Someapp.app)
the problem isn’t with Homebrew Cask itself, but some permissions on your system.
If the error output includes something like
Error: Checksum for Cask 'your-cask' does not match.
Expected: 3dbc6c2205af35db5370c7642b9a2b833668880569b9c64a7f5a670bf9911130
Actual: 526d747d99a93b760f7965e25a57ed61de9b93d566a0ba0c5f1c7e83719b20fd
either your download was incomplete/corrupt or the cask is outdated.
If the error output includes something like
It seems the App source '/usr/local/Caskroom/someapp/0.1/Someapp.app' is not there.
the directory structure inside the app’s archive changed in some way. It must be fixed in Homebrew Cask.
If the error output includes something like
Error: wrong number of arguments (1 for 4)
it’s likely the software you’re trying to install is incompatible with your macOS version.
If your issue isn’t listed here, go back and pick My problem isn’t listed.