Skip to main content

Build Your Own Cocktail Machine

A DIY path for makers and tech enthusiasts — assemble your own hardware, install the free software, and start mixing.

Why Go DIY?

Full Control

Design and build your machine exactly how you want it. Choose your own components, frame, and layout.

Cost-Effective

Build a complete cocktail machine for €200–€500 in parts. No subscription required with the free Community license.

Learning Experience

Gain hands-on experience with electronics, Raspberry Pi, and real-time software. A great project for makers and students.

Community Support

Join a community of builders sharing designs, tips, and modifications. Free software you can extend with webhooks and custom scripts.

What You'll Need

Raspberry Pi 4 or 5

The brain of your machine. Runs the Cocktail-O-Matic software, drives the touchscreen UI, and controls all hardware.

Peristaltic Pumps

Food-safe DC or stepper peristaltic pumps for precise liquid dispensing. Up to 5 pumps on the Community license.

Relay Board / GPIO Expander

MCP23017 I2C expander or relay modules to control pump power. Scales from 6 to 40+ channels.

Food-Safe Tubing & Fittings

Silicone tubing, barb fittings, and check valves. Food-grade materials for safe liquid handling.

Power Supply

12V or 24V DC power supply depending on your pump choice. Adequate wattage for all pumps running simultaneously.

Frame / Enclosure

Wood, metal, acrylic, or 3D-printed. Design your own or use community-shared plans and templates.

What You Are Actually Building

Eight physical stages, from a tray of parts to a machine pouring a drink. Nothing here is beyond an evening of careful work with hand tools - the hard part is the software, and that is already written.

The machine separated into its five layers: base, pumps, control board, computer, bottles
Lay Out the Parts
01

Lay Out the Parts

Pumps, a relay board, a single-board computer, a DC supply, silicone tubing and jumper wires. Count everything before you mount anything - a missing barb fitting stops the whole build.

Build the Frame
02

Build the Frame

An open frame with a bottle rail on top and a shelf below for the electronics. Extrusion, plywood or 3D-printed brackets all work; the only requirement is that the bottles sit above the pumps.

Mount the Pumps
03

Mount the Pumps

One pump per ingredient, on a common rail so the tubing runs parallel. Keep the runs short and equal - tube length is volume, and every extra centimetre is liquid you have to prime and purge.

Wire the Control Side
04

Wire the Control Side

Signal wires from the computer to the relay board, then power leads from the relays to the pumps. Two separate worlds: thin and low-current on one side, thick and high-current on the other.

You do not have to work this part out from a picture. Once your pumps are configured, the admin panel lists every board, every pump and the pin each one drives, next to a diagram of the Raspberry Pi header - so what you wire and what the software drives cannot disagree. A drawing goes stale the moment you move a pin; the panel reads your own configuration.

Distribute the Power
05

Distribute the Power

One DC supply sized for all the pumps you expect to run at once. The supply ground and the board ground must be tied together at a single point, or the relays will not switch reliably.

Run the Tubing
06

Run the Tubing

From each bottle, down through its pump, and forward to a single dispensing head above the glass. Food-grade silicone throughout, and a check valve on anything that would otherwise siphon.

Calibrate Each Pump
07

Calibrate Each Pump

Run a pump into a measuring cylinder, tell the software what came out, and it works out the flow rate. Ten minutes for the whole set, and it is what turns a pump into a measured pour.

Serve
08

Serve

Add your recipes, put the machine where people are, and let them order from the touchscreen. Everything after this point is software you already have.

These illustrations show the stages, not the schematic. The exact pin assignment is the sheet your own machine generates.

Getting Started

01

Gather Hardware

Source the components from our recommended parts list. Most items are available on Amazon or electronics suppliers.

02

Install Software

Flash your Raspberry Pi, run the one-line installer, and the Cocktail-O-Matic software is ready in under 15 minutes.

03

Configure & Calibrate

Connect your pumps, assign ingredients, and calibrate flow rates using the built-in admin interface.

04

Start Mixing

Create recipes, invite friends, and let your machine serve cocktails. Upgrade to Pro anytime for more features.

Free Community edition

Install it on your Raspberry Pi

One command, then a free account to activate the machine. Up to 5 pumps, no time limit, free forever.

curl -fsSL https://cocktailomatic.com/install.sh | sudo bash

Requires a Raspberry Pi 4 or 5 running 64-bit Raspberry Pi OS. Under 10 MB downloaded.

  • Verifies the download against its SHA-256 checksum before touching the system
  • Installs to /opt/cocktailomatic and starts on boot as a systemd service
  • Re-run it to upgrade: your database, images and licence are never touched

Resources

Documentation

Step-by-step setup guides, wiring diagrams, and troubleshooting tips to get your machine running.

Documentation →

Get the Software

The Community edition is free: up to 5 pumps, no time limit. One command installs the binary on 64-bit Raspberry Pi OS; a free account issues the key that activates the machine.

Get the Software →

Live Demo

Explore the guest kiosk and the admin panel in our online sandbox before you start building.

Live Demo →

Ready to Build?

Download the free Community edition and start building your cocktail machine today.