Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
dde6c9f
Start restructuring content and add preface
dleidert Jan 24, 2025
3f62bce
Update introduction
dleidert Jan 24, 2025
582afd9
Typo fix
dleidert Jan 24, 2025
e9ea4ca
Typo fix
dleidert Mar 19, 2025
a04a493
Rephrase the support status section
dleidert Mar 19, 2025
1ae4093
Move changelog and release model to appendix
dleidert Mar 19, 2025
e15a0c3
Rename section
dleidert Mar 19, 2025
ceb2e02
Rephrase the introduction to the getting started section
dleidert Mar 19, 2025
2bf78d1
Rewrite the image download section
dleidert Mar 19, 2025
7ff7c60
Change back to lowercase headings
dleidert Mar 19, 2025
5b59bdf
Rephrase the deploying image part
dleidert Mar 19, 2025
4ac5977
Minor updates to the first boot/login/installation
dleidert Mar 19, 2025
eb76eb0
Move installation and hardware tuning into a First steps section
dleidert Mar 19, 2025
f09abd6
Move firmware freeze and upgrade into Update section and create a Tro…
dleidert Mar 19, 2025
e81bfd2
Move the preface into the introduction
dleidert Mar 19, 2025
08d2f4d
Subtitle
dleidert Mar 19, 2025
d7ba7fe
Structuring
dleidert Mar 19, 2025
052dacc
Simple structure defition
dleidert Mar 19, 2025
280f9b8
Merge recovery into the troubleshooting section
dleidert Mar 19, 2025
2f1c531
Add a hint to armbian-config for first configuration
dleidert Mar 19, 2025
f8f0c59
Merge remote-tracking branch 'armbian/main'
dleidert Mar 21, 2025
4502239
Re-read the getting started section
dleidert Apr 7, 2025
2fee023
Move remaining pages into Advanced section
dleidert Apr 7, 2025
b8da932
Disable devicetree overlays
dleidert Apr 7, 2025
925a14d
Simple header rephrasing
dleidert Apr 7, 2025
7fb3955
Drop balenaetcher as discussed with @igorpecovnik
dleidert Apr 7, 2025
26deee3
Minor typo fixes
dleidert Apr 7, 2025
a6639fb
These sections are part of Getting started
dleidert Apr 7, 2025
d62fd6a
Add section for main project resources
dleidert Apr 7, 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
Prev Previous commit
Next Next commit
Minor updates to the first boot/login/installation
  • Loading branch information
dleidert committed Mar 19, 2025
commit 4ac59774f47643646412e80feac7909e56cb8338
66 changes: 41 additions & 25 deletions docs/User-Guide_Getting-Started.md
Original file line number Diff line number Diff line change
Expand Up @@ -176,18 +176,17 @@ We recommend at least A1 rated SD-Cards ([A2 rated cards need yet lacking driver

In case you chose an SD card that was already in use before, please consider resetting it back to 'factory default' performance with [SD Formatter](https://www.sdcard.org/downloads/formatter/) before burning Armbian to it ([explanation in the forum](https://forum.armbian.com/topic/3776-the-partition-is-not-resized-to-full-sd-card-size/&do=findComment&comment=27413)). Detailed information regarding ['factory default' SD card performance](https://forum.armbian.com/topic/954-sd-card-performance/page/3/&tab=comments#comment-49811).

## How to boot

Insert SD card into a slot and power the board. (First) boot (with DHCP) takes up to two minutes with a class 10 SD card and cheapest board.
## First boot

## How to login
Insert the SD card into a slot and power on the board. With the cheapest board, the first boot (with DHCP) can take up to two minutes with a class 10 SD card.

First boot will log you automatically on HDMI or serial console while for SSH login you need to login as **root** and use password **1234**. You will be prompted to change this password. You will then be asked to create a normal user account that is sudo enabled (beware of default QWERTY keyboard settings at this stage). Please use [this tool](https://angryip.org/), to find your board IP address.

???+ tips "Automated config"
These settings can be pre-loaded, see [Autoconfig](/User-Guide_Autoconfig)
## First login

The first boot will log you in automatically on HDMI or the serial console. For SSH, you need to login as **root** and use the password **1234**. If you need to find your board's IP address, please use [this tool](https://angryip.org/).

In case you have no wired network connection and there is a wireless adaptor detected, it will prompt you to connect.
After logging in, you will be prompted to change the default password. You will then be asked to create a normal user account that will have sudo permissions. Beware, at this stage the keyboard is using the QWERTY layout. In case you have no wired network connection and there is a wireless adaptor detected, it will prompt you to connect.

Welcome to Armbian!

Expand Down Expand Up @@ -241,18 +240,15 @@ In case you have no wired network connection and there is a wireless adaptor det
Generating locales: sl_SI.UTF-8
root@bananapim2pro:~#

## How to install

![Installer](https://www.armbian.com/wp-content/uploads/2016/12/nandsata.png)
???+ tips "Automated config"
These settings can be pre-loaded, see [Autoconfig](/User-Guide_Autoconfig)

!!! success "Required condition for eMMC/SATA/USB/NVME:"
<!-- TODO: it must be made clear that this just preps the SD card -->

* onboard eMMC storage
* attached SATA, NVME or USB storage

Start the install script and follow the lead:
## Installation

armbian-install
At this stage, nothing has been installed onto the boards internal drive yet. Using the installer, you can now decide, where you want to install the boot loader and the rest of the system. The installer supports various combinations depending on the availability of onboard eMMC and attached SATA, NVME or USB storage.

!!! tip "Armbian installer provides those scenarios:"

Expand All @@ -265,33 +261,53 @@ Start the install script and follow the lead:
* Install/Update the bootloader on SPI Flash
* Install system to UEFI disk

!!! tip "You can choose the following file system options:"
<!-- TODO: give the user a sensible default -->

Start the install script and follow the lead:

armbian-install

![Installer](https://www.armbian.com/wp-content/uploads/2016/12/nandsata.png)

After you have decided for an option, you can choose between the following file systems: <!-- TODO: only for system? -->

* ext2,3,4
* btrfs

For novice users, a sensible default is `ext4`.

* ext2,3,4
* btrfs
Congratulation. You have successfully installed Armbian onto your board!

## How to update

### Armbian OS
## Update the system

The operating system consists of two parts that must be updated separately.


### Update the Armbian OS

For the base operating system, use the APT package manager to keep the packages up to date.

apt update
apt upgrade

**Update process can take some time in case of using old & cheap SD card and/or under heavy load.**
**The Update process can take quite some time in case you are using an old or a cheap SD card and/or experience heavy load.**

If the kernel was upgraded during this process you will be prompted to reboot at the next login.

If the kernel was upgraded during this process you will be prompted to reboot at next login.

### Boot loader
### Update the boot loader

First you need to update all packages described in a previous step. Then run:
First, you need to update all packages as described in the previous section. Then run:

```bash
sudo armbian-install
```

Select:

Install/Update the bootloader on SD/eMMC
Install/Update the bootloader on SD/eMMC


## How to stay safe

Expand Down