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


A clean install of Q4OS Desktop on ARM device

administrator manual

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


1. Introduction

Q4OS on ARM architecture is a free operating system based on Debian 'armhf' 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 a couple different steps. First, you will have to install clean 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. Debian installation

Make Debian 'armhf' installation, no matter how. Installation method depends on a specific target device, we recommend to follow official Debian documentation and guides, you could start here. The fastest and recommended way is to make the basic Debian setup with SSH server and no desktop environment, however you can select any Debian packages to install including alternative desktops too. Once the Debian installation has finished, launch Q4OS setup, see the next chapter.


3. Q4OS setup

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

Login into the previously installed Debian 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 Software Centre, 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 ARM device, administrator manual, rev. 02/2016