mirror of
https://github.com/balena-io/etcher.git
synced 2025-04-21 22:07:18 +00:00
134 lines
4.1 KiB
Markdown
134 lines
4.1 KiB
Markdown
# Etcher
|
|
|
|
> Flash OS images to SD cards & USB drives, safely and easily.
|
|
|
|
Etcher is a powerful OS image flasher built with web technologies to ensure
|
|
flashing an SDCard or USB drive is a pleasant and safe experience. It protects
|
|
you from accidentally writing to your hard-drives, ensures every byte of data
|
|
was written correctly, and much more. It can also directly flash Raspberry Pi devices that support [USB device boot mode](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-device-boot-mode).
|
|
|
|
[](https://balena.io/etcher)
|
|
[](https://github.com/balena-io/etcher/blob/master/LICENSE)
|
|
[](https://forums.balena.io/c/etcher)
|
|
|
|
---
|
|
|
|
[**Download**][etcher] | [**Support**][support] | [**Documentation**][user-documentation] | [**Contributing**][contributing] | [**Roadmap**][milestones]
|
|
|
|
## Supported Operating Systems
|
|
|
|
- Linux (most distros)
|
|
- macOS 10.10 (Yosemite) and later
|
|
- Microsoft Windows 7 and later
|
|
|
|
**Note**: Etcher will run on any platform officially supported by
|
|
[Electron][electron]. Read more in their
|
|
[documentation][electron-supported-platforms].
|
|
|
|
## Installers
|
|
|
|
Refer to the [downloads page][etcher] for the latest pre-made
|
|
installers for all supported operating systems.
|
|
|
|
## Packages
|
|
|
|
#### Debian and Ubuntu based Package Repository (GNU/Linux x86/x64)
|
|
|
|
Package for Debian and Ubuntu can be downloaded from the [Github release page](https://github.com/balena-io/etcher/releases/)
|
|
|
|
1. Install using dpkg
|
|
|
|
```sh
|
|
sudo dpkg -i balena-etcher_******_amd64.deb
|
|
```
|
|
|
|
If you're missing dependencies you can fix them with:
|
|
|
|
```sh
|
|
sudo apt update && apt --fix-broken install #to add potential missing dependencies
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```sh
|
|
sudo apt-get remove balena-etcher
|
|
apt clean
|
|
rm -rf /var/lib/apt/lists/*
|
|
apt update
|
|
```
|
|
|
|
#### Redhat (RHEL) and Fedora-based Package Repository (GNU/Linux x86/x64)
|
|
|
|
##### Yum
|
|
|
|
Package for Fedora-based and Redhat can be downloaded from the [Github release page](https://github.com/balena-io/etcher/releases/)
|
|
|
|
1. Install using yum
|
|
|
|
```sh
|
|
sudo yum localinstall balena-etcher-***.x86_64.rpm
|
|
```
|
|
|
|
#### Arch/Manjaro Linux (GNU/Linux x64)
|
|
|
|
Etcher is offered through the Arch User Repository and can be installed on both Manjaro and Arch systems. You can compile it from the source code in this repository using [`balena-etcher`](https://aur.archlinux.org/packages/balena-etcher/). The following example uses a common AUR helper to install the latest release:
|
|
|
|
```sh
|
|
yay -S balena-etcher
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```sh
|
|
yay -R balena-etcher
|
|
```
|
|
|
|
#### WinGet (Windows)
|
|
|
|
This package is updated by [gh-action](https://github.com/vedantmgoyal2009/winget-releaser), and is kept up to date automatically.
|
|
|
|
```sh
|
|
winget install balenaEtcher #or Balena.Etcher
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```sh
|
|
winget uninstall balenaEtcher
|
|
```
|
|
|
|
#### Chocolatey (Windows)
|
|
|
|
This package is maintained by [@majkinetor](https://github.com/majkinetor), and
|
|
is kept up to date automatically.
|
|
|
|
```sh
|
|
choco install etcher
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```sh
|
|
choco uninstall etcher
|
|
```
|
|
|
|
## Support
|
|
|
|
If you're having any problem, please [raise an issue][newissue] on GitHub, and
|
|
the balena.io team will be happy to help.
|
|
|
|
## License
|
|
|
|
Etcher is free software and may be redistributed under the terms specified in
|
|
the [license].
|
|
|
|
[etcher]: https://balena.io/etcher
|
|
[electron]: https://electronjs.org/
|
|
[electron-supported-platforms]: https://electronjs.org/docs/tutorial/support#supported-platforms
|
|
[support]: https://github.com/balena-io/etcher/blob/master/SUPPORT.md
|
|
[contributing]: https://github.com/balena-io/etcher/blob/master/docs/CONTRIBUTING.md
|
|
[user-documentation]: https://github.com/balena-io/etcher/blob/master/docs/USER-DOCUMENTATION.md
|
|
[milestones]: https://github.com/balena-io/etcher/milestones
|
|
[newissue]: https://github.com/balena-io/etcher/issues/new
|
|
[license]: https://github.com/balena-io/etcher/blob/master/LICENSE
|