Skip to main content

Installation Instructions

Detailed installation instructions for all supported platforms. Choose your operating system below for specific setup guidance.

Download Quetzly Validator​

Visit our Download page to get the latest version of Quetzly Validator for your operating system:

  • Windows: Download the .exe installer
  • macOS: Download the .dmg file
  • Linux: Download the .AppImage or .deb package

System Requirements​

Minimum Requirements​

  • OS: Windows 10, macOS 10.14, or Ubuntu 18.04+
  • RAM: 4 GB
  • Storage: 500 MB available space
  • Network: Internet connection for API testing
  • OS: Windows 11, macOS 12+, or Ubuntu 20.04+
  • RAM: 8 GB or more
  • Storage: 1 GB available space
  • Network: Stable broadband connection

Windows Installation​

Download Options​

  • Standard Installer (.exe): Recommended for most users

Step-by-Step Installation​

Standard Installation​

  1. Download the latest Windows installer from the Download page
  2. Locate the downloaded Quetzly-Setup.exe file
  3. Right-click and select "Run as administrator"
  4. Follow the installation wizard:
    • Accept the license agreement
    • Choose installation directory (default: C:\Program Files\Quetzly)
    • Select additional tasks (desktop shortcut, start menu entry)
    • Click "Install" to begin
  5. Launch Quetzly from:
    • Desktop shortcut (if created)
    • Start Menu → All Programs → Quetzly
    • Search "Quetzly" in Windows search

macOS Installation​

Download Options​

  • DMG Installer: Standard macOS installation package

Step-by-Step Installation​

DMG Installation​

  1. Download Quetzly.dmg from the Download page
  2. Open the downloaded DMG file
  3. Drag Quetzly.app to the Applications folder
  4. Eject the DMG file
  5. Launch Quetzly from:
    • Applications folder
    • Spotlight search
    • Launchpad

First Launch Security​

On first launch, macOS may show a security warning:

  1. If blocked: Go to System Preferences → Security & Privacy
  2. Click "Open Anyway" next to the Quetzly message
  3. Confirm by clicking "Open" in the dialog

macOS-Specific Features​

  • Menu bar integration: Native macOS menu bar
  • Notification Center: System notification support
  • Spotlight search: Find Quetzly via Spotlight

Linux Installation​

Download Options​

  • AppImage: Universal Linux package (recommended)
  • Debian Package (.deb): For Debian/Ubuntu systems
  • Snap Package: From Snap Store
  • Flatpak: From Flathub

AppImage Installation​

The AppImage is the easiest way to run Quetzly on any Linux distribution:

  1. Download Quetzly.AppImage from the Download page
  2. Make executable: 
    chmod +x Quetzly.AppImage
  3. Run the application: 
    ./Quetzly.AppImage

Note: you may need to add --no-sandbox in some environments

Debian/Ubuntu Installation (.deb)​

  1. Download the .deb package
  2. Install using dpkg: 
    sudo dpkg -i quetzly_1.0.0_amd64.deb
  3. Fix dependencies if needed: 
    sudo apt-get install -f
  4. Launch from applications menu or terminal: 
    quetzly

Dependencies (linux only)​

Required Dependencies​

Quetzly is built with Electron and includes most dependencies. However, some systems may require:

  • libgtk-3: For GUI components
  • libnss3: For network security
  • libxss1: For screen capture features

Installing Dependencies​

Ubuntu/Debian​

sudo apt update
sudo apt install libgtk-3-0 libnss3 libxss1 libgconf-2-4 libxtst6 libxrandr2 libasound2 libpangocairo-1.0-0 libatk1.0-0 libcairo-gobject2 libgtk-3-0 libgdk-pixbuf2.0-0

CentOS/RHEL/Fedora​

sudo yum install gtk3 nss libXScrnSaver GConf2 libXtst libXrandr alsa-lib

Uninstalling Quetzly​

Windows​

  • Control Panel: Programs and Features → Quetzly → Uninstall
  • Settings: Apps → Quetzly → Uninstall

macOS​

  • Move to Trash: Drag Quetzly.app from Applications to Trash
  • Remove preferences (optional): 
    rm -rf ~/Library/Application\ Support/Quetzly
    rm -rf ~/Library/Preferences/com.quetzly.plist

Linux​

AppImage​

Simply delete the AppImage file and any desktop entries created.