Self-host CocktailPi
2.1.3Web interface for DIY Raspberry Pi cocktail machine
- Stars
- 194
- Requires
- GPIO hardware (relay board, pumps)
What is CocktailPi?
CocktailPi is a self-hosted web application that runs on a Raspberry Pi to control a DIY cocktail mixing machine. It manages multiple pumps connected via GPIO pins or GPIO expanders, allowing users to create and order custom cocktail recipes through a web browser. The software supports up to 153 DC pumps, virtual stirring, ingredient substitution, multi-user roles with permissions, recipe collections and categories, an event system for custom actions, and a touchscreen-optimized interface. Users must build their own hardware including relay boards, pumps, and optionally stepper or DC motors. The backend is written in Java (Maven) and the frontend uses Vue.js. A public demo is available at demo.cocktailpi.org.
CocktailPi alternatives
Bar AssistantSelf-hosted, open-source cocktail recipe manager with ingredient inventory, bar management, shopping lists, and menu creation for home bartenders.CompareBar Assistant with CocktailPi
GumCPGumCP is a self-hosted, open-source Raspberry Pi web control panel with system monitoring, GPIO control, and command buttons with an HTTP API.CompareGumCP with CocktailPi
home-screensSelf-hosted, open-source smart display turning a Raspberry Pi into a customizable family dashboard with 45 modules, visual editor, and zero cloud dependency.Comparehome-screens with CocktailPi
RaspAPOpen-source, self-hosted wireless router and access point web interface for Debian-based devices like the Raspberry Pi, adding VPN, ad blocking and DHCP control.CompareRaspAP with CocktailPi
pi-dashboardSelf-hosted, open-source monitoring dashboard for Raspberry Pi and Linux with live metrics, Docker, WireGuard, REST API, and MCP server for AI assistants.Comparepi-dashboard with CocktailPi
vue-salt-rimSelf-hosted Vue 3 web client for Bar Assistant with recipe management, inventory, PWA, dark theme, and multi-language support.Comparevue-salt-rim with CocktailPi
pikvmSelf-hosted, open-source KVM over IP you flash to a Raspberry Pi: browser access down to BIOS, bootable virtual CD/DVD, ATX power control, VNC, IPMI and 2FA.Comparepikvm with CocktailPi
Raspberry-Pi-DashboardSelf-hosted PHP web dashboard for monitoring Raspberry Pi hardware with password protection, shutdown/reboot, dark theme, and mobile UI.CompareRaspberry-Pi-Dashboard with CocktailPi
Should you self-host CocktailPi?
CocktailPi scores 41/100 on selfhost.directory (how scoring works) and ranks #85 of 104 in Home Automation. It has 194 GitHub stars.
It shipped 9 stable releases in the past year. The latest, 2.1.3, came out on 25 April 2026. New versions land roughly every 2 days.
Setup is advanced: plan for several services and some ongoing maintenance. It is written mostly in Java.
Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 845 stars). It scores higher overall, so compare the two before you pick. See CocktailPi vs Home Assistant side by side.
Features
- Automatic recipe availability detection
- Custom recipe adjustments during ordering
- Drag-and-drop ingredient ordering
- Event system
- Hand-add ingredient prompts
- Ingredient substitution
- Manual pump activation
- Multi-language UI
- Multi-user with roles
- Pump control via GPIO
- Recipe collections and categories
- Recipe Management
- Stepper and DC motor support
- Touchscreen interface
- Virtual stirring
CocktailPi README
Main Project Website: Click me
Parts list for reproduction: Click me
Software setup Instructions: Click me
Community & Support: Discord - Click me
CocktailPi is not only a piece of software. It’s a cocktail-mixing-machine, that works with a Raspberry-Pi, that controls multiple pumps, which have different ingredients assigned. CocktailPi provides a UI, that can be accessed via web browser. Admins can create other users and assign them to multiple roles with different permissions. Users can create own cocktails and if CocktailPi has all the needed ingredients, they can order them. Cocktails can be categorized and shared with other users.
More in Food & Agriculture
CSA AdminSelf-hosted, source-available web application for managing CSA/ACP/Solawi organizations with member management, automated billing, and multilingual portals.
ELabelSelf-hosted open-source solution for EU-compliant electronic wine labels with QR codes, multilingual support, and regulatory compliance.
EverShelfEverShelf is a self-hosted, open-source smart pantry manager with barcode scanning, AI expiry tracking, smart shopping lists, and Home Assistant integration.
farmOSSelf-hosted, open-source farm record keeping web app built on Drupal: map fields, track assets and logs, collect sensor data, and use a JSON:API.
FoodCoopShopFoodCoopShop is a self-hosted, open-source web app for food co-ops to manage orders, products, and cashless payments with CakePHP/MySQL.
FoodsoftOpen-source web app for food co-ops: manage products, orders, finances, and work shifts — run it yourself with Docker or Rails.
fork.recipesSelf-hosted Django recipe manager with AI tools for scraping, generating, translating, and narrating recipes.
groceriesOpen-source self-hosted grocery list app with reliable real-time sync, offline support, multiple lists, store aisle sorting, and Tandoor recipe import.
HortusFoxSelf-hosted, open-source plant manager with tasks, inventory, calendar, weather forecasts, and collaborative chat for houseplant enthusiasts.
KoffanFree self-hosted shopping list for families. Runs in ~2.5 MB RAM, offline PWA, real-time sync, multi-household support.
OpenEatsOpenEats is a self-hosted, open-source recipe manager for personal collections with grocery lists, search, and serving adjustments.
Open Food FactsSelf-hosted, open-source food product database with REST API, barcode scanning, Nutri-Score, NOVA, Eco-Score, Green-Score. Runs via Docker Compose.
0 comments