Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A self-hosted cocktail recipe manager: a bar with your ingredients and shelf, cocktail recipes with ingredient substitutions, collections, ratings, shopping lists and a 'what can I make' filter, plus import and export of recipes. A Laravel API server (SQLite) with the separate Salt Rim web UI, Meilisearch for search and optional Redis.
Runs on a VPS from $6/mo (Kamatera 2GB, 2 GB RAM) · prices checked Nov 2026
Fits home hardware (78 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 Bar Assistant when you want a recipe manager for drinks rather than food: you record the ingredients you have in your bar, store cocktail recipes with ingredient substitutions, collections, ratings and shopping lists, and filter for what you can make now. It is two projects: the Bar Assistant API server (MIT, PHP/Laravel, SQLite) and Salt Rim, the Vue web UI (also MIT), plus Meilisearch for search and Redis for cache and sessions. Our snippet is the bar-assistant/docker Compose stack with the images pinned to server `6.11.0`, Salt Rim `5.10.0` and Meilisearch `v1.50`, a generated Meilisearch key and the public addresses set from the server's IP. The upstream stack's server tag is `v6` and Salt Rim's is `v5`; we pin the exact releases. We did not find an upstream RAM minimum, so our 1024 MB is an estimate. The catalog's Mealie and Tandoor are general recipe managers for cooking and meal planning, while Bar Assistant is built for cocktails and a home bar.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Bar Assistant — cocktail recipe manager — based on the bar-assistant/docker Compose stack, server 6.11.0 + Salt Rim 5.10.0
SERVER_IP=$(curl -fsS ifconfig.me)
cat > .env <<EOF
MEILI_MASTER_KEY=$(openssl rand -hex 24)
API_URL=http://$SERVER_IP:8082
MEILISEARCH_URL=http://$SERVER_IP:8081
EOF
cat > docker-compose.yml <<'EOF'
services:
meilisearch:
image: getmeili/meilisearch:v1.50
restart: unless-stopped
environment:
MEILI_NO_ANALYTICS: "true"
MEILI_MASTER_KEY: ${MEILI_MASTER_KEY}
MEILI_ENV: production
volumes:
- meilisearch_data:/meili_data
ports:
- 8081:7700
redis:
image: redis:7
restart: unless-stopped
bar-assistant:
image: barassistant/server:6.11.0
restart: unless-stopped
depends_on:
- meilisearch
- redis
environment:
APP_URL: ${API_URL}
MEILISEARCH_KEY: ${MEILI_MASTER_KEY}
MEILISEARCH_HOST: http://meilisearch:7700
REDIS_HOST: redis
CACHE_DRIVER: redis
SESSION_DRIVER: redis
ALLOW_REGISTRATION: "true"
volumes:
- bar_data:/var/www/cocktails/storage/bar-assistant
ports:
- 8082:8080
salt-rim:
image: barassistant/salt-rim:5.10.0
restart: unless-stopped
depends_on:
- bar-assistant
environment:
API_URL: ${API_URL}
MEILISEARCH_URL: ${MEILISEARCH_URL}
ports:
- 8080:8080
volumes:
bar_data:
meilisearch_data:
EOF
docker compose up -d
timeout 180 bash -c 'until curl -fsS http://localhost:8082/api/server/version >/dev/null && curl -fsS http://localhost:8080/ >/dev/null; do sleep 3; done'
# → http://SERVER_IP:8080 — register an account (registration is open), then create a bar; you become its adminThe bar-assistant/docker repository and the server's configuration file flag these before you open it up:
Bar Assistant used 78 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 Bar Assistant install snippet is marked verified on Ubuntu 26.04 (Nov 2026).