Skip to main content
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

The installer automatically detects your system and configures CaseBender with optimal settings.
For Apple Silicon (M1/M2/M3) and Intel Macs

DMG Installer (Apple Silicon)

Recommended for M1/M2/M3 Macs

DMG Installer (Intel)

For Intel-based Macs
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”

​
System Requirements

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.

​
Features

One-Click Deploy

Deploy CaseBender with a single click. No command line required.

Auto Configuration

Automatically generates secure credentials and SSL certificates.

Service Management

Start, stop, and monitor all CaseBender services from a unified dashboard.

Easy Updates

Update to a signed, version-pinned release with one click.

​
What Gets Installed

The installer deploys the following services:
  • CaseBender Web App - Main application
  • PostgreSQL - Database
  • Redis - Authenticated cache and message queue
  • OpenSearch - Authenticated search service
  • Workflow Processor - Background job processing
  • MISP Processor - Threat intelligence integration
  • MinIO - Object storage for attachments
  • Nginx - The only host-facing service (ports 80 and 443)
Application and data-service ports stay on the private Docker network.

​
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
  5. Complete activation - Follow the local /setup page to create the first administrator
The activation page is served by your own CaseBender installation. It does not require CaseBender to be reachable from the public internet.

​
First administrator

The installer generates installation-specific infrastructure secrets. It does not create a shared production administrator password. Use the short-lived code displayed by the installer on the /setup page, then choose the administrator email and password. Store the password in your enterprise password manager and enroll MFA. See First-run setup.

​
Troubleshooting

​
Docker Not Found

If the installer can’t find Docker:
  1. Install 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 for Docker Compose setup instructions.

​
All Releases

Community installers are published through the public CaseBender download links above, not through the private source repository. Production operators should archive the exact installer, checksum, and image manifest used for each deployment.