Ansible Role: macOS Dock

This role helps you set up the macOS Dock, including which apps show up and their order.

Requirements

• Ansible version 2.1 or higher
• macOS version 10.13 or 10.11

Role Variables

# Should the Dock hide automatically?
macos_dock_autohide: true

# Size of the icons in the Dock.
macos_dock_icon_size: 60

# Position of the Dock.
# Options: "left", "bottom", "right"
macos_dock_orientation: "bottom"

# List of apps you want to show in the Dock, in order.
# If you leave this empty, the Dock will not change.
#
# Where to find the apps:
# - /Applications
# - /Users/[username]/Applications
#
# Notes:
# - The order of the list determines the order in the Dock.
# - Always use full paths to the app files.
# - {{ ansible_user_id }} gives the username of the system you are working on.
#   (Make sure to put this path in quotes).
#
# Examples:
# - /Applications/System Preferences.app
# - /Applications/Utilities/Activity Monitor.app
# - "/Users/{{ ansible_user_id }}/Applications/Firefox.app"
macos_dock_apps: []

# Maximum number of folders deep to search for installed apps.
macos_dock_apps_dir_maxdepth: 2

Dependencies

• danbohea.homebrew

Example Playbook

- hosts: all

  vars:
    macos_dock_apps:
      - /Applications/Utilities/Activity Monitor.app
      - /Applications/System Preferences.app
      - "/Users/{{ ansible_user_id }}/Applications/Firefox.app"

  roles:
    - role: ansible-role-macos-dock

License

MIT License

Author Information

This role was created by Dan Bohea mainly for use with Macsible.