README
¶
CashPilot Desktop is a local-first desktop app for macOS (Apple Silicon), Windows and Linux that deploys and monitors passive-income and DePIN services. It packs CashPilot into one app with a system tray and a setup wizard, so you open an app instead of running the CashPilot container and a browser; the earning services themselves still run in Docker or Podman. It runs either as the full CashPilot dashboard or as a Worker Node that joins an existing CashPilot instance.
Features
- One-click install -- No Docker knowledge required; the app handles container setup for you
- System tray (macOS) -- Runs quietly in the background with quick-access status and earnings summary; menu-bar icon is macOS-only today (Windows/Linux planned)
- Real-time monitoring -- Live earnings, service health, container stats, and node uptime
- Multi-node fleet -- Aggregate view across your entire CashPilot fleet from a single window
- Guided setup wizard -- Step-by-step onboarding with Docker detection and installation guidance
- Cross-platform -- Native builds for macOS (ARM64), Windows (x64), and Linux (x64)
- Lightweight -- Minimal resource usage thanks to native Go backend with webview frontend
- Secure -- Credentials encrypted at rest with AES-256-GCM; master key in the OS keychain. From the first release after v0.20.5 the macOS build is signed with a Developer ID certificate and notarized by Apple; Windows signing is planned.
Quick start
- Download the app for your platform from the latest release. Docker or Podman must be installed; the wizard helps if it is missing.
- Launch the app and pick a mode: CashPilot (full dashboard) or Worker Node (enter your CashPilot address and fleet key).
- Browse the service catalog, deploy containers, and watch earnings from the dashboard or the tray.
Platform notes, system requirements and the full walkthrough are in Getting started.
Supported services
CashPilot bundles a catalog of 41 active passive-income services across multiple categories (the catalog also carries 11 retired entries, which the app hides and refuses to deploy). Some links below are affiliate/referral links -- see the disclosure. Read how bandwidth-sharing works before you opt in; per-service limits, payouts and caveats are in docs/services.md.
- Docker-deployable: Anyone Protocol, Bitping, Earn.fm, EarnApp, Honeygain, IPRoyal Pawns, MystNodes, PacketStream, ProxyBase, ProxyBase Markets, ProxyLite, ProxyRack, Repocket, Sia hostd, Storj, Traffmonetizer, URnetwork
- Browser extension / desktop only: Bytebenefit, Bytelixir, Dawn Internet, Deeper Network, Ebesucher, Gradient Network, Grass, Helium, Nodepay, Noderr Micronodes, Nodle, PassiveApp, Sentinel dVPN, Spide, Teneo Protocol, Theta Edge Node, Titan Network, Uprock
- GPU compute: Flux, Golem Network, io.net, Nosana, Salad, Vast.ai
Documentation
- Getting started: modes, downloads, system requirements, Desktop vs Web
- Configuration: every setting and its default, Worker Node pairing, where secrets live
- Usage: a tour of every screen
- Supported services: bandwidth-sharing explained, per-service limits and payouts, disclosure
- How it works: the full design, grounded in the code
- FAQ: earnings, safety, Docker, crashes, several machines
- Development: prerequisites, dev workflow, build, tests
Related projects
| Project | Type | Description |
|---|---|---|
| CashPilot | Backend | Multi-service passive income aggregator and fleet manager |
| CashPilot-android | Android Agent | Monitoring agent for passive income apps on Android |
| cashpilot-mcp | MCP Server | Monitor earnings from AI assistants via Model Context Protocol |
| cashpilot-ha | Home Assistant | Earnings and service status sensors for your smart home |
License
GPL-3.0-or-later. Sergio Fernandez, 2026.
Documentation
Source Files
¶
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
catalogsync
command
Command catalogsync vendors the CashPilot web catalog (services/**.yml) into this repository and, in -check mode, reports when the vendored copy has drifted from it.
|
Command catalogsync vendors the CashPilot web catalog (services/**.yml) into this repository and, in -check mode, reports when the vendored copy has drifted from it. |
|
e2e
|
|
|
harness
Package harness holds the fakes the end-to-end tests drive the real app against: a stateful Docker Engine API, canned earning providers and a canned exchange-rate feed.
|
Package harness holds the fakes the end-to-end tests drive the real app against: a stateful Docker Engine API, canned earning providers and a canned exchange-rate feed. |
|
internal
|
|
|
bgservice
Package bgservice registers the CashPilot executable with the current user's OS service manager so its headless --daemon supervisor auto-starts at login, restarts on crash, and survives the GUI being closed and a reboot — Docker-parity native supervision with no admin (see docs/NATIVE-SUPERVISION.md, Phase B).
|
Package bgservice registers the CashPilot executable with the current user's OS service manager so its headless --daemon supervisor auto-starts at login, restarts on crash, and survives the GUI being closed and a reboot — Docker-parity native supervision with no admin (see docs/NATIVE-SUPERVISION.md, Phase B). |
|
catalogsync
Package catalogsync vendors the CashPilot web catalog into this repository and applies the small set of Desktop-only deltas declared in catalog-overlay/.
|
Package catalogsync vendors the CashPilot web catalog into this repository and applies the small set of Desktop-only deltas declared in catalog-overlay/. |
|
compose
Package compose writes a docker-compose.yml for CashPilot services.
|
Package compose writes a docker-compose.yml for CashPilot services. |
|
exchange
Package exchange converts service-earnings amounts between currencies for the CashPilot Desktop dashboard.
|
Package exchange converts service-earnings amounts between currencies for the CashPilot Desktop dashboard. |
|
fleetnet
Package fleetnet validates the URL of a remote CashPilot worker before the desktop (master) makes an authenticated request to it.
|
Package fleetnet validates the URL of a remote CashPilot worker before the desktop (master) makes an authenticated request to it. |
|
health
Package health answers a question the container runtime cannot: is this service actually EARNING, as distinct from merely running?
|
Package health answers a question the container runtime cannot: is this service actually EARNING, as distinct from merely running? |
|
preflight
Package preflight answers one question before a deploy runs: what, on THIS machine, will stop this service earning?
|
Package preflight answers one question before a deploy runs: what, on THIS machine, will stop this service earning? |
|
upstream
Package upstream lets this Desktop optionally report to a CashPilot server as a worker.
|
Package upstream lets this Desktop optionally report to a CashPilot server as a worker. |
Click to show internal directories.
Click to hide internal directories.