Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A recipe manager and meal planner that imports recipes from recipe sites and, with an AI provider set up, from YouTube, Instagram, photos and pasted text, scales servings and converts between US and metric units, and keeps a shared meal calendar and a grocery list that syncs in real time. Sign-in is by email and password, OIDC, GitHub or Google, and the interface works offline. Upstream labels every release beta. A separate Obscura headless-browser container renders pages that a direct fetch cannot read.
Runs on a VPS from $6/mo (Kamatera 2GB, 2 GB RAM) · prices checked Nov 2026
Fits home hardware (495 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 Norish when a household wants a recipe manager that imports from a link, a pasted text or a photo, plans the week on a shared calendar and keeps a grocery list that syncs live between phones. It scales servings, switches between US and metric units, and runs offline; sign-in is email and password out of the box, with OIDC, GitHub or Google as options. It is AGPL-3.0 TypeScript on Next.js with PostgreSQL and Valkey. Our snippet follows the README Compose file with the images pinned to `norishapp/norish:v0.26.1-beta` (released 2026-11-05), `norishapp/obscura:0.2.5-norish.1` (pushed to Docker Hub 2026-10-29), `postgres:17.11-alpine` and `valkey/valkey:9.1.3`, the `MASTER_KEY`, the Obscura token and the database password generated into `.env`, and health checks that hold the app back until Postgres and Valkey answer. Upstream publishes no RAM minimum that we found, so our 1024 MB floor is an estimate for four containers. In the catalog, Mealie runs as one container on SQLite, Tandoor adds PostgreSQL search and a bundled nginx, KitchenOwl is built around the shared shopping list, Bar Assistant is for cocktails and RecipeSage limits its licence to non-commercial use; Norish is the one with a live-synced grocery list and calendar, an offline interface and a separate headless browser for imports, at the cost of a project that still calls every release beta.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Norish — recipe manager with URL import, meal planner and shared grocery list — adapted from the README Compose file, image pinned to v0.26.1-beta
# Changed from upstream: images pinned (norish v0.26.1-beta, obscura 0.2.5-norish.1, postgres 17.11, valkey 9.1.3), MASTER_KEY, OBSCURA_CDP_TOKEN and the database password generated into .env, Postgres and Valkey healthchecks gate startup
mkdir norish && cd norish
echo "MASTER_KEY=$(openssl rand -base64 32)" > .env
echo "OBSCURA_CDP_TOKEN=$(openssl rand -hex 32)" >> .env
echo "POSTGRES_PASSWORD=$(openssl rand -hex 16)" >> .env
cat > docker-compose.yml <<'EOF'
services:
norish:
image: norishapp/norish:v0.26.1-beta
container_name: norish-app
restart: always
ports:
- "3000:3000"
volumes:
- norish_data:/app/uploads
environment:
AUTH_URL: http://localhost:3000
DATABASE_URL: postgres://postgres:${POSTGRES_PASSWORD}@db:5432/norish
MASTER_KEY: ${MASTER_KEY}
OBSCURA_ENDPOINT: ws://obscura:9222
OBSCURA_CDP_TOKEN: ${OBSCURA_CDP_TOKEN}
VALKEY_URL: valkey://valkey:6379
UPLOADS_DIR: /app/uploads
healthcheck:
test:
[
"CMD-SHELL",
'node -e "require(''http'').get(''http://localhost:3000'' + (process.env.NEXT_PUBLIC_BASE_PATH || '''') + ''/api/v1/health/live'', r => process.exit(r.statusCode===200?0:1))"',
]
interval: 1m
timeout: 15s
retries: 3
start_period: 1m
depends_on:
db:
condition: service_healthy
valkey:
condition: service_healthy
db:
image: postgres:17.11-alpine
container_name: norish-db
restart: unless-stopped
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: norish
volumes:
- db_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres -d norish"]
interval: 10s
timeout: 5s
retries: 10
obscura:
image: norishapp/obscura:0.2.5-norish.1
container_name: norish-obscura
restart: unless-stopped
environment:
OBSCURA_CDP_TOKEN: ${OBSCURA_CDP_TOKEN}
valkey:
image: valkey/valkey:9.1.3
container_name: norish-valkey
restart: unless-stopped
volumes:
- valkey_data:/data
healthcheck:
test: ["CMD", "valkey-cli", "ping"]
interval: 10s
timeout: 5s
retries: 10
volumes:
db_data:
norish_data:
valkey_data:
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:3000/api/v1/health/ready; do sleep 3; done'
# → http://SERVER_IP:3000 (the first account you register becomes the admin and registration then turns off; if sign-in fails from another machine, set AUTH_URL in docker-compose.yml to that address)Norish's README, docs and release list flag these before you rely on it:
Norish used 495 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 1024 MB.
The Norish install snippet is marked verified on Ubuntu 26.04 (Nov 2026).