A beautiful ASCII art welcome banner for your Raspberry Pi 5 homelab that displays real-time system statistics on SSH login.

• 🎨 Beautiful ASCII Art - Eye-catching "BEEHIVE" banner with bee theme
• 📊 Real-time System Stats - CPU temperature, memory, disk, uptime, load average
• 🐳 Docker Integration - Shows count of running containers
• 🎨 Color-coded Status - Green/Yellow/Red indicators based on system health
• 🚀 Automated Deployment - One command deployment via pyinfra
• 🔄 Idempotent - Safe to run deployment multiple times
• 🔧 Easy Configuration - Environment-based settings

╔══════════════════════════════════════════════════════╗
║                     🐝 BEEHIVE 🐝                    ║
║           Raspberry Pi 5 Homelab Status              ║
╚══════════════════════════════════════════════════════╝

  Hostname:    beehive
  Uptime:      5 days, 12 hours
  CPU Temp:    52.3°C    [████████░░] OK
  Memory:      2.1/7.8GB [███░░░░░░░] 27%
  Disk:        45/256GB  [██░░░░░░░░] 18%
  Load Avg:    0.45, 0.38, 0.29
  Docker:      12 containers running

• Raspberry Pi 5 with Raspberry Pi OS (64-bit recommended)
• SSH access to the Pi configured
• SSH key set up for passwordless authentication
• Python 3.9+ on your development machine (WSL/Linux/Mac)

git clone https://github.com/yourusername/beehive.git
cd beehive

make setup
# or manually: pip install -r requirements.txt

cp .env.example .env

Edit .env and set your Raspberry Pi's details:

[email protected]
BEEHIVE_SSH_KEY=~/.ssh/id_rsa

Replace hooke with your Pi username and 10.0.0.150 with your Pi's IP address.

make dry-run

This will show what changes would be made without actually applying them.

make deploy

That's it! The banner will now display when you SSH into your Raspberry Pi.

After installing, SSH into the Pi and authenticate manually:

# With an auth key (headless):
sudo tailscale up --authkey=<your-auth-key> --ssh

# Or interactively (follow the login URL):
sudo tailscale up --ssh

# Verify:
tailscale status

make ssh-bootstrap     # 1. Set up SSH key auth (needs password in .env)
make deploy            # 2. Deploy the welcome banner
make tailscale-install # 3. Install Tailscale
                       # 4. SSH in and run: sudo tailscale up --ssh
make pihole-install    # 5. Install Pi-hole (interactive — follow the prompts)

1. Pyinfra connects to your Raspberry Pi via SSH
2. Installs required Python libraries (rich, psutil) on the Pi
3. Copies the banner.py script to /usr/local/bin/banner.py
4. Makes the script executable
5. Adds the banner to /home/hooke/.bashrc so it displays on SSH login

The deployment is idempotent, meaning you can run make deploy multiple times safely - it will only make changes if needed.

The banner displays automatically when you SSH into your Raspberry Pi:

ssh [email protected]

Run the banner manually on the Pi:

/usr/local/bin/banner.py

To prevent the banner from showing on SSH login, remove the line from your .bashrc:

# On the Pi
sed -i '/banner.py/d' ~/.bashrc

• Raspberry Pi OS (Bookworm or later recommended)
• Python 3.9+
• 100MB free disk space

• Python 3.9+
• SSH client
• Git

The banner uses color coding to help you quickly identify potential issues:

• 🟢 Green (< 60°C): Healthy
• 🟡 Yellow (60-74°C): Warm
• 🔴 Red (≥ 75°C): Hot (throttling risk)

• 🟢 Green (< 70%): Healthy
• 🟡 Yellow (70-84%): High
• 🔴 Red (≥ 85%): Critical

• 🟢 Green (< 80%): Healthy
• 🟡 Yellow (80-89%): High
• 🔴 Red (≥ 90%): Critical

cp .env.example .env
# Edit .env with your Pi's details

• Verify your Pi's IP address: ping 10.0.0.150
• On a fresh OS install, run make ssh-bootstrap first to set up key auth
• Check SSH key is set up: ssh-copy-id [email protected]
• Test manual SSH: ssh [email protected]

# Manually add it to .bashrc on the Pi
echo '/usr/local/bin/banner.py' >> ~/.bashrc

This is normal if Docker is not installed. The banner will simply not display the Docker line.

This is just the beginning! Future plans include:

• 🏗️ Full Infrastructure as Code - Deploy entire homelab with pyinfra
• 🏠 Home Assistant - Automated setup with add-ons (MQTT, Node-RED, ESPHome)
• 🌐 Network Services - Pi-hole, DNS, VPN, reverse proxy
• 📈 Monitoring Stack - Prometheus, Grafana, alerting
• 💾 Backup/Restore - Automated backup scripts
• 🔔 Notifications - Telegram/Discord alerts for system events

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.

• Built with pyinfra - Fast and flexible infrastructure automation
• Styled with rich - Beautiful terminal formatting
• System stats via psutil - Cross-platform system utilities

Made with 🐝 for homelabbers everywhere