Skip to content

Update getting-started.md #451

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dlech merged 3 commits into from
Jul 19, 2025
+4 −1
Merged

Update getting-started.md #451

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
eeaab18
Update getting-started.md
Project516 Jul 19, 2025
8f7ca39
Update getting-started.md
Project516 Jul 19, 2025
ef81a02
Update getting-started.md
Project516 Jul 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions docs/getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -87,34 +87,37 @@ if you do not want to lose them!

Now it's time to write the image to the card.

1. Download and install [Etcher v17](https://github.com/balena-io/etcher/releases/tag/v1.17.0) `Newer versions are broken and don't work with the ev3dev image!`
1. Download and install [Etcher v17](https://github.com/balena-io/etcher/releases/tag/v1.17.0)

**Newer versions are broken and don't work with the ev3dev image!**

2. Launch Etcher after it has finished installing.

{% include /util/screenshot.html source="/images/etcher/home.png" caption="Etcher home screen" width="600px" %}

3. Click the "Select image" button and browse to the folder where you
4. Click the "Select image" button and browse to the folder where you
Comment thread
dlech marked this conversation as resolved.
Outdated
downloaded an ev3dev release. Select the file that you downloaded.
The release can be a `.img.zip` or `.img.xz`; whichever
you have will work with Etcher.

{% include /util/screenshot.html source="/images/etcher/image-selected.png" caption="Image chosen in Etcher" width="600px" %}

4. Plug the SD card into your PC (if your PC doesn't have a micro SD
5. Plug the SD card into your PC (if your PC doesn't have a micro SD
Comment thread
dlech marked this conversation as resolved.
Outdated
slot, you can use an adapter or external reader). Etcher should
detect the new device and display its information under the "Select
drive" step. Confirm that the selected drive is correct.

{% include /util/screenshot.html source="/images/etcher/drive-selected.png" caption="Drive selected in Etcher" width="600px" %}

5. If you have multiple removable drives available, you may need to
6. If you have multiple removable drives available, you may need to
Comment thread
dlech marked this conversation as resolved.
Outdated
use the "Change" button to select the proper device.

6. When you are confident that you have selected the correct drive,
7. When you are confident that you have selected the correct drive,
Comment thread
dlech marked this conversation as resolved.
Outdated
click "Flash!" and wait for the operation to complete.

{% include /util/screenshot.html source="/images/etcher/flash-started.png" caption="Etcher flashing the SD card" width="600px" %}

7. If you arrive at this screen, you have successfully flashed your SD card and are ready to move on to the next step.
8. If you arrive at this screen, you have successfully flashed your SD card and are ready to move on to the next step.
Comment thread
dlech marked this conversation as resolved.
Outdated

{% include /util/screenshot.html source="/images/etcher/success.png" caption="Etcher success screen" width="600px" %}
<br/>
Expand Down