mirror of
https://github.com/balena-io/etcher.git
synced 2025-04-21 13:57:17 +00:00
3906816e67
This removes the "mac" from the Travis CI badge label, as we're not running Mac OS builds on Travis CI anymore. Change-Type: none
151 lines
4.5 KiB
Markdown
151 lines
4.5 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.
|
|
|
|
[](https://etcher.io)
|
|
|
|
[](https://travis-ci.org/resin-io/etcher/branches)
|
|
[](https://ci.appveyor.com/project/resin-io/etcher/branch/master)
|
|
[](https://david-dm.org/resin-io/etcher)
|
|
[](https://forums.resin.io/c/etcher)
|
|
[](https://waffle.io/resin-io/etcher)
|
|
|
|
***
|
|
|
|
[**Download**][etcher] | [**Support**][SUPPORT] | [**Documentation**][USER-DOCUMENTATION] | [**Contributing**][CONTRIBUTING] | [**Roadmap**][milestones] | [**CLI**][CLI]
|
|
|
|
|
|
|
|
Supported Operating Systems
|
|
---------------------------
|
|
|
|
- Linux (most distros)
|
|
- macOS 10.9 and later
|
|
- Microsoft Windows 7 and later
|
|
|
|
Note that 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.
|
|
|
|
#### Debian and Ubuntu based Package Repository (GNU/Linux x86/x64)
|
|
|
|
1. Add Etcher debian repository:
|
|
|
|
```
|
|
echo "deb https://dl.bintray.com/resin-io/debian stable etcher" | sudo tee /etc/apt/sources.list.d/etcher.list
|
|
```
|
|
|
|
2. Trust Bintray.com's GPG key:
|
|
|
|
```sh
|
|
sudo apt-key adv --keyserver hkp://pgp.mit.edu:80 --recv-keys 379CE192D401AB61
|
|
```
|
|
|
|
3. Update and install:
|
|
|
|
```sh
|
|
sudo apt-get update
|
|
sudo apt-get install etcher-electron
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```sh
|
|
sudo apt-get remove etcher-electron
|
|
sudo rm /etc/apt/sources.list.d/etcher.list
|
|
sudo apt-get update
|
|
```
|
|
#### Redhat (RHEL) and Fedora based Package Repository (GNU/Linux x86/x64)
|
|
|
|
1. Add Etcher rpm repository:
|
|
|
|
```sh
|
|
sudo wget https://bintray.com/resin-io/redhat/rpm -O /etc/yum.repos.d/bintray-resin-io-redhat.repo
|
|
```
|
|
|
|
2. Update and install:
|
|
|
|
```sh
|
|
sudo yum install -y etcher-electron
|
|
```
|
|
or
|
|
```sh
|
|
sudo dnf install -y etcher-electron
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```
|
|
sudo yum remove -y etcher-electron
|
|
sudo rm /etc/yum.repos.d/bintray-resin-io-redhat.repo
|
|
sudo yum clean all
|
|
sudo yum makecache fast
|
|
```
|
|
or
|
|
```
|
|
sudo dnf remove -y etcher-electron
|
|
sudo rm /etc/yum.repos.d/bintray-resin-io-redhat.repo
|
|
sudo dnf clean all
|
|
sudo dnf makecache
|
|
```
|
|
|
|
#### Brew Cask (macOS)
|
|
|
|
Note that the Etcher Cask has to be updated manually to point to new versions,
|
|
so it might not refer to the latest version immediately after an Etcher
|
|
release.
|
|
|
|
```sh
|
|
brew cask install etcher
|
|
```
|
|
|
|
##### Uninstall
|
|
|
|
```sh
|
|
brew cask uninstall etcher
|
|
```
|
|
|
|
### Chocolatey (Windows)
|
|
|
|
This package is maintained by [@majkinetor](https://github.com/majkinetor), and
|
|
is kept up to date automatically.
|
|
|
|
```sh
|
|
choco install etcher
|
|
```
|
|
|
|
Support
|
|
-------
|
|
|
|
If you're having any problem, please [raise an issue][newissue] on GitHub and
|
|
the resin.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://etcher.io
|
|
[electron]: http://electron.atom.io
|
|
[electron-supported-platforms]: http://electron.atom.io/docs/tutorial/supported-platforms/
|
|
[SUPPORT]: https://github.com/resin-io/etcher/blob/master/SUPPORT.md
|
|
[CONTRIBUTING]: https://github.com/resin-io/etcher/blob/master/docs/CONTRIBUTING.md
|
|
[CLI]: https://github.com/resin-io/etcher/blob/master/docs/CLI.md
|
|
[USER-DOCUMENTATION]: https://github.com/resin-io/etcher/blob/master/docs/USER-DOCUMENTATION.md
|
|
[milestones]: https://github.com/resin-io/etcher/milestones
|
|
[newissue]: https://github.com/resin-io/etcher/issues/new
|
|
[license]: https://github.com/resin-io/etcher/blob/master/LICENSE
|