Back to Guides
Beginner • ~10 min read

Installing MudPi

Download and install the MudPi core system on your Raspberry Pi.

Prerequisites

Make sure you've completed the Raspberry Pi Setup 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.