Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
An omni-channel customer engagement platform: connect user data through Segment, reverse ETL or an API, build segments, design templates in HTML, MJML or a low-code editor, and send broadcasts or event-driven journeys over email, push, SMS, WhatsApp or Slack. The Lite image bundles the API, dashboard and worker and needs PostgreSQL, ClickHouse and Temporal beside it. Email goes out through a provider such as SendGrid or Amazon SES that you connect.
Runs on a VPS from $24/mo (Kamatera 8GB, 8 GB RAM) · prices checked Nov 2026
Fits home hardware (878 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick Dittofeed when you want to message your own app's users from event data rather than send one newsletter to a list. You connect user data through Segment, reverse ETL or its API, build segments, design templates in HTML, MJML or a low-code editor, and send broadcasts or event-driven journeys over email, push, SMS, WhatsApp or Slack. It is MIT-licensed TypeScript. Our snippet runs `dittofeed/dittofeed-lite:v0.23.0`, the latest non-prerelease (GitHub release 2025-12-01), from the `docker-compose.lite.yaml` at that tag, with PostgreSQL 15.15, ClickHouse 24.12.6.70 and Temporal 1.22.4. The newer Docker Hub tags are `v0.24.0` alphas (the newest is `alpha.21`, 2026-10-04) and we did not use them. We generated the database, ClickHouse and dashboard passwords and the session key, and dropped the optional admin-cli, temporal-ui and blob-storage services. Upstream gives no RAM minimum, only default container caps of 1024 MB for the app and 2048 MB for ClickHouse, so our 4096 MB floor is an estimate. In the catalog, listmonk, Keila and phpList are list-and-campaign newsletter tools and Mautic is a marketing-automation suite; Dittofeed is built around per-user events and journeys, and needs four containers to do it.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Dittofeed Lite — customer messaging and journeys — adapted from docker-compose.lite.yaml at tag v0.23.0, the latest stable release (image dittofeed/dittofeed-lite:v0.23.0)
# Changed from upstream: credentials generated into .env, Postgres pinned to 15.15, only port 3000 published, admin-cli, temporal-ui and blob-storage profile services left out
mkdir dittofeed && cd dittofeed
mkdir temporal-dynamicconfig
curl -fsSL https://raw.githubusercontent.com/dittofeed/dittofeed/v0.23.0/packages/backend-lib/temporal-dynamicconfig/prod.yaml -o temporal-dynamicconfig/prod.yaml
cat > .env <<EOF
DATABASE_PASSWORD=$(openssl rand -hex 16)
CLICKHOUSE_PASSWORD=$(openssl rand -hex 16)
PASSWORD=$(openssl rand -hex 12)
SECRET_KEY=$(openssl rand -base64 32)
EOF
cat > docker-compose.yml <<'EOF'
x-database-credentials: &database-credentials
DATABASE_USER: postgres
DATABASE_PASSWORD: ${DATABASE_PASSWORD}
x-clickhouse-credentials: &clickhouse-credentials
CLICKHOUSE_USER: dittofeed
CLICKHOUSE_PASSWORD: ${CLICKHOUSE_PASSWORD}
x-backend-app-env: &backend-app-env
<<: [*clickhouse-credentials, *database-credentials]
NODE_ENV: production
DATABASE_HOST: postgres
DATABASE_PORT: 5432
CLICKHOUSE_HOST: http://clickhouse-server:8123
TEMPORAL_ADDRESS: temporal:7233
WORKSPACE_NAME: Default
AUTH_MODE: single-tenant
SECRET_KEY: ${SECRET_KEY}
PASSWORD: ${PASSWORD}
DASHBOARD_API_BASE: http://localhost:3000
services:
lite:
image: dittofeed/dittofeed-lite:v0.23.0
restart: always
command: node --max-old-space-size=824 ./packages/lite/dist/scripts/startLite.js --workspace-name=Default
logging:
driver: "local"
deploy:
resources:
limits:
memory: 1024m
ports:
- "3000:3000"
depends_on:
- postgres
- temporal
- clickhouse-server
environment:
<<: *backend-app-env
BOOTSTRAP: "true"
networks:
- dittofeed-network-lite
temporal:
container_name: temporal
restart: always
logging:
driver: "local"
depends_on:
- postgres
environment:
- DB=postgresql
- DB_PORT=5432
- POSTGRES_USER=postgres
- POSTGRES_PWD=${DATABASE_PASSWORD}
- POSTGRES_SEEDS=postgres
- DYNAMIC_CONFIG_FILE_PATH=config/dynamicconfig/prod.yaml
image: temporalio/auto-setup:1.22.4
networks:
- dittofeed-network-lite
volumes:
- ./temporal-dynamicconfig:/etc/temporal/config/dynamicconfig
postgres:
image: postgres:15.15
restart: always
logging:
driver: "local"
environment:
- POSTGRES_PASSWORD=${DATABASE_PASSWORD}
- POSTGRES_USER=postgres
- POSTGRES_DB=dittofeed
volumes:
- postgres:/var/lib/postgresql/data
networks:
- dittofeed-network-lite
clickhouse-server:
image: clickhouse/clickhouse-server:24.12.6.70-alpine
restart: always
logging:
driver: "local"
deploy:
resources:
limits:
memory: 2048m
environment:
<<: *clickhouse-credentials
volumes:
- clickhouse_lib:/var/lib/clickhouse
- clickhouse_log:/var/log/clickhouse-server
networks:
- dittofeed-network-lite
volumes:
postgres:
clickhouse_lib:
clickhouse_log:
networks:
dittofeed-network-lite:
driver: bridge
name: dittofeed-network-lite
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:3000/api; do sleep 3; done'
# → http://SERVER_IP:3000 (open /dashboard and sign in with the PASSWORD value from .env; for access from another machine set DASHBOARD_API_BASE and add DASHBOARD_URL in docker-compose.yml with this address and recreate)Dittofeed's README, docs and Compose file flag these before you rely on it:
Dittofeed used 878 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 4096 MB.
The Dittofeed install snippet is marked verified on Ubuntu 26.04 (Nov 2026).