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

# Desktop Installer

> One-click installer for deploying CaseBender locally

The CaseBender Desktop Installer is the easiest way to deploy CaseBender on your local machine. It handles Docker setup, configuration, and service management automatically.

## Download Installer

<Note>
  The installer automatically detects your system and configures CaseBender with optimal settings.
</Note>

<Tabs>
  <Tab title="macOS">
    **For Apple Silicon (M1/M2/M3) and Intel Macs**

    <CardGroup cols={2}>
      <Card title="DMG Installer (Apple Silicon)" icon="microchip" href="https://p5lt3orxujizwets.public.blob.vercel-storage.com/installers/latest/CaseBender-Installer-arm64.dmg">
        Recommended for M1/M2/M3 Macs
      </Card>

      <Card title="DMG Installer (Intel)" icon="microchip" href="https://p5lt3orxujizwets.public.blob.vercel-storage.com/installers/latest/CaseBender-Installer.dmg">
        For Intel-based Macs
      </Card>
    </CardGroup>

    **Installation:**

    1. Download the DMG file for your Mac
    2. Open the DMG and drag CaseBender Installer to Applications
    3. Launch from Applications folder
    4. If prompted about unidentified developer, right-click and select "Open"
  </Tab>

  <Tab title="Windows">
    **For Windows 10/11 (64-bit)**

    <CardGroup cols={2}>
      <Card title="Windows Installer" icon="download" href="https://p5lt3orxujizwets.public.blob.vercel-storage.com/installers/latest/CaseBender-Installer-Setup.exe">
        Recommended installer with auto-updates
      </Card>

      <Card title="Portable Version" icon="folder" href="https://p5lt3orxujizwets.public.blob.vercel-storage.com/installers/latest/CaseBender-Installer-portable.exe">
        No installation required
      </Card>
    </CardGroup>

    **Installation:**

    1. Download the installer
    2. Run the installer (you may need to click "More info" → "Run anyway" if Windows SmartScreen appears)
    3. Follow the installation wizard
    4. Launch CaseBender Installer from the Start menu
  </Tab>

  <Tab title="Linux">
    **For Ubuntu, Debian, and other distributions**

    <CardGroup cols={2}>
      <Card title="AppImage (Universal)" icon="box" href="https://p5lt3orxujizwets.public.blob.vercel-storage.com/installers/latest/CaseBender-Installer.AppImage">
        Works on most Linux distributions
      </Card>

      <Card title="DEB Package" icon="download" href="https://p5lt3orxujizwets.public.blob.vercel-storage.com/installers/latest/CaseBender-Installer.deb">
        For Debian/Ubuntu-based systems
      </Card>
    </CardGroup>

    **Installation (AppImage):**

    ```bash theme={null}
    chmod +x CaseBender-Installer.AppImage
    ./CaseBender-Installer.AppImage
    ```

    **Installation (DEB):**

    ```bash theme={null}
    sudo dpkg -i CaseBender-Installer.deb
    sudo apt-get install -f  # Install dependencies if needed
    ```
  </Tab>
</Tabs>

## System Requirements

| Component      | Minimum                                  | Recommended |
| -------------- | ---------------------------------------- | ----------- |
| **RAM**        | 8 GB                                     | 16 GB       |
| **Disk Space** | 10 GB                                    | 20 GB       |
| **Docker**     | 20.10+                                   | Latest      |
| **OS**         | macOS 10.15+, Windows 10+, Ubuntu 20.04+ | Latest LTS  |

<Warning>
  Docker Desktop must be installed and running before using the CaseBender Installer. The installer will guide you through Docker installation if it's not detected.
</Warning>

## Features

<CardGroup cols={2}>
  <Card title="One-Click Deploy" icon="rocket">
    Deploy CaseBender with a single click. No command line required.
  </Card>

  <Card title="Auto Configuration" icon="wand-magic-sparkles">
    Automatically generates secure credentials and SSL certificates.
  </Card>

  <Card title="Service Management" icon="server">
    Start, stop, and monitor all CaseBender services from a unified dashboard.
  </Card>

  <Card title="Easy Updates" icon="arrows-rotate">
    Update to the latest version with one click.
  </Card>
</CardGroup>

## What Gets Installed

The installer deploys the following services:

* **CaseBender Web App** - Main application (port 3000)
* **PostgreSQL** - Database (port 5433)
* **Redis** - Cache and message queue (port 6379)
* **Workflow Processor** - Background job processing (port 3001)
* **MISP Processor** - Threat intelligence integration (port 3002)
* **MinIO** - Object storage for attachments (ports 9000, 9090)
* **Nginx** - SSL termination and reverse proxy (ports 80, 443)

## First Launch

After installation:

1. **Start Docker Desktop** - Ensure Docker is running
2. **Launch the Installer** - Open CaseBender Installer
3. **Click "Install"** - The installer will pull images and configure services
4. **Access CaseBender** - Open `https://local.casebender.com` in your browser

## Default Credentials

```
Username: admin@casebender.app
Password: secret1234
```

<Warning>
  Change these credentials immediately after your first login for security.
</Warning>

## Troubleshooting

### Docker Not Found

If the installer can't find Docker:

1. Install [Docker Desktop](https://www.docker.com/products/docker-desktop/)
2. Start Docker Desktop
3. Wait for Docker to fully initialize (green icon in system tray)
4. Restart the CaseBender Installer

### Port Conflicts

If you see port conflict errors:

1. Check which application is using the port: `lsof -i :PORT` (macOS/Linux) or `netstat -ano | findstr :PORT` (Windows)
2. Stop the conflicting application
3. Retry the installation

### macOS Gatekeeper Warning

If macOS blocks the app:

1. Right-click (or Control+click) on the app
2. Select "Open" from the context menu
3. Click "Open" in the dialog

### Windows SmartScreen

If Windows blocks the installer:

1. Click "More info"
2. Click "Run anyway"

## Manual Installation

If you prefer manual installation or need more control, see the [Quickstart Guide](/en/quickstart) for Docker Compose setup instructions.

## All Releases

View all available versions and release notes on our [GitHub Releases](https://github.com/casebender/casebender/releases) page.