Skip to main content

Installation Instructions

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

Download Quetzly​

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

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

Note: At the moment Quetzly is only downloadable by joining the Beta program. Join the beta program and a download link will be send to you.

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

Optional: Desktop Integration​

To add Quetzly to your applications menu:

# Move to a permanent location
mv Quetzly.AppImage ~/Applications/

# Make it executable
chmod +x ~/Applications/Quetzly.AppImage

# Create desktop entry
cat > ~/.local/share/applications/quetzly.desktop << EOF
[Desktop Entry]
Name=Quetzly
Comment=GeoAPI Testing Tool
Exec=/home/$USER/Applications/Quetzly.AppImage
Icon=quetzly
Terminal=false
Type=Application
Categories=Development;Network;
EOF

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​

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

Verification​

After installation, verify Quetzly is working correctly:

  1. Launch the application
  2. Check version: Help → About Quetzly
  3. Test basic functionality:
    • Make a simple GET request to https://httpbin.org/get
    • Verify the response appears correctly
    • Check that the interface is responsive

Updating Quetzly​

Manual Updates​

  1. Download the latest version
  2. Follow the same installation steps
  3. Settings preserved: Your configurations will be maintained

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.

Troubleshooting Installation​

Common Issues​

Permission denied errors:

  • Ensure you have administrator/sudo privileges
  • Check file permissions on the installer

Missing dependencies on Linux:

  • Install the required system libraries listed above
  • Try the AppImage version for better compatibility

macOS won't open (security warning):

  • Follow the macOS security steps above
  • Ensure you downloaded from the official source

Windows antivirus blocking:

  • Add Quetzly to antivirus whitelist
  • Temporarily disable real-time protection during installation

Getting Help​

If you encounter installation issues:

  1. Check the troubleshooting steps above
  2. Visit our Getting Started guide
  3. Report issues on our GitHub repository

Ready to start using Quetzly? Continue to Send Requests to learn about the core features.