Desktop App Installation
Professional tier. Windows: .exe installer. macOS: .dmg to Applications. Linux: .AppImage or .deb. Configure server URL on first launch, log in.
Desktop App Installation
This guide covers installing the CrystalQore desktop app on Windows, macOS, and Linux. You'll need your organization's CrystalQore server URL and your login credentials.
Windows Installation
Download the installer — Get the .exe installer from your administrator or the CrystalQore download portal.
Run the installer — Double-click the .exe file. If Windows SmartScreen warns, click "More info" → "Run anyway" (only if you trust the source).
Follow the setup wizard — Accept the license, choose install location, and complete installation.
Launch CrystalQore — Open from the Start Menu or desktop shortcut.
Enter CrystalQore server URL — On first launch, enter your organization's URL (e.g., https://crystalqore.yourcompany.com).
Log in — Enter your email and password.
Windows Notes
- Antivirus — Some antivirus software may flag new apps. Add an exception if needed.
- Startup — Option to launch at Windows startup is available in app settings.
- System tray — Icon appears in the system tray when minimized.
macOS Installation
Download the disk image — Get the .dmg file from your administrator or the CrystalQore download portal.
Open the .dmg — Double-click to mount the disk image.
Drag to Applications — Drag the CrystalQore icon to the Applications folder.
Eject the disk image — Drag the volume to Trash or use Eject.
Launch CrystalQore — Open from Applications or Spotlight.
Gatekeeper (first launch) — If macOS blocks the app, go to System Preferences → Security & Privacy → General, and click "Open Anyway".
Enter CrystalQore server URL — On first launch, enter your organization's URL.
Log in — Enter your email and password.
macOS Notes
- Code signing — The app should be signed. If you see "unidentified developer" warnings, use the Security & Privacy workaround above.
- Menu bar — Icon appears in the menu bar when the app is running.
- Notifications — Grant notification permission when prompted for message and call alerts.
Linux Installation
AppImage
Download the AppImage — Get the .AppImage file (e.g., CrystalQore-x86_64.AppImage).
Make executable — chmod +x CrystalQore-x86_64.AppImage
Run — ./CrystalQore-x86_64.AppImage or double-click in your file manager.
Enter CrystalQore server URL — On first launch, enter your organization's URL.
Log in — Enter your email and password.
.deb Package (Debian/Ubuntu)
Download the .deb — Get the .deb package for your architecture.
Install — sudo dpkg -i crystalqore_*.deb (resolve dependencies with sudo apt-get install -f if needed).
Launch — Open CrystalQore from your application menu.
Enter CrystalQore server URL — On first launch, enter your organization's URL.
Log in — Enter your email and password.
Linux Notes
- Dependencies — AppImage is self-contained. .deb may require libgtk, libnotify, etc.; install any missing packages.
- System tray — Requires a systray implementation (e.g., GNOME with extension, KDE, XFCE).
Configuration
Server URL
On first launch, the app prompts for your CrystalQore server URL:
- Format —
https://crystalqore.yourcompany.com(no trailing slash) - HTTPS — Use HTTPS in production
- Change later — You can change the URL in app settings if needed
Credentials
Use the same email and password as the web app. The app stores your session securely (e.g., in the system credential store).
Troubleshooting
| Issue | Solution |
|---|---|
| Cannot connect to server | Verify URL; check network; ensure HTTPS |
| "Invalid credentials" | Confirm email and password; try web login first |
| App won't start | Update to latest version; check OS compatibility; reinstall |
| No system tray icon | Linux: install systray extension or use a supported desktop |
| Click2Dial not working | Ensure app is set as handler for tel: links; check OS default app settings |
Related Documentation
| Page | Description |
|---|---|
| Desktop Apps Overview | Feature overview |
| Getting Started | Using the web app (same features) |