# Crema

Crema is a lightweight Node.js local area network (LAN) messenger for always-on Raspberry Pi displays. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2260/crema

## Description

Crema is a lightweight Node.js local area network (LAN) messenger for always-on Raspberry Pi displays. It lets you send and reply to short messages between Pis and phones via a progressive web app or one-tap screen shortcuts, with per-message time-to-live availability windows and an ambient clock idle view.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 4 of 4 factors.
- Maintained: 63 (last commit 170 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)
- Light to run: 60 (2 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/lowess/crema
- GitHub: https://github.com/Aurel-Charles/crema
- Unraid: https://ca.unraid.net/apps/crema-0jsci4r191ng7z?q=Crema

## Common questions

### How do I add another Pi display to an existing Crema network?

Flash the same Crema image or code to the new Pi. It is discovered automatically over the LAN as a peer.

### Which port should I use for the phone sender?

The PWA sender is served on port 3000 on the Pi. You install it from the Pi's local .local hostname on that port.

### How does Crema know when another Pi has rebooted or lost power?

In addition to mDNS, each Pi actively pings every peer's /me endpoint every 10 seconds. A peer is dropped after 3 missed checks, which catches reboots and power cuts that mDNS goodbyes miss.

### Where are messages and history stored?

Every message is journaled per-Pi in SQLite. The history view tracks message status, and the logs are a filterable event timeline.

### What happens when Do Not Disturb is enabled?

Incoming messages stack in a capped queue instead of taking over the display. The queue preserves arrival times and drains oldest-first when DND is cleared.

### How is the day/night display theme determined?

The display palette shifts automatically at local sunrise and sunset. You configure this with the CREMA_LAT and CREMA_LON environment variables.

---
Source: Our Local Host (https://ourlocalhost.com/app/2260/crema), the self-hosted and open-source app directory.
