How to Install GXDE?
Image Installation
Official download: https://repo.gxde.top/ISO/
Legacy versions: https://repo-archive.gxde.top/ISO/
Sourceforge: https://sourceforge.net/projects/gxde-os/files
ISO Mirror（CERNET Mirror）：https://mirrors.cernet.edu.cn/GXDE/ISO/
Mirrors list: Available Here
Baidu Cloud Disk (Including old archive): https://pan.baidu.com/s/1L9A6q-xrkgKfZ_LIyfbDMQ?pwd=c7ps Password: c7ps
Ctfile Cloud Disk (Including old archive)：https://ctfile.gfdgdxi.top/#/d/31540479-66220399-11ab95?p=2061 Password: 2061
GXDE is not perfect, please confirm FAQ before installation, containing Nvidia Graphic Card driver installation help.
For Beginners: If you don't know how to partition, leave some space on a disk and select to install on the whole disk during installation.
EFI Installation: You must create a partition formatted as vfat/fat32 with the mount point set to /boot/efi. The remaining space can be partitioned as needed.
Install image lock screen password: live
Daily Build Image
If you want to download the daily build image, you can visit: https://sourceforge.net/projects/gxde-os-daily/
Daily build images cannot guarantee normal installation and use. If you need daily use, please download the stable version image above
APT Repository Installation
For those with ISO installation images available, such as amd64 and arm64, it is recommended to use the ISO for installation.
Currently supported architectures include i386, amd64, arm64, mips64, loong64, and riscv64 (riscv64 has not been tested).
i386, amd64, arm64, and mips64 are supported for installation and use under Debian 13/12. loong64 is supported for installation and use under Debian Port and Loongnix25. riscv64 is supported for use under Debian Sid. Users of loong64 and riscv64 architectures must add the internal testing repository.
(Debian Port system installation image for loong64: https://cdimage.debian.org/cdimage/ports/tests/ )
First, you need download the deb file:
| Target System Code | Supported Distribution | deb Package Download URL |
|---|---|---|
| lizhi | Debian 13 | https://repo.gxde.top/gxde-os/lizhi/g/gxde-source/ |
| bixie | Debian 12 | https://repo.gxde.top/gxde-os/bixie/g/gxde-source/ |
| meimei | Loongnix 25 | https://repo.gxde.top/gxde-os/meimei/g/gxde-source/ |
WARNING
Please download the corresponding package according to your system version, otherwise dependency errors may occur during installation
WARNING
Starting from GXDE 2025, we are directly built on Debian Backports. After installing the gxde-source package, the Debian Backports repository will be automatically added
After installation, run:
sudo apt update
sudo apt install aptss
sudo apt install gxde-testing-source -y # Add the internal testing source. Debian Sid/Port users must use it, amd64, mips64, i386, arm64 and Loongnix 25 users can ignore it
sudo aptss update
sudo aptss install gxde-desktop gxde-desktop-extra -y
sudo aptss install spark-store -y # Not available for mips64, i386 and riscv64 usersThen restart.
aptsscan accelerate download speed from GXDE source. But, if your performance is so poor that runningaptsscost centuries, just use apt.
There are potential conflict between GXDE and KDE. Don't install them both or maybe something will crash
Install GXDE on Android Phone/Pads (With Vectras VM)
Please check: https://github.com/xoureldeen/Vectras-VM-Android
Install GXDE on Android Phone/Pads (With Tiny-Computer)
The Tiny Computer 1.0.19 now supports GXDE. This version was developed in collaboration with the Tiny Computer team and is still in beta testing phase.
To report bugs, please visit: https://github.com/Cateners/tiny_computer/issues/129
WARNING
If upgrading from v1.0.10 or later versions, you must perform a startup command reset (in Advanced Settings) and reinstall the boot package (in Global Settings) after launch. Otherwise, new features may not work properly.
By default, the boot package, quick commands, and container system will not be updated even when the software is upgraded.
The software only supports arm64 devices. Default credentials: user tiny/password tiny.
Connection ports:
- VNC port 5904 (password: 12345678)
- noVNC port 36082
- PulseAudio port 4718
- Termux X11 uses port 7897
This software does not conflict with Termux.
Download Links:
- Mirror Site Download (Recommended): https://mirrors.sdu.edu.cn/GXDE/APK/
- Github Download: https://github.com/Cateners/tiny_computer/releases (Select the APK with the "gxde" suffix)
Note: If the interface operation is laggy, you can disable the special effects mode in the Control Center => Personalization. If the Control Center cannot be opened, you can upgrade to the latest version using the Toolbox in the GXDE-provided System Assistant.
Tiny Computer Project Address: https://github.com/Cateners/tiny_computer
