Armbian raspberry pi zero

Armbian — самая популярная ОС для одноплатных компьютеров на базе ARM — процессоров

Armbian — это дистрибутив Linux, доступный для самых разных устройств ARM: Orange Pi, Banana Pi, Odroid, Olimex, Cubieboard, Roseapple Pi, Pine64, NanoPi и др… Он основан на Ubuntu и/или Debian.

Мы должны четко указать, какой образ Armbian мы должны загрузить, хотим ли мы сервер или рабочий стол [1], будет ли он из ветки, которая использует стабильное ядро ​​(Legacy) или самое современное и нестабильное (Mainline) [2] и, наконец, если он будет основан на Debian или Ubuntu [3].

Записать образ Armbian на microSD

Записать .img образ Armbian очень легко с утилитой Etcher , она доступна для Windows, Linux и Mac.

  1. Запустите программу Etcher;
  2. Нажмите на Select image и выберите файл образ;
  3. Указать файл, выбрать накопитель, создать диск.
  4. Нажмите на Flash! и ждите окончания процесса записи;
  5. После завершения процесса появится сообщение: Flash Complete! Safely ejected and ready for use, означающее, что запись прошла успешно и можете вставить СД-карту в ваш мини-компьютер.

Первый запуск ОС Armbian

Вставьте SD-карту в слот и питание платы. Первая загрузка занимает около 3 минут, после чего компьютер может перезагрузиться и вам нужно будет подождать еще одну минуту, чтобы войти в систему. Эта задержка происходит потому, что система создает 128Mb аварийный SWAP и расширяет SD-карту до полной емкости.

Как войти в систему

Войдите в систему как root через HDMI/последовательную консоль или через SSH и используйте пароль 1234. Вам будет предложено изменить этот пароль при первом входе в систему. При первом запуске должна создаваться учетная запись пользователя.

Настройки экрана

После создания учётной записи вам вам нужно будет настроить экран с помощью утилиты h3disp.

Настроить можно при первом запуске, в таком случае нажмите Y, или потом — нажмите n. После того, как нажали Y, появится список доступных конфигураций;

Если у вас HDMI монитор на 720p и 60Гц, тогда выполняйте следующую команду:

а если монитор с DVI, добавьте и параметр -d:

После запуска вы увидите чистый рабочий стол: Версия системы

Как подключиться к Wi-Fi роутеру

Если у вас плата со встроенным модулем Wi-Fi или USB адаптером, тогда подключиться к сети можно с помощью nmtui-connect.

ROUTER_SSID — это идентификатор сети, или, проще говоря, её название.


Armbian Quick Start Guide¶

Prerequisites for new users¶

Please, make sure you have:

  • a proper power supply according to the board manufacturer requirements (basic usage example: 5V/2A with DC Jack barrel or thick USB cable)
  • a reliable SD card (see below “How to prepare a SD card?”)

What to download?¶

The download for each image consists of three separate files:

  • a xz-compressed image file,
  • a sha file for download verification
  • and an asc file for image authentication.

For each board we usually provide:

  • one CLI server image with Debian Buster userspace
  • one CLI server image with Ubuntu Focal userspace
  • one desktop image with Ubuntu Focal userspace or Debian Buster userspace

Other unsupported builds may also be available (like Debian Stretch/Bullseye or Ubuntu Disco/Eoan/Hirsute).

Some boards have different options due to their hardware specialities — router or IoT boards.

Legacy or current?¶

Only current kernel branch is considered fully supported and can bring up video acceleration for example. NAND support is there but is still experimental.

The level of kernel support does depend on the board family. If in your specific case something does not work well, you are always free to try an image with legacy kernel included.

What are testing images?¶

  • made from stable branches
  • not very well tested
  • for end users

What are experimental/bleeding edge images?¶

  • made from unstable branches
  • untested
  • for experienced users only

Do not use testing or edge images in a productive environment. We do appreciate your constructive feedback to developers.

How to check download authenticity?¶

