# Install dockutil with Homebrew, Nix

Tool for managing dock items. Version 3.1.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:dockutil
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dockutil
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#dockutil
```

  Evidence: nixpkgs package indexes: pkgs/by-name/do/dockutil/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:dockutil
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dockutil>
- **Version:** 3.1.3
- **Source summary:** Tool for managing dock items
- **Homepage:** <https://github.com/kcrawford/dockutil>
- **Repository:** <https://github.com/kcrawford/dockutil>
- **Upstream docs:** <https://github.com/kcrawford/dockutil#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/kcrawford/dockutil/archive/refs/tags/3.1.3.tar.gz>
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- dockutil (cli)
- dockutil (alias)

## Uses from macOS

- swift

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura

## Freshness

- Page generated: 2026-07-09
- Package-manager version: 3.1.3
- Local data: ok
- Upstream repository: https://github.com/kcrawford/dockutil
- Upstream latest detected: 3.1.3 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

dockutil is a long-running macOS command-line tool for adding, removing, moving, finding, and listing Dock items across one user, a specific Dock plist, or many home directories.

### Project history

The GitHub repository was created in July 2011, making dockutil one of the older macOS administration tools in this batch. Its README describes a CLI for managing Dock items including applications, folders, stacks, and URLs, with operations that can target the current user, a specified plist, a home directory, or all homes.

The changelog shows a long maintenance path through macOS changes: 1.1 improved path handling and restart behavior; 2.0 changed preference handling; 2.0.3 waited for Apple's first-login Dock setup; 2.0.5 fixed macOS 10.12 Dock restart behavior; 3.0.0 rewrote the tool in Swift for macOS 12.3 compatibility; and 3.1.x kept pace with Sonoma-era behavior.

### Adoption history

dockutil has been adopted mostly by Mac admins, imaging workflows, onboarding scripts, labs, and managed-device setups that need repeatable Dock state. Its `--allhomes`, plist targeting, and Default User Template examples are signs of fleet-management rather than casual end-user use.

The Homebrew formula remains active and reported stable version 3.1.3, 349 installs in the previous 30 days, and 3,249 installs in the previous year as of June 30, 2026. That is strong relative usage for a narrow macOS administration utility.

### How it is used

Common commands include `dockutil --add /Applications/TextEdit.app`, `dockutil --remove 'System Preferences' --allhomes`, `dockutil --move 'System Preferences' --position 2 --allhomes`, `dockutil --list`, and `dockutil --add '' --type spacer`. Options handle position, replacement, Dock section, folder view/display/sort behavior, `--no-restart`, `--allhomes`, and alternate home locations.

### Why package nerds care

dockutil is package-nerd significant because it gives admins a scriptable abstraction over a user-interface preference file that Apple changes over time. Its value is not glamour; it is preserving boring, repeatable Dock state across macOS releases and managed-user contexts.

### Timeline

- 2011: GitHub repository created.
- 2016: 2.0.x releases improved macOS compatibility and Dock restart behavior.
- 2022: 3.0.0 rewrote dockutil in Swift for macOS 12.3 compatibility.
- 2024: 3.1.3 fixed Dock restart behavior for macOS 14.4 compatibility.
- 2026: Homebrew formula API reports stable 3.1.3.

### Related projects

- dockutil is related to macOS Dock preferences, plist-based administration, first-login setup scripts, and Mac fleet-management tools such as Munki, Jamf, and other MDM/onboarding systems that call command-line helpers.
- It complements Apple's own Dock UI and defaults/plist tooling by exposing Dock-specific operations as stable CLI verbs.

### Sources

- <https://github.com/kcrawford/dockutil#readme>
- <https://api.github.com/repos/kcrawford/dockutil>
- <https://github.com/kcrawford/dockutil/releases/tag/2.0.5>
- <https://github.com/kcrawford/dockutil/releases/tag/3.0.0>
- <https://github.com/kcrawford/dockutil/releases/tag/3.1.3>
- <https://formulae.brew.sh/api/formula/dockutil.json>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** dockutil
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Requirements:** macos, xcode
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - dockutil: normalized package name match | nixpkgs package indexes: pkgs/by-name/do/dockutil/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [gmailctl](https://www.automicvault.com/pkg/brew/gmailctl/) - Shares av.db curated category or tags: automation, cli, configuration, productivity.
- [mackup](https://www.automicvault.com/pkg/brew/mackup/) - Shares av.db curated category or tags: cli, configuration, macos, productivity.
- [clipper](https://www.automicvault.com/pkg/brew/clipper/) - Shares av.db curated category or tags: cli, macos, productivity.
- [clippy](https://www.automicvault.com/pkg/brew/clippy/) - Shares av.db curated category or tags: cli, macos, productivity.
- [deck](https://www.automicvault.com/pkg/brew/deck/) - Shares av.db curated category or tags: automation, cli, productivity.
- [esniper](https://www.automicvault.com/pkg/brew/esniper/) - Shares av.db curated category or tags: automation, cli, productivity.
- [fcitx-remote-for-osx](https://www.automicvault.com/pkg/brew/fcitx-remote-for-osx/) - Shares av.db curated category or tags: cli, macos, productivity.
- [flexget](https://www.automicvault.com/pkg/brew/flexget/) - Shares av.db curated category or tags: automation, cli, productivity.

## Combined YAML source

View the package source record on GitHub. [combined/dockutil.yml](https://github.com/automic-vault/db/blob/main/combined/dockutil.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
