> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Download and install BRICKS Foundation

## Download

<Tabs>
  <Tab title="iOS">
    Download BRICKS Foundation from the App Store:

    <Card title="Download for iOS" icon="apple" href="https://apps.apple.com/en/app/bricks-foundation/id1475868523">
      BRICKS Foundation on the App Store
    </Card>

    Requires iOS 14 or later. Supports iPhone and iPad.
  </Tab>

  <Tab title="Android">
    Download from Google Play or install an APK directly:

    <Card title="Download for Android" icon="android" href="https://play.google.com/store/apps/details?id=tools.bricks.foundation">
      BRICKS Foundation on Google Play
    </Card>

    **Direct APK downloads:**

    <CardGroup cols={2}>
      <Card title="Android ARM" icon="download" href="https://cdn.bricks.tools/bricks-launcher/beta/bricks-launcher-arm-release.apk">
        bricks-launcher-arm-release.apk
      </Card>

      <Card title="Android ARM64" icon="download" href="https://cdn.bricks.tools/bricks-launcher/beta/bricks-launcher-arm64-release.apk">
        bricks-launcher-arm64-release.apk
      </Card>

      <Card title="Android ARM64 (QNN)" icon="download" href="https://cdn.bricks.tools/bricks-launcher/beta/bricks-launcher-arm64-qnn-release.apk">
        bricks-launcher-arm64-qnn-release.apk
      </Card>
    </CardGroup>

    Requires Android 8.0 or later.
  </Tab>

  <Tab title="macOS">
    **Homebrew:**

    ```bash theme={null}
    brew install --cask mybigday/bricks/bricks-desktop-foundation
    ```

    **Manual download:**

    <CardGroup cols={2}>
      <Card title="macOS (ARM64)" icon="apple" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-arm64.dmg">
        BRICKS-arm64.dmg
      </Card>

      <Card title="macOS (x64)" icon="apple" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-x64.dmg">
        BRICKS-x64.dmg
      </Card>
    </CardGroup>

    Open the DMG and drag the app to your Applications folder. The app is notarized by Apple. On first launch, macOS may show a security prompt — click **Open** to proceed.
  </Tab>

  <Tab title="Windows">
    <CardGroup cols={2}>
      <Card title="Windows (x64)" icon="windows" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-x64.exe">
        BRICKS-x64.exe
      </Card>

      <Card title="Windows (ARM64)" icon="windows" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-arm64.exe">
        BRICKS-arm64.exe
      </Card>
    </CardGroup>

    Run the installer and follow the prompts. Windows may show a SmartScreen warning — click **More info** > **Run anyway** to proceed.
  </Tab>

  <Tab title="Linux">
    **Quick install:**

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-launcher/release/desktop/install.sh | sh
    ```

    The script auto-detects your architecture, downloads the AppImage to `~/.local/bin/bricks`, installs the `libfuse2` runtime dependency via your distro's package manager when missing, and optionally creates a desktop entry.

    To uninstall:

    ```bash theme={null}
    curl -fsSL https://cdn.bricks.tools/bricks-launcher/release/desktop/uninstall.sh | sh
    ```

    **Manual download:**

    <CardGroup cols={2}>
      <Card title="Linux (x86_64)" icon="linux" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-x86_64.AppImage">
        BRICKS-x86\_64.AppImage
      </Card>

      <Card title="Linux (ARM64)" icon="linux" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-arm64.AppImage">
        BRICKS-arm64.AppImage
      </Card>
    </CardGroup>

    ```bash theme={null}
    chmod +x BRICKS-x86_64.AppImage
    ./BRICKS-x86_64.AppImage
    ```

    <Note>
      The AppImage requires `libfuse2` (FUSE 2) at runtime. Many recent distros do not ship it by default. The quick-install script installs it automatically; for manual downloads, install it yourself:

      | Distro                    | Command                        |
      | ------------------------- | ------------------------------ |
      | Debian / Ubuntu (≤ 22.04) | `sudo apt install libfuse2`    |
      | Ubuntu 24.04+             | `sudo apt install libfuse2t64` |
      | Fedora / RHEL             | `sudo dnf install fuse-libs`   |
      | Arch                      | `sudo pacman -S fuse2`         |
      | openSUSE                  | `sudo zypper install libfuse2` |
      | Alpine                    | `sudo apk add fuse`            |
    </Note>
  </Tab>

  <Tab title="Raspberry Pi">
    <Card title="Raspberry Pi (64-bit)" icon="microchip" href="https://cdn.bricks.tools/bricks-launcher/release/desktop/BRICKS-pi64.zip">
      BRICKS-pi64.zip
    </Card>

    Extract the archive and run:

    ```bash theme={null}
    unzip BRICKS-pi64.zip
    cd BRICKS-pi64
    ./start.sh
    ```

    Requires a Raspberry Pi 4 or later with a 64-bit OS.
  </Tab>
</Tabs>

## Auto-updates

BRICKS Foundation checks for updates automatically on desktop platforms. Mobile versions update through the App Store or Google Play.

## Next steps

<Card title="Bind your device" icon="link" href="/foundation/device-binding">
  Connect your device to a BRICKS workspace.
</Card>