Setup Q4OS on top of a Debian based distribution, administrator manual, rev. 12/2025
administrator manual
1. IntroductionThe procedure consists of couple different steps. First, you need to install one of the Debian-based Linux distributions on your device. This includes Debian itself, and for example Devuan for x86_64bit, Armbian or RaspberryPi OS for the Arm64 architecture. Then, you download and run the Q4OS installation script, which will set up and fully configure fresh Q4OS desktop on your computer. The script will check for compatibility, essentially add Q4OS repositories, and modify the underlying system in a Q4OS way so that you can use Q4OS tools and features on the host operating system.
As Q4OS supports ARM 64bit hardware architecture, this method is also very convenient for setting up Q4OS on ARM devices.
As introduced in the first chapter, perform a Debian based OS installation first, configure it accordingly. There is an interactive Q4OS installation script available from Q4OS downloads repository, it supports various Debian based 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.
$ wget q4os.org/downloads/q4os-setup.sh $ su # sh q4os-setup.sh
Please note, the setup process takes a while. Once completed, reboot and login into the fresh and clean Q4OS Desktop.
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.
Setup Q4OS on top of a Debian based distribution, administrator manual, rev. 12/2025