# System requirements

Choose the Foxora surface that matches your operating system and whether the task needs access to files on your device.

![System requirements in Foxora v5.0.3](/docs/images/v5.0.3/settings/about.webp)

## Supported platforms

| Surface | Supported platforms | Current release |
| --- | --- | --- |
| Foxora Desktop | macOS 12 or newer; Windows 10 22H2 or Windows 11 x64 | 5.0.3 |
| Foxora CLI | macOS Apple Silicon or Intel; Linux x64 or ARM64; Windows x64 | 5.0.3 |
| Foxora web app | Current Chrome, Edge, Firefox, or Safari | 5.0.3 |

The Linux desktop application is not currently published. Linux users should use the web app or native CLI.

## Hardware and storage

- **Memory:** 8 GB RAM is the practical minimum; 16 GB or more is recommended for large repositories, browser automation, and multiple running tools.
- **Disk:** Keep at least 4 GB free for the desktop application, managed browser, updates, logs, and working data. Projects and generated artifacts require additional space.
- **Processor:** Foxora 5.0.3 for macOS is universal and runs on Apple Silicon or Intel. The published Windows desktop and CLI builds require x64.
- **Display:** A 1280 × 720 viewport is the minimum comfortable desktop workspace. The web interface also supports narrower mobile viewports for review and lightweight tasks.

## Network requirements

Foxora needs HTTPS access to `foxora.ai`, `app.foxora.ai`, `api.foxora.ai`, `engine.foxora.ai`, GitHub Releases, and any providers or plugins you connect. Corporate proxies, VPNs, DNS filters, or outbound firewalls must allow the required WebSocket and server-sent-event connections as well as normal HTTPS traffic.

## Local and web workspace boundaries

| Runtime | File access |
| --- | --- |
| Desktop | Works with folders you explicitly open on the device. |
| CLI | Uses the selected local working directory and local Foxora runtime. |
| Web | Uses its cloud workspace. It does not automatically expose files or tasks stored only on your computer. |

The web runtime creates or resumes an isolated Daytona workspace when cloud execution is needed. New and lifecycle-recreated workspaces use the Foxora v2 image with Node.js, Bun, Git, ripgrep, Chromium, and document-generation support.

## Operating-system permissions

Desktop features may request file access, notifications, microphone access, Accessibility, Screen Recording, or browser-control permissions. Foxora requests these only when the corresponding feature needs them. Grant the minimum access required and review it later in macOS **Privacy & Security** or Windows **Privacy & security** settings.

## Verify compatibility

1. Install the appropriate Foxora surface.
2. Open **Settings → System** or run `foxora doctor`.
3. Confirm the runtime, account, engine, browser, and workspace checks that apply to the device.
4. Create a small task and complete one read-only task.
5. If the task needs files, open a test folder and confirm Foxora reports the expected path before allowing edits.

Successful installation means the interface opens, authentication completes, the runtime reports healthy, and a small task finishes without an unresolved permission or connection error.