# Install ioctl with Homebrew

Command-line interface for interacting with the IoTeX blockchain. Version 2.4.3 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:ioctl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ioctl
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:ioctl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ioctl>
- **Version:** 2.4.3
- **Source summary:** Command-line interface for interacting with the IoTeX blockchain
- **Homepage:** <https://docs.iotex.io/>
- **Repository:** <https://github.com/iotexproject/iotex-core>
- **Upstream docs:** <https://docs.iotex.io/>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/iotexproject/iotex-core/archive/refs/tags/v2.4.3.tar.gz>
- **Last updated:** 2026-07-07T07:00:48Z
- **Generated:** 2026-07-10T07:20:53+00:00

## Executables

- ioctl (cli)
- ioctl (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-10
- Package-manager version: 2.4.3
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://github.com/iotexproject/iotex-core
- Upstream latest detected: v2.4.3 (current)
## Project history and usage

ioctl is the command-line client for interacting with the IoTeX blockchain. It is built from the iotex-core repository and gives developers, node operators, and wallet users a terminal interface for installation checks, endpoint configuration, accounts, actions, queries, smart contracts, staking, tokens, ioID identities, W3bstream, DID, and JWT-related workflows.

### Project history

ioctl's history is coupled to iotex-core, the Go implementation of the IoTeX blockchain protocol. The IoTeX docs show `make ioctl` as the source-build path and the GitHub repository describes iotex-core as the official implementation of the protocol.

The official reference includes a version example built in April 2019, which places the CLI in the early public mainnet era of IoTeX tooling. IoTeX project updates from that period discuss Mainnet Alpha launch preparation and delegate operations, the same operational context in which a chain CLI is needed.

Over time, ioctl became a documented developer and operator tool rather than only a build artifact. The docs include install scripts, Homebrew installation, endpoint setup for mainnet and testnet gateways, update commands, and a reference tree covering the core blockchain interaction surface.

### Adoption history

ioctl adoption tracks IoTeX ecosystem participation: developers use it to configure endpoints and interact with the chain, wallet users can create and inspect accounts, and delegates or node operators rely on command-line workflows around releases and network operations. The Homebrew formula makes the CLI available as a standard macOS package.

### How it is used

Users install ioctl with the IoTeX install script, Homebrew, or a source build from iotex-core, then configure an endpoint such as the IoTeX mainnet or testnet gateway. The reference documents `ioctl config`, `ioctl update`, `ioctl version`, and command groups for accounts, queries, actions, smart contracts, staking, tokens, and identity-related features.

### Why package nerds care

ioctl is a good example of a blockchain project CLI packaged separately from the node daemon but built from the same monorepo. For package maintainers, that means versioning, release assets, install scripts, and node/network compatibility all matter more than a normal standalone utility's flags.

The name is also package-nerd bait: it collides conceptually with Unix `ioctl(2)`, but in Homebrew it is the IoTeX client executable. Context from docs and repository metadata is essential to avoid misclassifying it as a low-level Unix system tool.

### Timeline

- 2018-2019: IoTeX project updates describe Mainnet Alpha preparation and launch-era network operations.
- 2019-04: IoTeX docs show `ioctl version` output from client and server builds around Mainnet Alpha timing.
- 2019 onward: Documentation organizes ioctl as the command-line client for accounts, actions, queries, smart contracts, staking, tokens, and identities.
- Package-manager era: Homebrew provides the `ioctl` formula for installing the IoTeX CLI.
- 2026: iotex-core release notes continue to ship protocol releases from the same repository that contains the CLI.

### Related projects

- iotex-core is the source repository and blockchain implementation that contains ioctl.
- iotex-bootstrap documents node and network operation around iotex-core releases.
- IoTeX docs, IoTeXscan, staking tools, ioID, and W3bstream are adjacent ecosystem surfaces referenced from the ioctl documentation.

### Sources

- <https://community.iotex.io/t/official-iotex-project-updates/695>
- <https://docs.iotex.io/blockchain/build/reference-docs/ioctl-client>
- <https://docs.iotex.io/blockchain/build/web3-development/ioctl-cli>
- <https://docs.iotex.io/blockchain/build/web3-development/ioctl-cli/installation>
- <https://formulae.brew.sh/formula/ioctl>
- <https://github.com/iotexproject/iotex-core>
- <https://github.com/iotexproject/iotex-core/releases>


## Security Notes

No matching local secret-handling manifest was found for ioctl. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/ioctl/default/config.default

## Credential files

- Unix: ~/.config/ioctl/default
## Source Database Details

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


## Related links

- [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.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [bcoin](https://www.automicvault.com/pkg/brew/bcoin/) - Shares av.db curated category or tags: blockchain, cli, data.
- [burrow](https://www.automicvault.com/pkg/brew/burrow/) - Shares av.db curated category or tags: cli, data, go.
- [cayley](https://www.automicvault.com/pkg/brew/cayley/) - Shares av.db curated category or tags: cli, data, go.
- [clickhouse-sql-parser](https://www.automicvault.com/pkg/brew/clickhouse-sql-parser/) - Shares av.db curated category or tags: cli, data, go.
- [conduit](https://www.automicvault.com/pkg/brew/conduit/) - Shares av.db curated category or tags: cli, data, go.
- [cql](https://www.automicvault.com/pkg/brew/cql/) - Shares av.db curated category or tags: blockchain, cli, data.
- [iceberg-cli](https://www.automicvault.com/pkg/brew/iceberg-cli/) - Shares av.db curated category or tags: cli, data, go.
- [kaf](https://www.automicvault.com/pkg/brew/kaf/) - Shares av.db curated category or tags: cli, data, go.
- [astra](https://www.automicvault.com/pkg/brew/astra/) - Local package facts share a topical domain. Shared terms: cli, command-line, data, interface, line.
- [cubejs-cli](https://www.automicvault.com/pkg/brew/cubejs-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, data, interface, line.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
