Community Guide for DeLonghi ECP and Stilosa Espresso Machines
Community Guide
This guide is a community guide which is not maintained by GaggiMate. The author is not affiliated with GaggiMate.
Author: Jay R. (Jayblah) Last Updated: March 1, 2026 Credits: Flavius, mdwasp, TorxFighter, Abunchahicks, odor4fun
Important Notes
High Voltage Safety: Exercise extreme caution when working with high voltage. If you are unsure about any steps, consult a professional technician. Follow Local Codes: Ensure that your work adheres to local electrical codes and standards. Documentation: Keep a record of your wiring setup for future reference and troubleshooting.
If you see any errors or have any suggestions on making purchasing cheaper or easier for people, please join us in the GaggiMate Discord channel.
About This Guide
Scope of Work
This is a major modification requiring a full rewire.
Rewiring: You will remove most existing wiring and create a new harness to connect to the GaggiMate PCB.
Controls: The stock rotary knob will be removed. The machine will be controlled entirely through the GaggiMate interface.
Power: You will install a new 3-prong plug and a 4-pin on/off switch (for the EU model).
Features: This process disables the stock “Eco Mode” found on EU models.
While not a “simple” mod, it is manageable if you are comfortable with basic hand tools and confident following detailed instructions. This guide assumes you have purchased the specific items listed below and is not suitable for a “LEGO” style build.
A Note on the Stilosa
This guide is compatible with the Stilosa. The only significant difference is the front panel, which may require a specific screen housing print (linked in the Printed Parts section). All images and references below feature the ECP, but the modification is identical.
But Why?!
DeLonghi makes several popular, affordable, and surprisingly capable semi-automatic espresso machines. You can often find a well-maintained pre-owned model on Facebook Marketplace or elsewhere for a great price. I paid just $50 for mine. Even in stock form, the ECP and Stilosa can produce excellent espresso. Their stainless-steel grouphead and sturdy internals make them very capable, especially when paired with a bottomless portafilter and a quality grinder.
However, if the idea of installing a Ferrari engine inside a Toyota chassis sounds exciting, this modification is for you. After installing the GaggiMate, these little sleepers can rival the performance and features of $1,000-plus single-boiler espresso machines for a fraction of the cost.
You Can Do This!
Before I started this modification, I had never cut, crimped, or spliced a wire in my life. Despite that, I successfully installed the GaggiMate on my DeLonghi ECP. If I can do it, you can do it too.
Take your time, follow each step carefully, and you will be just fine. Make sure to read through the entire guide at least once before you start working on the machine. This will help you understand the overall process and prepare you for what’s ahead.
Disclaimer
Working with high-voltage electricity carries a risk of serious injury, electrocution, or fire. The modifications described in this guide involve opening your machine and altering its internal wiring, which operates at mains voltage.
By proceeding with this project, you acknowledge and agree to the following:
Assumption of Risk: You perform these modifications at your own risk. The author of this guide assumes no liability for any damage to your equipment, property, or injury to yourself or others.
Full Responsibility: You take full responsibility for the safety and functionality of your machine.
Safety First: Always ensure the machine is completely unplugged from the wall outlet before removing the housing or touching any internal components.
Technical Competence: Do not attempt these modifications if you are not comfortable working with electrical circuits or interpreting wiring diagrams.
If you are unsure about any step, consult a qualified electrician or professional technician.
Shopping List
Before buying anything, please read the guide fully. To get the GaggiMate to work with the DeLonghi ECP series, you must buy the components in this list exactly as specified. The shopping list includes items that make the job easier, but experienced tinkerers should analyze the list and determine what they actually need to buy.
A compatible ESP-32-S3 screen ⚠️ Buy only one. or
orℹ️ If you do not want to experience the frustration of crimping tiny JST connectors, buy these. You will splice the unconnected ends of these to their corresponding wires on the screen and SSR. You must buy both. Choose 30cm length for both to give you enough wire.
Tools & Consumables
Printed Parts
We recommend printing all parts using PETG or ABS for durability and heat resistance. PETG is preferred. It has a higher heat tolerance than ABS, comes in a wider variety of colors, and is easier to print. There’s no reason you can’t glam up your machine with a bright color while you’re at it!
Screen Prints
DeLonghi ECP
2.1” Screen
TorxFighter designed the front panel replacement shown at the start of this guide. It’s not free, but it completely transforms the look of the machine by replacing the entire front panel and seamlessly integrating the screen. The author of this guide uses this print and recommends it. Find it here.
Prowler has designed a screen housing for the 2.8” WaveShare screen that mounts on the front panel. Find the model here.
DeLonghi Stilosa
2.8” Screen
Stuart has designed a screen housing for the 2.8” WaveShare screen that mounts on the front panel. Find the model here.
PCB Prints
⚡ Please keep your PCB and SSR secure within a housing when your build is done. Leaving them exposed is an electrocution risk.
TorxFighter, creator of the front panel replacement print, has also released a PCB housing that mounts on the back of the machine and holds both the PCB and SSR.
ph has designed and shared another version that also fits both the SSR and PCB, mounted on the back of the machine.
You can also buy a pre-printed GaggiMate Pro PCB housing or download the model and print it yourself. Note that this housing only holds the PCB. You’ll need a separate solution for the SSR.
Before You Begin
Diagram — Wiring
Please ensure you reference the appropriate wiring diagram below as your primary roadmap for this entire step. Do not skip this check, as it dictates your next sequence of operations. It might look intimidating, but take your time; we will break down each connection precisely. The diagram is your essential blueprint.
ℹ️ You may install a power switch on the American version of your machine if you wish, but it will require cutting an additional hole in the chassis to support the new switch. This is not covered by this guide. If you proceed with this addition, you must follow the principles of the European wiring diagram (Diagram B).
Diagram A — No Power Switch (e.g. American Models)
Diagram B — Power Switch (e.g. European Models)
Flashing the Hardware
Flash both the PCB and screen before installing them. It’s much easier to do outside the machine. Follow the instructions at docs.gaggimate.eu/docs/flashing.
Prepare the Machine
The abridged process is as follows:
Create a Wire Port
You will need to drill a hole in the back panel to route wires from inside the machine to the PCB. Choose a location that is easily accessible when fully assembled and does not interfere with any other components. Drill the hole large enough to fit at least a 13 mm (inner-dimension) grommet. This keeps the opening tidy and protects the wires from sharp edges.
Wire the Pump
The pump is not polarized. It does not matter which wire connects to which terminal. ↗️Refer to the Wiring Diagram
Connect the Blue Pump Wire
Connect the Green Pump Wire
Prepare the Water Line
Re-seat the Frame
A correct installation of the Pressure Transducer and fittings will look similar to the image above.
Wire the Boiler
The boiler is not polarized. Note how the fuse is secured to the boiler via the metal clip. When you reconnect the fused wire, secure it the same way to ensure it stays in place and maintains good contact with the boiler surface. ↗️Refer to the Wiring Diagram
The fused wire is indicated by the arrow pointing down from label 1.
Connect the Red Fused Boiler Wire
Connect the Blue Boiler Wire
Wire the Screen
This section explains how to prepare a WaveShare screen for connection to the PCB. If you purchased a LilyGo screen, the process will be similar, but wiring may differ. Refer to the documentation that came with your screen for specifics.↗️Refer to the Wiring Diagram
Prepare the 2-Pin Female PH 2.0 Connector
Prepare the 4-Pin Female SH 1.0 Connector
The WaveShare includes 2 of these. You only need 1, but keep the other as a backup.
Prepare the 22 AWG Wires
Prepare the Screen Connection
Prepare the PCB Connection
Attach the Thermocouple
A successful thermocouple installation will look like this (rear-view of the boiler).
Wire the Solid State Relay (SSR)
Attach the SSR Output-to-Plug Wire
Prepare the 3-Pin Female PH 2.0 Connector
Prepare the Control Wire Ends on the SSR Side
Diagram — PCB Wiring Pinout
Refer to the wiring pinout diagram below as we begin connecting the remaining wires to the PCB. Following the pinout carefully is crucial to ensure proper functionality and avoid damage to components.
Connect the Components
⚡ Keep your PCB and SSR secured inside a housing when your build is complete. Leaving them exposed is an electrocution hazard.
⚡ Proper grounding is crucial for safety. If you are unsure about any part of this process, please join us in Discord.
Even though the American version is not grounded by default, the grounding-point is there for us to use. While the DeLonghi America engineers chose not to ground the boiler, they also didn’t expect dramatic modification of their machine. The GaggiMate team strongly recommends that you ground your boiler.
On the 3-prong power cord linked in the shopping list, identify the following wires:
Line is black . For the EU machine, it is brown .
Neutral is white . For the EU machine, it is black .
Ground is teal . For the EU machine, it is green and yellow .
With everything connected, plug in your machine and turn it on. If everything is wired correctly, you should observe the following:
If any of these three things do not occur, there is likely a wiring issue. Unplug your machine, review the guide carefully, and retrace your connections to locate and correct the error.
Assuming all three systems power on correctly, visit the GaggiMate website and follow the instructions in the First Start documentation. While there, also review the Configuration, Touch Screen Usage documents to familiarize yourself with the GaggiMate software and its features. Lastly, if you experience any issues with the software, please first check the Troubleshooting section. If your issue is not addressed there, please join us in Discord. We’d be happy to try to help you.
Final Setup and Testing
Use GaggiMate’s software Auto-Tune feature in the PID Autotune page to generate PID values specific to your machine. This ensures the software can control temperature effectively and accurately.
For DeLonghi ECP users, it is recommended to disable Steam Assist in the Settings page by setting its value to 0.
Before reassembling your machine completely, test pulling a shot using the GaggiMate interface. Confirm that there are no leaks and that everything powers and functions as expected.
If everything looks good, you’re ready to reassemble your machine.
Before final reassembly, unplug your machine and take some time to organize your internal wiring using your solution of choice. Verify that no wires are resting directly on the boiler surface where heat could cause damage to them over time. The only wire that may rest on the boiler surface is the fuse-protected heater wire.
Troubleshooting
The list below contains common issues you might encounter. If your problem is not listed here, please join us in Discord. We’d be happy to try to help you.
After starting my machine, I keep seeing a “Temperature error, please restart” message on my screen! What should I do?
First, use your multimeter and test the thermocouple while in continuity mode to make certain it is ungrounded by touching one probe to the thermocouple end, and the other probe to one of two terminal wires. If the multimeter beeps, your thermocouple is grounded. Return it and purchase an ungrounded thermocouple. If your thermocouple is ungrounded (i.e. no beep), try a different outlet. The PID controller does not like a noisy signal. If you’re plugged into an outlet that is weak or noisy (e.g. an extension outlet with lots of USB ports, etc.), your PID may not operate correctly.
I moved it to a different outlet, but I still have the same error. What should I do?
Your thermocouple wires may not be making a tight connection inside their PCB slots. These wires are thin. If you’re using the naked wires, make sure you’ve folded them over and twisted them as instructed to give the slot clamps something to bite onto. If that still doesn’t work, consider wrapping the terminal wires in ferrite beads or adding an EMI filter to the power line to reduce electrical noise.
My coffee tastes underextracted or sour. What’s wrong?
Nothing is wrong, per se. Even the highest-end machines have a temperature difference from where the thermocouple takes a measurement and the actual grouphead. The GaggiMate software allows you to compensate for this by adjusting the “Temperature Offset” value in the settings. You can increase this value to raise the target temperature that the PID controller is trying to reach, which will help ensure that the grouphead reaches your desired temperature for espresso extraction. Use a probe to measure the actual temperature at the grouphead and adjust the offset accordingly until you achieve the desired taste. Don’t be alarmed if you measure an offset of 10–20 degrees Celsius between the thermocouple reading and the actual grouphead temperature. This is normal for machines like the DeLonghi ECP that do not have a thermocouple located directly at the grouphead.
I have my temperature offset dialed-in, but my coffee still tastes underextracted or sour. What else could be wrong?
According to odor4fun, the mushroom valve inside the DeLonghi machines requires at least 4-bars of pressure to hold open. If your pump is not generating enough pressure to extract properly, the mushroom valve may not be opening fully. This can lead to underextraction. If your shots still don’t taste correct after dialing in the temperature offset, increase the pressure values in all phases of your preferred profile(s) by plus 4. This should help ensure the mushroom valve is opening fully and allow for proper extraction.
For more troubleshooting tips, please check the GaggiMate Troubleshooting Documentation. The ones mentioned above are commonly observed in DeLonghi ECP machines, but the troubleshooting documentation contains resolutions for a wide variety of issues.
Congratulations!
Welcome to the world of turbocharged espresso! Now you can extract café-quality shots from a compact, affordable machine that rivals the big names at a fraction of the cost.
Acknowledgements
Flavius for successfully being the first (as far as we know) to install GaggiMate on a DeLonghi ECP, answering a ton of questions, and helping identify the required components.
mdwasp for also providing a lot of information, and for being the creator of the GaggiMate project.
TorxFighter for doing a lot of tinkering and sharing awesome 3D-prints specific to our beloved little DeLonghis.
Abunchahicks for wiring assistance and general knowledge and helpfulness.
Stuart for technical support and clever mounting ideas (e.g. a DIN rail).
Prowler for a 2.8” screen print.
odor4fun for sharing his knowledge about the mushroom valve and how to optimize pressure values for better extraction.
The GaggiMate team for their incredible work and contributions.