Etcher CLI

The Etcher CLI is a command-line tool that aims to provide all the benefits of the Etcher desktop application in a way that can be run from a terminal, or even used from a script.

Warning the CLI is currently experimental, proceed with caution and report issues.

Download

RELEASEOSARCH
Etcher CLI for OS X x64 (64-bit)OS Xx64
Etcher CLI for Linux x64 (64-bit)Linuxx64
Etcher CLI for Linux x86 (32-bit)Linuxx86
Etcher CLI for Windows x64 (64-bit)Windowsx64
Etcher CLI for Windows x86 (32-bit)Windowsx86

Install

macOS and GNU/Linux

  • Extract the .tar.gz package by running:
tar fvx path/to/cli.tar.gz

  • Move the resulting directory to /opt/etcher-cli

  • Add /opt/etcher-cli to the PATH. For example, add the following to .bashrc or .zshrc:

export PATH="$PATH:/opt/etcher-cli"

Windows

  • Unzip the .zip package by right-clicking on it and selecting "Extract All"

  • Move the resulting directory to C:\etcher-cli

  • Add C:\etcher-cli to the %PATH%

    • On Windows 10 and Windows 8

      • Open Control Panel
      • Open *System
      • Click the Advanced system settings link
      • Click Environment Variables
      • Find the PATH environment variable, and click Edit
      • Append ;C:\etcher-cli to the environment variable value
      • Click OK

    • On Windows 7

      • Right-click the My Computer icon
      • Open the Properties menu
      • Open the Advanced tab
      • Click Environment Variables
      • Find the PATH environment variable, and click Edit
      • Append ;C:\etcher-cli to the environment variable value
      • Click OK

    • Re-open cmd.exe, or PowerShell

Running

etcher -v

Options

  --help, -h     show help
  --version, -v  show version number
  --drive, -d    drive
  --check, -c    validate write
  --yes, -y      confirm non-interactively
  --unmount, -u  unmount on success