Ansible role: macOS Dock

Configure the macOS Dock including which items appear in it and in what order.

Requirements

• Ansible >= 2.1
• macOS 10.13, or 10.11

Role variables

# Whether the Dock automatically hides.
macos_dock_autohide: true

# The size of icons in the Dock.
macos_dock_icon_size: 60

# The orientation of the Dock.
# "left | "bottom" | "right"
macos_dock_orientation: "bottom"

# A list of apps that you wish to appear in the Dock and in what order.
# The Dock item list will not be altered if this list is left empty.
# 
# Supported directories for apps:
# - /Applications
# - /Users/[username]/Applications
# 
# Notes:
# - List order affects order in Dock.
# - Use absolute paths to files.
# - {{ ansible_user_id }} returns the username of the *target* system
#   (you must surround the path in quotes to use this).
#
# Examples:
# - /Applications/System Preferences.app
# - /Applications/Utilities/Activity Monitor.app
# - "/Users/{{ ansible_user_id }}/Applications/Firefox.app"
macos_dock_apps: []

# Max directory depth when checking 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

Author information

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