Legacy • ~10 min read

Installing MudPi (Legacy)

Legacy installation guide for Raspbian Buster/Bullseye using system-wide pip. For Bookworm and later, see the updated guide.

Outdated Guide

This guide uses system-wide pip3 install and apt-get, which work on Raspbian Buster and Bullseye. On Raspberry Pi OS Bookworm and later, pip is restricted to virtual environments (PEP 668). Please see the updated Installing MudPi guide.

Prerequisites

Make sure you've completed the Raspberry Pi Setup (Legacy) guide before proceeding.

Quick Install

The fastest way to get MudPi running:

Shell

curl -sL https://install.mudpi.app | bash

This script installs Python 3, Redis, GPIO libraries, and the MudPi core automatically.

What Gets Installed

The install script sets up: Python 3, pip, Redis server, RPi.GPIO, MudPi core, and a systemd service file. It won't modify existing installations.

Manual Installation

Prefer to install step by step? Follow along below.

1. Install System Dependencies

Shell

sudo apt-get update
sudo apt-get install -y python3 python3-pip python3-dev redis-server

2. Clone MudPi

Shell

cd ~
git clone https://github.com/olixr/MudPi.git
cd MudPi

3. Install Python Packages

Shell

pip3 install -r requirements.txt

4. Start Redis

Enable Redis to start automatically on boot:

Shell

sudo systemctl enable redis-server
sudo systemctl start redis-server

Tip

Verify Redis is running with redis-cli ping — you should get PONG in response.

Verify Installation

Check that MudPi is installed correctly:

Shell

python3 mudpi.py --version

Next Steps

Proceed to Your First Garden Setup to connect sensors and start monitoring.

Previous Guide ← Raspberry Pi Setup (Legacy) Next Guide First Garden Setup →