Installation

Downloading DesQTA

DesQTA is available in two release types:

Development Builds

Development builds contain the latest features and improvements. These are available via GitHub Actions:

• Download Development Builds

Note: Development builds may contain experimental features and could be less stable than full releases.

Full Releases

Stable releases are available on the releases page:

• Download Latest Release

Recommended for: Most users who want a stable experience.

Installing on Windows

Using the Installer (.exe)

1. Download the .exe installer from the releases page
2. Run the installer executable
3. Follow the setup wizard:
   • Choose installation location (default: C:\Users\<YourName>\AppData\Local\DesQTA)
   • Choose whether to create desktop shortcut
   • Choose whether to add to Start Menu
4. Click "Install"
5. DesQTA will be installed and ready to use

First Launch on Windows

• DesQTA will appear in your Start Menu
• Desktop shortcut (if created) can be double-clicked
• You may see Windows Defender SmartScreen warning - click "More info" → "Run anyway" (this is normal for unsigned applications)

System Requirements

• Windows 10 or later (64-bit)
• RAM: 4GB minimum, 8GB recommended
• Storage: 500MB free space
• Internet: Required for initial setup and SEQTA access

Installing on macOS

Using the Disk Image (.dmg)

1. Download the .dmg file from the releases page
2. Open the .dmg file (double-click)
3. Drag DesQTA to your Applications folder
4. Eject the disk image
5. Open DesQTA from Applications

First Launch on macOS

1. Open DesQTA from Applications
2. You may see a security warning: "DesQTA cannot be opened because it is from an unidentified developer"
3. To allow it:
   • Go to System Preferences → Security & Privacy
   • Click "Open Anyway" next to the DesQTA message
   • Or right-click DesQTA → Open → Open in the dialog

System Requirements

• macOS 10.15 (Catalina) or later
• RAM: 4GB minimum, 8GB recommended
• Storage: 500MB free space
• Internet: Required for initial setup and SEQTA access

Apple Silicon (M1/M2/M3) Support

DesQTA supports both Intel and Apple Silicon Macs:

• Native Apple Silicon builds available
• Universal binaries supported
• Optimized performance on M-series chips

Installing on Linux

Using AppImage

1. Download the .AppImage file from the releases page
2. Make it executable:
   chmod +x DesQTA.AppImage
   

3. Run it:
   ./DesQTA.AppImage
   

Note: AppImage files are portable and don't require installation. You can move them anywhere and run them.

Using .deb Package (Debian/Ubuntu)

1. Download the .deb package from the releases page
2. Install using your package manager:
   sudo dpkg -i DesQTA.deb
   

3. If dependencies are missing, fix them:
   sudo apt-get install -f
   

Using .rpm Package (Fedora/RHEL)

1. Download the .rpm package from the releases page
2. Install using:
   sudo rpm -i DesQTA.rpm
   

   Or with DNF:
   sudo dnf install DesQTA.rpm
   

System Requirements

• Linux: Most modern distributions (Ubuntu 20.04+, Fedora 34+, etc.)
• RAM: 4GB minimum, 8GB recommended
• Storage: 500MB free space
• Internet: Required for initial setup and SEQTA access
• Dependencies: Usually included, but may need libfuse2 for AppImage

Installing on Mobile Devices

Android

1. Download the .apk file from the releases page
2. Enable "Install from Unknown Sources" in Android settings
3. Open the downloaded .apk file
4. Follow the installation prompts
5. Launch DesQTA from your app drawer

iOS

iOS installation requires:

• TestFlight: Join the beta program (coming soon)
• App Store: When available (coming soon)

Note: iOS builds may have limited availability depending on Apple's review process.

Verifying Installation

After installation, verify DesQTA is working:

1. Launch DesQTA
2. You should see the login screen
3. If you see any errors, check:
   • System requirements are met
   • Antivirus isn't blocking the app
   • Required permissions are granted

Updating DesQTA

Automatic Updates

DesQTA can check for updates automatically:

• Go to Settings → Updates
• Enable "Check for updates automatically"
• Updates will be downloaded and installed automatically

Manual Updates

1. Download the latest version from GitHub releases
2. Install over the existing installation
3. Your settings and data will be preserved

Uninstalling DesQTA

Windows

1. Go to Settings → Apps → Apps & Features
2. Find "DesQTA"
3. Click "Uninstall"
4. Follow the uninstall wizard

macOS

1. Open Applications folder
2. Drag DesQTA to Trash
3. Empty Trash to complete removal

Note: Settings and data are stored in ~/Library/Application Support/DesQTA - delete this folder to remove all data.

Linux

AppImage:

• Simply delete the .AppImage file

Package Manager:

# Debian/Ubuntu
sudo apt-get remove desqta

# Fedora/RHEL
sudo dnf remove desqta

Troubleshooting Installation

Windows Issues

"Windows protected your PC" warning:

• This is normal for unsigned applications
• Click "More info" → "Run anyway"
• Consider adding DesQTA to Windows Defender exclusions

Installation fails:

• Run installer as Administrator
• Check available disk space
• Disable antivirus temporarily
• Check Windows Event Viewer for errors

macOS Issues

"Cannot be opened" error:

• Right-click → Open → Open in dialog
• Or go to System Preferences → Security & Privacy → Open Anyway

Gatekeeper warnings:

• Normal for non-App Store applications
• Follow the steps above to allow

Linux Issues

AppImage won't run:

• Ensure it's executable: chmod +x DesQTA.AppImage
• Check if libfuse2 is installed
• Try running from terminal to see error messages

Package installation fails:

• Update your package manager: sudo apt update or sudo dnf update
• Install missing dependencies
• Check package architecture matches your system (64-bit vs 32-bit)

Next Steps

After installation, proceed to:

• First Launch - Set up DesQTA for the first time
• Authentication - Learn how to log in