On this page
homebrew_cask - Install/uninstall homebrew casks.
New in version 1.6.
Synopsis
- Manages Homebrew casks.
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.6
Parameters
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| accept_external_apps 
        bool
        
        (added in 2.5.0)
        | 
 | 
        allow external apps
        | 
| install_options 
        (added in 2.2)
        | 
        options flags to install a package
        aliases: options | |
| name 
        required
        | 
        name of cask to install/remove
        aliases: pkg, package, cask | |
| path | Default: 
        "/usr/local/bin"
        | 
        ':' separated list of paths to search for 'brew' executable.
        | 
| state | 
 | 
        state of the cask
        | 
| update_homebrew 
        bool
        
        (added in 2.2)
        | 
 | 
        update homebrew itself first. Note that  brew cask updateis a synonym forbrew update.aliases: update-brew | 
| upgrade 
        bool
        
        (added in 2.5.0)
        | 
 | 
        upgrade all casks (mutually exclusive with `upgrade_all`)
        | 
| upgrade_all 
        bool
        
        (added in 2.5.0)
        | 
 | 
        upgrade all casks (mutually exclusive with `upgrade`)
        | 
Examples
- homebrew_cask:
    name: alfred
    state: present
- homebrew_cask:
    name: alfred
    state: absent
- homebrew_cask:
    name: alfred
    state: present
    install_options: 'appdir=/Applications'
- homebrew_cask:
    name: alfred
    state: present
    install_options: 'debug,appdir=/Applications'
- homebrew_cask:
    name: alfred
    state: present
    allow_external_apps: True
- homebrew_cask:
    name: alfred
    state: absent
    install_options: force
- homebrew_cask:
    upgrade_all: true
- homebrew_cask:
    name: alfred
    state: upgraded
    install_options: force
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- Indrajit Raychaudhuri (@indrajitr)
- Daniel Jaouen (@danieljaouen)
- Enric Lluelles (@enriclluelles)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
 https://docs.ansible.com/ansible/2.6/modules/homebrew_cask_module.html