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

# Installation

> Download and install bundl on your platform

bundl is a native desktop application available for macOS, Windows, and Linux. No browser extensions, no web app – just a fast, secure application running on your machine.

## System Requirements

| Platform | Minimum Version            |
| -------- | -------------------------- |
| macOS    | 11.0 (Big Sur) or later    |
| Windows  | 10 (64-bit) or later       |
| Linux    | Ubuntu 20.04 or equivalent |

**Hardware:**

* 4GB RAM
* 100MB disk space
* Internet connection (for blockchain operations)

***

## macOS Installation

### Download

1. Go to [bundlit.dev](https://bundlit.dev/#download)
2. Click **Download for macOS**
3. Choose the correct version:
   * **Apple Silicon** (M1/M2/M3): `bundl_x.x.x_aarch64.dmg`
   * **Intel**: `bundl_x.x.x_x64.dmg`

### Install

1. Open the downloaded `.dmg` file
2. Drag **bundl** to your **Applications** folder
3. Eject the disk image

### First Launch

<Warning>
  Since bundl is not signed with an Apple Developer certificate yet, you'll see a security warning on first launch.
</Warning>

**To open bundl:**

1. Open **Finder** → **Applications**
2. **Right-click** (or Control-click) on **bundl**
3. Select **Open**
4. Click **Open** in the dialog

You only need to do this once. After that, bundl will open normally.

<Tip>
  Alternatively, go to **System Preferences** → **Security & Privacy** → **General** and click "Open Anyway" after attempting to launch bundl.
</Tip>

***

## Windows Installation

### Download

1. Go to [bundlit.dev](https://bundlit.dev/#download)
2. Click **Download for Windows**
3. Download `bundl_x.x.x_x64-setup.exe`

### Install

1. Run the downloaded `.exe` installer
2. If you see a SmartScreen warning:
   * Click **More info**
   * Click **Run anyway**
3. Follow the installation wizard
4. Choose installation location (default is fine)
5. Click **Install**

### Launch

* Find **bundl** in your Start menu
* Or double-click the desktop shortcut

***

## Linux Installation

### Debian/Ubuntu (.deb)

1. Download the `.deb` package from [bundlit.dev](https://bundlit.dev/#download)
2. Install:

```bash theme={null}
sudo dpkg -i bundl_x.x.x_amd64.deb

sudo apt-get install -f
```

### AppImage (Universal)

1. Download the AppImage from [bundlit.dev](https://bundlit.dev/#download)
2. Make it executable and run:

```bash theme={null}
chmod +x bundl_x.x.x_amd64.AppImage

./bundl_x.x.x_amd64.AppImage
```

<Tip>
  For easier launching, move the AppImage to `~/.local/bin/` and create a desktop entry.
</Tip>

***

## Verifying Your Download

For security, verify the integrity of your download:

### Check SHA-256 Hash

Each release includes a `checksums.txt` file with SHA-256 hashes.

**macOS/Linux:**

```bash theme={null}
shasum -a 256 bundl_x.x.x_aarch64.dmg
```

**Windows (PowerShell):**

```powershell theme={null}
Get-FileHash bundl_x.x.x_x64-setup.exe -Algorithm SHA256
```

Compare the output with the hash in `checksums.txt`.

***

## Updating bundl

When a new version is available, you'll see a notification banner at the top of the app:

```
⭐ New version available! v1.0.0 → v1.1.0 [download]
```

Click **\[download]** to open the releases page and download the latest version.

<Info>
  Auto-updates are planned for a future release. For now, download the latest version from the releases page.
</Info>

***

## Uninstalling

### macOS

1. Open **Finder** → **Applications**
2. Drag **bundl** to the **Trash**
3. To remove data: delete `~/Library/Application Support/com.bundl.desktop/`

### Windows

1. Open **Settings** → **Apps**
2. Find **bundl** and click **Uninstall**
3. To remove data: delete `%APPDATA%\com.bundl.desktop\`

### Linux

```bash theme={null}
sudo apt remove bundl

rm -rf ~/.local/share/com.bundl.desktop/
```

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="App won't open on macOS">
    Right-click the app and select "Open" instead of double-clicking. See the [First Launch](#first-launch) section above.
  </Accordion>

  <Accordion title="Windows SmartScreen blocking installation">
    Click "More info" then "Run anyway". This happens because the app isn't signed with a Windows certificate yet.
  </Accordion>

  <Accordion title="Linux: Missing dependencies">
    Run `sudo apt-get install -f` after installing the .deb package to resolve missing dependencies.
  </Accordion>

  <Accordion title="App crashes on launch">
    Try deleting the app data folder and restarting:

    * macOS: `~/Library/Application Support/com.bundl.desktop/`
    * Windows: `%APPDATA%\com.bundl.desktop\`
    * Linux: `~/.local/share/com.bundl.desktop/`
  </Accordion>
</AccordionGroup>

***

## Next Steps

<Card title="Quick Start" icon="rocket" href="/getting-started/quickstart">
  Create your first wallet and start using bundl
</Card>