# Installation

Install Foxora Desktop on macOS, Windows, or Linux. The installer brings the desktop app, the agent runtime, and a local SDK for working against the gateway.

## System requirements

- macOS 12 (Monterey) or newer — Apple Silicon or Intel
- Windows 10 / 11, 64-bit
- Linux: Ubuntu 22.04 or newer (other distros best-effort)
- 4 GB free disk, 8 GB RAM recommended
- An internet connection for sign-in and gateway requests

## Install Foxora

Pick the tab that matches your operating system.

- 01Install the appmacOSWindowsLinux (AppImage)Linux (deb)# Drag Foxora.app into /Applications, or:
brew install --cask foxoraCopy
- 02Open Foxora for the first timemacOS may ask you to confirm the first launch. Windows SmartScreen might warn about an unsigned publisher — click More info→ Run anyway until we’re fully signed.Windows SmartScreenWe’re in the middle of code-signing for Windows. If you hit a SmartScreen warning, verify the installer’s SHA-256 hash against the value published alongside the release before running it.
- 03Sign in to your Foxora accountOn first launch the app opens a browser window to foxora.ai/auth/callback. After you sign in or sign up, the browser hands the session back to the desktop app via the foxora:// deep link.No account yet?You can create one during this step — or sign up first at foxora.ai/signup. Sign-in works with email + password or a Google account.
- 04Verify the installOnce you’re signed in, the dock and a default agent should appear. From the command line, you can also confirm the bundled CLI is on your path:bashCopyfoxora --version
# → foxora 5.0.1

## What’s next?

- Run your first agent — Quickstart
- Install the desktop app — Installation
- Get an API key — Authentication