homebrew-cask/doc/reporting_bugs/a_cask_fails_to_install.md

1.8 KiB
Raw Blame History

Go back

A cask fails to install

Pick the issue closest to your case, and follow the links.


curl error:

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:

  1. App vendor or file in their server is down.
  2. Cask is outdated.
  3. A problem in your setup or connection.

Continue to the fix


Permission denied error:

If the error output includes something like

Error: Permission denied - (/usr/local/Caskroom/someapp/0.1/Someapp.app, /Applications/Someapp.app)

the problem isnt with Homebrew-Cask itself, but some permissions on your system.

Continue to the fix


sha256 mismatch error

If the error output includes something like

Error: sha256 mismatch
Expected: 3dbc6c2205af35db5370c7642b9a2b833668880569b9c64a7f5a670bf9911130
Actual: 526d747d99a93b760f7965e25a57ed61de9b93d566a0ba0c5f1c7e83719b20fd

Either your download was incomplete/corrupt or the cask is outdated.

Continue to the fix


source is not there error

If the error output includes something like

Error: It seems the App source is not there: '/usr/local/Caskroom/…'

the directory structure inside the apps archive changed in some way. It must be fixed in Homebrew-Cask.

Continue to the fix


Unlisted reason

If your issue isnt listed here, go back and pick My problem isnt listed.