How to Install GXDE?
Image Installation
Official download: https://repo.gxde.top/ISO/
Legacy versions: https://pan.baidu.com/s/1dsJSUhHiMg4tPHTq9IDpJw?pwd=GXDE Passwd: GXDE
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.
Because the LoongArch Debian upstream is not yet stable, GXDE loong64 is built upon deepin 25. Its codename is hetao, and the 'Rock Solid' feature is not enabled.
Install image lock screen password: live
Mips (Qemu only)
Currently only supported on UOS20, Loongnix20, and Kylin V10 with mips64 architecture. UOS25 and non-mips64 machines are not supported yet.
Before use, manually grant execute permission to run.sh and install qemu-system:
sudo apt install qemu-system qemu-system-gui -yDefault VM password: gxde
Download: https://repo.gxde.top/TGZ/mips64el-qemu/
Hetao Branch ISO Download Links
GXDE Hetao Branch is based on deepin 25 (for codename definitions, see: https://www.gxde.top/en/install/#system-code-names). It is currently in the demo phase and should not be used in production environments.
⚠️ Note: This ISO does not have the 'Rock Solid' feature enabled and conflicts with DDE in the repositories.
Currently, ISOs for amd64, arm64, and loong64 architectures are provided. Note: These ISOs do not use deepin's default installer.
Due to limited server space, amd64 and arm64 ISOs are only available via cloud storage download links:
123 Pan: https://www.123865.com/s/pDSKVv-B4PWv
Baidu Netdisk: Link: https://pan.baidu.com/s/1L9A6q-xrkgKfZ_LIyfbDMQ?pwd=c7ps (Extraction code: c7ps)
ChengTong (CTFile):https://ctfile.gfdgdxi.top#/d/31540479-61968823-1bd7af?p=2061 (Access password: 2061)
The loong64 architecture ISO can be downloaded from the mirror sites listed above, or also from the cloud storage links.
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).
amd64, arm64 are supported for installation and use under Debian 13/12. i386, mips64 are supported for installation and use under Debian 12. loong64 is supported for installation and use under deepin25. riscv64 is supported for use under deepin25/Debian13.
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/ |
| hetao | deepin 25 | https://repo.gxde.top/gxde-os/hetao/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 Docker
RDPDocker is a Docker image building and container creation tool with X11 and desktop environments, supporting the creation of Ubuntu, Debian, Arch Linux, Fedora systems, Lingmo, GNOME, Xfce4, X11, SSH and other environments. Meanwhile, users are allowed to remotely access the container through methods such as NoMachine, RDP, VNC, SSH, etc. This tool enables multiple users to share a host without virtualization and at extremely low cost. It is also very fast to create, can be used and opened at any time, and only occupies minimal memory and disk space. Docker only needs to be installed on the host. Supports running on headless Linux servers desktop, WSL2, LXC, and Android phones.
You can learn more from https://github.com/PIKACHUIM/RDDocker
Install GXDE on Android Phone/Pads
Install GXDE With Tiny-Computer
Run Debian with XFCE/LXQt/GXDE/... on Android with just one click - optimized for Chinese users.
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.cernet.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
Install GXDE with Neo Desktop
A powerful launcher that supports connection to either AR glasses or physical displays, enabling the device to achieve independent multi-display output.
You can learn more from https://nightmare.press/