selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

bluecherry-apps logo

Self-host bluecherry-apps

v3.1.15

Self-hosted video surveillance with local recording

ReleaseOpen SourceGPL-2.0
Updated9 hours ago
LanguageC
Setup difficultyModerate
MobileNative app
ThemeDark mode
Stars
276
Ports
7001 (HTTPS web UI and API), 7002 (Additional service port)
Requires
MariaDB/MySQL
Docker
bluecherrydvr/bluecherry
Install with Docker Compose
Bluecherry client showing multiple camera views

What is bluecherry-apps?

Bluecherry is a Linux-based video surveillance system for hosting your own recording server with fully local video storage. It works with IP cameras via standard protocols and provides native client apps for Android, iOS, Windows, Linux, and macOS. The server includes motion detection, with vehicle and person detection coming in version 4. Deployment options include Docker Compose with MariaDB, official APT packages for Debian and Ubuntu, or building from source. The licensing model is perpetual: four cameras are free forever, each additional camera costs a one-time $10 fee, and major version upgrades are optional at half price. Version 4 is in preview with a new web UI, REST API, incident evidence bundles, and local AI detection running on your hardware.

Should you self-host bluecherry-apps?

bluecherry-apps scores 48/100 on selfhost.directory (how scoring works) and ranks #15 of 24 in Video Surveillance. It has 276 GitHub stars.

It shipped 1 stable release in the past year. The latest, v3.1.15, came out on 2 October 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-2.0-licensed and written mostly in C.

Its closest alternative on selfhost.directory is Frigate (84/100, 37 031 stars). It scores higher overall, so compare the two before you pick. See bluecherry-apps vs Frigate side by side.

Features

  • Cross-Platform Clients
  • Docker Compose Deployment
  • GPU transcodingRequires host VAAPI support
  • Hardware watchdogPlanned for v4
  • Incident evidence bundlesPlanned for v4
  • Local video recording
  • Native APT packages
  • NFS storage support
  • Perpetual licensing
  • REST APIPlanned for v4
  • SMTP email notifications
  • Vehicle and person detectionAvailable in v4 Community Preview
  • Web UINew web UI in v4 preview

bluecherry-apps README

How to install bluecherry-apps

Install bluecherry-apps with Docker Compose

Docker and Docker Compose installed
Environment variables
TZ, MYSQL_ADMIN_PASSWORD, BLUECHERRY_DB_PASSWORD, BLUECHERRY_DB_HOST, BLUECHERRY_DB_USER, BLUECHERRY_DB_NAME, BLUECHERRY_USERHOST, BLUECHERRY_USER_ID, BLUECHERRY_GROUP_ID, SMTP_SERVER, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD

Automated script clones bluecherry-docker repo, configures .env and .mailenv, pulls images, initializes database, and starts containers

How to configure bluecherry-apps

  • BLUECHERRY_DB_HOSTbc-mysqlDatabase host (service name in docker-compose)

    Database host (service name in docker-compose)

  • BLUECHERRY_DB_NAMEbluecherryDatabase name

    Database name

  • BLUECHERRY_DB_PASSWORDPassword for the bluecherry database user

    Password for the bluecherry database user

  • BLUECHERRY_DB_USERbluecherryDatabase username

    Database username

  • BLUECHERRY_GROUP_ID1000GID to run bluecherry user as

    GID to run bluecherry user as

  • BLUECHERRY_USERHOST%Hostmask for database user access

    Hostmask for database user access

  • BLUECHERRY_USER_ID1000UID to run bluecherry user as

    UID to run bluecherry user as

  • MYSQL_ADMIN_PASSWORDRoot password for MariaDB/MySQL

    Root password for MariaDB/MySQL

  • SMTP_PASSWORDSMTP password

    SMTP password

  • SMTP_PORTSMTP server port

    SMTP server port

  • SMTP_SERVERSMTP server hostname

    SMTP server hostname

  • SMTP_USERNAMESMTP username

    SMTP username

  • TZUTCTimezone for the container (e.g., America/Chicago)

    Timezone for the container (e.g., America/Chicago)

    values: Any valid TZ database timezone

bluecherry-apps releases & version history

More in Video Surveillance

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…