Download guideXOS

Get started with guideXOS

Latest Release

The latest version of guideXOS

Version 0.1

Download ISO

File size: 12.1MB | Format: ISO Image

System Requirements

Minimum specifications to run guideXOS

Virtual Machine (Recommended)

QEMU
VMware Workstation / Player
VirtualBox
RAM: 2GB recommended
Storage: 100MB recommended
Network: NAT or Bridged adapter (optional)

Physical Hardware

CPU: x86-64 compatible processor
RAM: 512MB minimum, 1GB+ recommended
Storage: 100MB minimum
Network: Intel 825xx or RTL8111
Input: PS/2 or USB keyboard/mouse

Installation Guide

Step-by-step instructions to get started

Step 1: Download the ISO

Download the guideXOS ISO image from the link above. Save it to a location you can easily access.

Step 2: Create Virtual Machine

Open your virtualization software (QEMU, VMware, or VirtualBox) and create a new virtual machine:

                        VMware Settings:
                        - Guest OS: Other / Other (64-bit)
                        - Memory: 2056 MB (2 GB)
                        - Hard Disk: 100 MB (or larger)
                        - Network Adapter: NAT or Bridged

                        VirtualBox Settings:
                        - Type: Other
                        - Version: Other/Unknown (64-bit)
                        - Memory: 2056 MB
                        - Network: NAT or Bridged Adapter
                    

Step 3: Mount the ISO

Configure the virtual machine to boot from the guideXOS ISO image. This is usually done in the CD/DVD settings of your VM.

Step 4: Boot and Enjoy!

Start the virtual machine. guideXOS will boot up and automatically start the GUI desktop environment. You can now explore all the built-in applications and features!

Build from Source

For developers who want to compile guideXOS themselves

Requirements

.NET 9.0 SDK
Visual Studio 2022 or later (or VS Code)
Git

                        # Clone the repository
                        git clone https://gitlab.com/guidex/guideXOS

                        # Navigate to the project
                        cd guideXOS

                        # Build the project
                        dotnet build

                        # The output will be in the bin folder
                    

View on GitLab Developer Docs

Need Help?

Check out our documentation for detailed guides, tutorials, and troubleshooting tips.

Read Documentation