All our images are digitally signed and therefore it is possible to check their authenticity. You need to issue these commands (Linux/macOS, you might need to install dependencies first, eg. apt-get install gnupg on Debian/Ubuntu or brew install gnupg on macOS. on windows install the current simple gnupg Gnupg:

It is safe to ignore the message WARNING: This key is not certified with a trusted signature! .

How to check download integrity?¶

Since it might happen that your download got somehow corrupted we integrate a checksum/hash for the image. You can compare the image’s SHA-256 hash with the one contained in the sha256sum.sha file.

On Windows, you can download and use the QuickHash GUI and follow the instructions in the gui.

while on Linux/macOS, in the directory in which you have downloaded the files ,you would do this

How to prepare a SD card?¶

Important note: Make sure you use a good, reliable and fast SD card. If you encounter boot or stability troubles in over 95 percent of the time it is either insufficient power supply or related to SD card (bad card, bad card reader, something went wrong when burning the image, card too slow to boot – ‘Class 10’ highly recommended!). Armbian can simply not run on unreliable hardware so checking your SD card with either F3 or H2testw is mandatory if you run in problems. Since counterfeit SD cards are still an issue checking with F3/H2testw directly after purchase is highly recommended.

Write the xz compressed image with USBImager or balenaEtcher on all platforms since unlike other tools, either can validate burning results saving you from corrupted SD card contents.

Also important: Most SD cards are only optimised for sequential reads/writes as it is common with digital cameras. This is what the speed class is about. The SD Association defined Application Performance Class as a standard for random IO performance.

Application Performance Class Pictograph Miniumum Random Read Minimum Random Write Minimum Sustained (Seq. Write)
Class 1 (A1) 1500 4k IOPS 500 4k IOPS 10MBytes/sec
Class 2 (A2) 4000 4k IOPS 2000 4k IOPS 10MBytes/sec

At the time of this writing A1 and A2 cards are only widely available from SanDisk. Armbian recommends A1 rated SD-Cards only now (A2 rated cards need yet lacking driver support and therefore show lower overall and especially random IO performance). For example:

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 before burning Armbian to it (explanation in the forum). Detailed information regarding ‘factory default’ SD card performance.

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.

How to login?¶

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, to find your board IP address.

How to update?¶

Update process can take hours in case of using cheap SD card and/or under heavy load.

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

How to update u-boot?¶

First you need to update packages described in a previous “How to update” step. Then run armbian-config utility, go to system settings and proceed to:

“Install” “Install to/update boot loader” -> Install/Update the bootloader on SD/eMMC

How to adjust hardware features?¶

How to install to eMMC, NAND, SATA & USB?¶

  • kernel 3.4.x and NAND storage
  • pre-installed system on NAND (stock Android or other Linux)
  • any kernel
  • onboard eMMC storage
  • attached SATA or USB storage

Start the install script:

and follow the guide. You can create up to three scenarios:

  • boot from SD, system on SATA / USB
  • boot from eMMC / NAND, system on eMMC/NAND
  • boot from eMMC / NAND, system on SATA / USB

and you can choose the following file system options:

On Allwinner devices after switching to boot from NAND or eMMC clearing the boot loader signature on the SD card is recommended: dd if=/dev/zero of=/dev/mmcblkN bs=1024 seek=8 count=1 (replace /dev/mmcblkN with the correct device node – in case you run this directly after nand-sata-install without a reboot in between then it’s /dev/mmcblk0 ). When booting from eMMC to get SD cards auto-detected on Allwinner legacy images please consider changing mmc0 ‘s sdc_detmode from 3 to 1 in the board’s fex file (see here for details).

How to connect to wireless?¶

Required condition: a board with onboard or supported 3rd party wireless adapter on USB

If you know what is your wireless SSID:

If you do not know, you can browse and then connect

How to set fixed IP?¶

By default your main network adapter’s IP is assigned by your router DHCP server and all network interfaces are managed by NetworkManager:

The connection can now be edited with the following:

The same changes can also be done with NetworkManagers text user interface:


Raspberry Pi

Armbian 22.08 Jammy
Kernel 5.15.y, Size: 616Mb, Updated: Aug 31, 2022
SHA hash | PGP signature

Armbian 22.08 Jammy XFCE
Kernel 5.15.y, Size: 1526Mb, Updated: Aug 31, 2022
SHA hash | PGP signature



* Specifications differ from hardware revision, model and software support level



BASH or ZSH shell, standard Debian/Ubuntu utilities. Features can be adjusted with menu-driven utility. Login is possible via serial, HDMI or SSH.


Minimal, server or Desktop. We work with XFCE, Mate and Cinnamon but more is possible to build: Gnome, KDE, Budgie, Deepin, i3, …


No bloatware or spyware. Special utilities are completely optional. Suitable for newcomers and professionals.


Distributed images are optimized for flash media (SD/eMMC/SSD) and compacted to real data size.

Armbian is optimized on kernel and userspace level. ZRAM & ZSWAP support, browser profile memory caching, garbage commit delay.


Security level can be adjusted with the armbian-config. OS is reviewed by professionals within the community.


Maintainers and community have deep understanding how HW work. We are seniors with 30+ years of experience in Linux + embedded Linux.

Armbian provides open source build framework to build a distribution of optimised Linux hardware interface for armhf, aarch64 and x86.


We provide a selection of images that fits hardware best. If you need different image – use build framework and make whatever you need. Build framework relies on Debian and Ubuntu packages – you can build any combination – stable, old stable or rolling release.


Make sure you have a good & reliable SD card and a proper power supply. Archives can be flashed with Etcher (all OS) directly.

Insert the SD card into the slot, connect a cable to your network if possible or a display and power your board. (First) boot (with DHCP) takes a bit longer.


SUPPORTED devices are tested and they should work well apart from known issues and missing features. Support is provided as far as possible (in general there is no support for 3rd party hardware like DVB tuners and software like Kodi). Please check the documentation and existing forum posts before posting a question. Questions on private channels are considered as offence.

SUITABLE FOR TESTING (WIP) are devices which we’re currently working on but they might not be fully ready! These images are usually suitable for developers and experienced users. They are not very well tested but they might work without any problems. Your help to improve this situation is greatly appreciated.

NO OFFICIAL SUPPORT (CSC) are devices which are supported by the 3rd party. We usually don’t have hardware samples nor conduct any tests but they might work well. Provided images comes without any warranty and update might worsen usability and stability.