a_cask_fails_to_install.md

^{_{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 isn’t 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 app’s archive changed in some way. It must be fixed in Homebrew-Cask.

Continue to the fix

---

wrong number of arguments error

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.

Continue to the fix

---

Unlisted reason

If your issue isn’t listed here, go back and pick My problem isn’t listed.