install

Additional install commands

macOS

Homebrewverified · 100%

brew install esptool

provider-native install command

overview

Package summary

ESP8266 and ESP32 serial bootloader utility

Project links

Homepage

Commands and aliases

esp_rfc2217_server
esp_rfc2217_server.py
espefuse
espefuse.py
espsecure
espsecure.py
esptool
esptool.py

history

Project history and usage

esptool is Espressif's Python-based, platform-independent serial utility for flashing, provisioning, and interacting with Espressif SoCs.

Project history

The official repository says esptool was initially created by Fredrik Ahlberg and later maintained by Angus Gratton; it is now supported by Espressif Systems and has received community improvements. That history reflects its move from community ESP8266 tooling into the vendor-supported flashing utility for the broader Espressif chip family.

Adoption history

As ESP8266 and ESP32 boards became common in hobbyist, IoT, and embedded development, esptool became the packaging target for the host-side operation everyone needed: moving firmware images onto chips over serial. Its distribution through Homebrew and many Linux package managers mirrors its role as infrastructure rather than as an application.

Espressif's documentation and repository describe a tool that spans flashing, provisioning, secure operations, eFuse management, remote serial ports, scripting, and chip-specific targets. That breadth made it a dependency under higher-level build systems as well as a direct CLI for firmware developers.

How it is used

The core workflow is `esptool write-flash`, where users provide a serial port and flash offsets plus one or more binary files. The documentation notes automatic chip detection for writing, serial transfer compression by default, erase behavior before writes, and options for skipping unchanged content or fast reflashing.

The Homebrew package also installs companion commands such as `espefuse`, `espsecure`, and `esp_rfc2217_server`, so package users get both everyday flashing and lower-level provisioning, security, and remote serial helpers from the same source package.

Why package nerds care

esptool is one of those packages that quietly defines an ecosystem: if an OS package set wants embedded developers to flash ESP boards without a vendor IDE, it ships esptool. Its Python implementation, cross-platform serial behavior, and explicit config-file search paths make it easy to package and script.

Timeline

2010s: Community-created esptool becomes the standard serial bootloader utility for ESP8266 and ESP32 development.
2016: Espressif-hosted documentation copyright period begins for the current docs site.
2020s: Espressif maintains esptool as the official multi-chip flashing, provisioning, and interaction utility.

Related projects

espflash cites esptool.py as an influence; ESP-IDF build and monitor workflows commonly sit next to esptool in Espressif development setups.

Sources

security posture

Risk level: blue

broad file, network, media, or database tool signal.

Risk classifier

blue risk · medium confidence · tool

Why

broad file, network, media, or database tool signal

Signals

text:server

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

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

Config paths the tool may read or write during local use.

Linux: /home/<user>/.config/esptool/esptool.cfg
macOS: /Users/<user>/.config/esptool/esptool.cfg
Unix: ./esptool.cfg~/esptool.cfg./setup.cfg./tox.ini
Windows: c:\Users\<user>\AppData\Local\esptool\esptool.cfgc:\Users\<user>\esptool.cfg

executables

Installed executables

Command	Kind	Exposure	Note
`esp_rfc2217_server`	executable	indexed executable	Discovered from the local executable index.
`esp_rfc2217_server.py`	executable	indexed executable	Discovered from the local executable index.
`espefuse`	executable	indexed executable	Discovered from the local executable index.
`espefuse.py`	executable	indexed executable	Discovered from the local executable index.
`espsecure`	executable	indexed executable	Discovered from the local executable index.
`espsecure.py`	executable	indexed executable	Discovered from the local executable index.
`esptool`	executable	indexed executable	Discovered from the local executable index.
`esptool.py`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version5.3.1

manager updated2026-06-30

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:esptool
Version	5.3.1
Package manager	Homebrew
Homepage	https://docs.espressif.com/projects/esptool/en/latest/esp32/
Last updated	2026-06-30T09:25:50Z
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/esptool.yml

Used sources

Geiger risk classifier
Nucleus package database
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install esptool with Homebrew