This is documentation for Test, Monitor, and Visualize Geospatial APIs **1.0.0**, which is no longer actively maintained.

For up-to-date documentation, see the **[latest version](/content/docs/desktop/installation/index.html)** (1.1.0).

Version: 1.0.0

On this page

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

## Download Quetzly Validator

Visit our [Download page](/content/download/index.html) 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

### Recommended Requirements

- **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](/content/download/index.html)
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](/content/download/index.html)
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](/content/download/index.html)
2. **Make executable**:
   
   ```bash
   chmod +x Quetzly.AppImage
   ```

3. **Run** the application:
   
   ```bash
   ./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:
   
   ```bash
   sudo dpkg -i quetzly_1.0.0_amd64.deb
   ```

3. **Fix dependencies** if needed:
   
   ```bash
   sudo apt-get install -f
   ```

4. **Launch** from applications menu or terminal:
   
   ```bash
   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 
   
   ```bash
   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 
   
   ```bash
   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):
   
   ```bash
   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.