# Installation

Install Foxora Desktop on Windows or macOS, or use the Foxora CLI and web app on Linux while the Linux desktop build is being prepared.

![Installation in Foxora v5.0.3](/docs/images/v5.0.3/auth/sign-in-native.webp)

## Before you begin

You need a Foxora account and an internet connection for sign-in, updates, model requests, and first-run provisioning. For a comfortable experience, use a computer with at least 8 GB of RAM and approximately 1 GB of free disk space.

Download Foxora only from the official Foxora download page or the official `foxora-ai/releases` repository. Do not install a file received through email, chat, or an unofficial mirror.

| Platform | Supported option | Package |
| --- | --- | --- |
| Windows 10/11, x64 | Foxora Desktop and Foxora CLI | `.exe` installer |
| macOS 12 or newer | Foxora Desktop and Foxora CLI | Signed universal `.dmg` |
| Linux | Foxora CLI and web app; desktop is not currently published | Shell installer |

## Windows

Foxora supports 64-bit Windows 11 and Windows 10 version 22H2. The desktop installer is a per-user installation, so a normal installation should not require administrator access.

### Install Foxora Desktop

1. Open the official Foxora download page and select **Windows**.
2. Download the Windows x64 installer it offers — the filename carries the release, for example `Foxora_5.0.4_x64-setup.exe`.
3. Open the installer. Windows may show a SmartScreen warning while Foxora completes code-signing.
4. Follow the installer prompts. Foxora installs the desktop application, Foxora Core, and its browser runtime.
5. If Microsoft Edge WebView2 or the Microsoft Visual C++ x64 runtime is missing, the installer downloads and installs the required component automatically.
6. Launch Foxora from the Start menu or desktop shortcut.

> **Windows SmartScreen.** We're in the middle of code-signing for Windows. If you hit a SmartScreen warning, click **More info**, then click **Run anyway**.

### Windows first launch

1. Allow the local Foxora Core service a few moments to start.
2. Select **Sign in**. Foxora opens the secure account flow in your default browser.
3. Complete sign-in and return to the desktop app when the browser prompts you.
4. Finish the system check and review the default autonomy setting.
5. Create a task and send a small request to confirm that the runtime, gateway, and workspace are ready.

### Optional: install the Windows CLI

Open PowerShell and run:

```powershell
irm https://foxora.ai/install.ps1 | iex
```

Then verify the command and finish setup:

```powershell
foxora --version
foxora setup
foxora login
```

## macOS

Foxora supports macOS 12 Monterey or newer. Every macOS build is notarized.

### Download the current package

The download page detects your Mac and offers the right image, so you do not have to choose. Two are published:

| Image | Runs on | Why pick it |
| --- | --- | --- |
| `Foxora_<version>_universal.dmg` | Apple Silicon and Intel | The safe choice on any Mac, and the only one that works on Intel |
| `Foxora_<version>_AppleSilicon.dmg` | Apple Silicon only | Roughly half the download size |

If you are scripting an install or are unsure which Mac you are on, take the universal image.

### Install Foxora Desktop

1. Download the appropriate `.dmg` from the official Foxora download page.
2. Open the downloaded disk image.
3. Drag **Foxora** into the **Applications** folder.
4. Eject the Foxora disk image.
5. Open Foxora from **Applications** or Spotlight.
6. Complete sign-in in your browser, then return to Foxora.

Foxora’s public macOS build is signed and notarized. On first use, macOS may request access to files, browser control, Accessibility, or Screen Recording when you enable a feature that needs it. Grant only the capabilities you intend to use; you can review them later in **System Settings → Privacy & Security**.

### Optional: install the macOS CLI

Run the official shell installer:

```bash
curl -fsSL https://foxora.ai/install-cli.sh | sh
```

Open a new terminal, then run:

```bash
foxora --version
foxora setup
foxora login
```

## Linux

The Foxora Desktop package for Linux is not published in the current desktop release. Do not download unofficial AppImage, `.deb`, or `.rpm` packages claiming to be the current Foxora Desktop build.

You can use the full web app or install the native Foxora CLI on a glibc-based distribution such as Ubuntu, Debian, Fedora, or Arch Linux.

### Install the Linux CLI

1. Confirm that `curl` and `tar` are installed.
2. Run the official installer:

   ```bash
   curl -fsSL https://foxora.ai/install-cli.sh | sh
   ```

3. Open a new terminal so the updated `PATH` is loaded.
4. Provision the local runtime and sign in:

   ```bash
   foxora --version
   foxora setup
   foxora login
   ```

5. Start the interactive terminal:

   ```bash
   foxora
   ```

For a one-off task, run:

```bash
foxora run "summarize this project"
```

### Use Foxora without installing

Open `https://app.foxora.ai` in a supported browser and sign in with the same Foxora account. The web app is the recommended graphical option on Linux until an official desktop package is published.

## Verify your installation

After installation or CLI setup:

1. Confirm that Foxora shows your account and the main Tasks, Projects, and Studio navigation.
2. Create a new task.
3. Attach a small test folder only if the task needs file access.
4. Keep **Ask Permissions** enabled for the first run.
5. Ask Foxora to explain the test folder or answer a simple question.
6. Confirm that the task finishes normally and that any requested permission is shown before the action occurs.

## Common installation problems

| Problem | What to check |
| --- | --- |
| Windows installer does not open | Confirm Windows 10 22H2 or Windows 11, x64. If SmartScreen appears, select **More info**, then **Run anyway**. |
| WebView2 installation fails | Check the internet connection, install pending Windows updates, and run the Foxora installer again. |
| Browser sign-in does not return to Foxora | Leave Foxora open, finish the browser flow, and allow the `foxora://` link to open the app. |
| `foxora` is not found after CLI installation | Open a new terminal and confirm that the installer’s bin directory is on `PATH`. |
| Linux desktop download is unavailable | Use the Foxora web app or CLI; the desktop build has not shipped yet. |

## Next steps

- Review **System requirements** for platform-specific hardware and software details.
- Continue to **First-run setup** to configure permissions, models, and autonomy.
- Follow **Quickstart: complete your first task** to verify the complete workflow.
- See **Updating Foxora** before changing versions or replacing an existing installation.