A clean install of Q4OS Desktop on an ARM device, administrator manual, rev. 02/2023


A clean install of Q4OS Desktop on an ARM device

administrator manual

1. Introduction
2. Armbian installation
3. Q4OS setup
4. After install steps


1. Introduction

Q4OS on ARM architecture is a free operating system based on Debian ARM port. It runs on wide variety of hardware equipped with ARM processors, including Chromebooks, tablets, single board computers, embedded devices and more. Q4OS is now one of the few distributions offering the full desktop environment on the ARM architecture. If you want to install Q4OS on Raspberry Pi boards, please follow Q4OS on Raspberry Pi specific setup guide.

Q4OS setup process consists of couple different steps. First, you will have to install either Armbian or Debian operating system onto your device, see chapter 2. below. Then, you will download and run Q4OS installation script, see chapter 3., it will setup and fully configure fresh Q4OS desktop within your device.


2. Armbian installation

Perform, or start from existing, 64bit/arm64 or 32bit/armhf Armbian or Debian setup. Installation method depends on the specific target device, we recommend to follow official Armbian documentation and guides, you could start here. The fastest and recommended way is to perform the basic Armbian setup with SSH server, however you can select any Armbian packages to install including alternative desktops too. Once the Armbian installation has finished, launch Q4OS setup script, see the next chapter.


3. Q4OS setup

There is an interactive installation script available, it supports both Armbian as well as Debian operating systems. Simply download and run this script in terminal as 'root', see below, it will add Q4OS repositories and guide you throughout Q4OS setup process, please follow on-screen instructions.

Login into the previously installed Armbian system via SSH, console or desktop and get ready to execute a few terminal commands. Download and run Q4OS setup script as 'root' superuser:

$ wget q4os.org/downloads/q4os-setup.sh
$ su
# sh q4os-setup.sh

Reboot and login into the fresh and clean Q4OS Desktop.


4. After install steps

Now, it's the right time to install desired applications. The best and recommended way is to use Q4OS Desktop profiler and Software center, please read Q4OS documentation. Enjoy your new desktop and don't forget to involve yourself in the Q4OS community.



A clean install of Q4OS Desktop on an ARM device, administrator manual, rev. 02/2023