CashPilot for Home Assistant

April 13, 2026 · View on GitHub

CashPilot for Home Assistant

A Home Assistant custom integration that monitors your CashPilot passive income dashboard. Track earnings, service health, and manage containers directly from HA.

Features

Earnings overview -- total, today, and monthly earnings as sensors
Per-service monitoring -- balance, health score, uptime, CPU, and memory for every deployed service
Service control -- start, stop, and restart individual services via switches and buttons
Fleet overview -- online workers and running containers (if fleet mode is configured)
Manual collection -- trigger an earnings refresh on demand

Prerequisites

A running CashPilot instance reachable from Home Assistant
CashPilot login credentials (username and password)
Home Assistant 2024.1.0 or later

Installation

HACS (recommended)

Open HACS in Home Assistant
Click the three dots in the top right and select Custom repositories
Add https://github.com/GeiserX/cashpilot-ha with category Integration
Search for "CashPilot" and install it
Restart Home Assistant

Manual

Copy the custom_components/cashpilot/ directory into your HA config/custom_components/ folder
Restart Home Assistant

Configuration

Go to Settings > Devices & Services > Add Integration
Search for CashPilot
Enter the URL of your CashPilot instance (e.g., http://cashpilot:8080)
Enter your CashPilot username and password
Click Submit

Entities

Dashboard device

Entity	Type	Description
`sensor.cashpilot_total_earnings`	Sensor	Lifetime cumulative earnings (USD)
`sensor.cashpilot_today_earnings`	Sensor	Earnings for today (USD)
`sensor.cashpilot_month_earnings`	Sensor	Earnings for the current month (USD)
`sensor.cashpilot_active_services`	Sensor	Number of active services
`button.cashpilot_collect_earnings`	Button	Trigger manual earnings collection

Fleet sensors (only if fleet mode is configured)

Entity	Type	Description
`sensor.cashpilot_fleet_workers_online`	Sensor	Online fleet workers
`sensor.cashpilot_fleet_containers_running`	Sensor	Running fleet containers

Per-service devices (one device per deployed service)

Entity	Type	Description
`sensor.cashpilot_{slug}_balance`	Sensor	Service balance (USD)
`sensor.cashpilot_{slug}_health_score`	Sensor	Health score (0-100%)
`sensor.cashpilot_{slug}_uptime`	Sensor	Uptime percentage
`sensor.cashpilot_{slug}_cpu`	Sensor	CPU usage (diagnostic)
`sensor.cashpilot_{slug}_memory`	Sensor	Memory usage in MB (diagnostic)
`binary_sensor.cashpilot_{slug}_running`	Binary Sensor	Whether the container is running
`switch.cashpilot_{slug}`	Switch	Start / stop the service
`button.cashpilot_{slug}_restart`	Button	Restart the service

Example Automations

Daily earnings notification

automation:
  - alias: "CashPilot daily earnings summary"
    trigger:
      - platform: time
        at: "22:00:00"
    action:
      - service: notify.mobile_app_phone
        data:
          title: "CashPilot Earnings"
          message: >
            Today: ${{ states('sensor.cashpilot_today_earnings') }}
            Month: ${{ states('sensor.cashpilot_month_earnings') }}
            Total: ${{ states('sensor.cashpilot_total_earnings') }}

Alert when a service goes down

automation:
  - alias: "CashPilot service down alert"
    trigger:
      - platform: state
        entity_id: binary_sensor.cashpilot_honeygain_running
        to: "off"
        for:
          minutes: 10
    action:
      - service: notify.mobile_app_phone
        data:
          title: "CashPilot Alert"
          message: "Honeygain has been down for 10 minutes."

Auto-restart unhealthy service

automation:
  - alias: "CashPilot auto-restart low health"
    trigger:
      - platform: numeric_state
        entity_id: sensor.cashpilot_honeygain_health_score
        below: 50
        for:
          minutes: 15
    action:
      - service: button.press
        target:
          entity_id: button.cashpilot_honeygain_restart

Polling interval

Data is refreshed every 5 minutes by default. This is not user-configurable through the UI at this time.

Other Home Assistant Integrations by GeiserX

duplicacy-ha — Backup status monitoring
genieacs-ha — TR-069 router management sensors
pumperly-ha — Fuel and EV charging price sensors

Project	Description
CashPilot	Self-hosted passive income platform with web UI for setup and earnings tracking
CashPilot-android	Android monitoring agent for CashPilot passive income apps
cashpilot-mcp	MCP Server for CashPilot passive income monitoring and fleet management
n8n-nodes-cashpilot	n8n community node for CashPilot passive income monitoring

License

GPL-3.0