CashPilot-Desktop

command module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 8, 2026 License: GPL-3.0 Imports: 54 Imported by: 0

README

CashPilot Desktop

Release CI License Downloads Stars

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.

CashPilot Desktop dashboard

What's new in 1.0

1.0 is the first stable release, after about 130 releases since May 2026. Nothing breaks on upgrade. The highlights:

  • Earners can't reach your LAN. On a new install, bridge-networked earners run on a fenced network that drops private ranges, tailnets, cloud metadata, this computer and its public IP. If the fence can't be written, the deploy is refused, and the app rewrites it every five minutes. Upgraded installs turn it on with one button. Not covered: Podman, host-networked services such as Mysterium, a second public IP, the minutes before the first public-IP lookup, and the gap after a firewall reload until the next rewrite (limits).
  • Earn on more IPs. Run extra copies of a service through a SOCKS5, HTTP CONNECT or Tailscale exit-node proxy. If the proxy dies the copy stops. It never falls back to your IP.
  • Your node identities are safe. Removing a service keeps its data, an unrecoverable volume is never deleted without a separate yes, and encrypted backups take one click.
  • 41 graded services, vendored from the web catalog, with a check before deploy that says what would stop a service earning here.
  • Signed and notarized on macOS, with builds for Windows and Linux. Pairs with a CashPilot server, web 2.0 included, or acts as the hub for workers and Android phones. The Android companion reaches 1.0 at the same time.

Full list, upgrade notes and known limits: What's new in 1.0.

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
  • Activity (opt-in) -- Which destinations each earner talks to, whether it reaches into your network or sends mail; off by default, remote addresses kept 24 hours (details)
  • Guided setup wizard -- Step-by-step onboarding with Docker detection and installation guidance
  • Custom services -- Run any image from Docker Hub or another registry that the catalog does not list, with the same restrictions as catalog services (docs)
  • Proxied copies -- Run extra copies of a deployed service through a SOCKS5, HTTP CONNECT or Tailscale exit-node proxy, so one computer earns on several IPs; a dead proxy stops the copy instead of leaking (docs)
  • LAN isolation -- New installs fence bridge-networked container earners (not host-networked ones such as Mysterium) off your LAN, this computer, a tailnet and cloud metadata; an upgraded install turns it on with one button (docs)
  • Provider grades -- Every catalog provider gets a letter grade from the same published criteria as the web app, with its cons and their sources (how we grade)
  • Import from another tool -- Bring service logins over from money4band, CashFactory or InternetIncome after a dry run (docs)
  • 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

  1. Download the app for your platform from the latest release. Docker or Podman must be installed; the wizard helps if it is missing.
  2. Launch the app and pick a mode: CashPilot (full dashboard) or Worker Node (enter your CashPilot address and fleet key).
  3. 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.

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
  • Activity: what the opt-in Activity page reads, keeps and alerts on
  • Supported services: bandwidth-sharing explained, per-service limits and payouts, disclosure
  • Custom services: run an image the catalog does not list, and what it may do
  • Proxied copies: run extra copies through a proxy, what cannot, the traffic cap, Tailscale exit nodes
  • Moving from another tool: money4band, CashFactory, InternetIncome
  • How it works: the full design, grounded in the code
  • FAQ: earnings, safety, Docker, crashes, several machines
  • Development: prerequisites, dev workflow, build, tests
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

The Go Gopher

There is no documentation for this package.

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.
cpbackup command
Command cpbackup opens a CashPilot backup (.cpbackup) on your own machine.
Command cpbackup opens a CashPilot backup (.cpbackup) on your own machine.
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
activity
Package activity shows what each earner container does on the network: how many connections it opens and how many fail, which ports and networks it talks to, and whether it reaches into the owner's own network or sends mail.
Package activity shows what each earner container does on the network: how many connections it opens and how many fail, which ports and networks it talks to, and whether it reaches into the owner's own network or sends mail.
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?
importers
Package importers reads another tool's config files into catalog fields, and nothing more.
Package importers reads another tool's config files into catalog fields, and nothing more.
noderead
Package noderead reads a node's own earnings from inside its running container, for a provider whose account API cannot give a balance or a lifetime.
Package noderead reads a node's own earnings from inside its running container, for a provider whose account API cannot give a balance or a lifetime.
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?
proxies
Package proxies holds the rules for proxied copies that need no Docker and no database: what a proxy definition may contain, what the UI may see of it (never a secret), which services may run through a proxy, the traffic cap, and the exit-IP checks.
Package proxies holds the rules for proxied copies that need no Docker and no database: what a proxy definition may contain, what the UI may see of it (never a secret), which services may run through a proxy, the traffic cap, and the exit-IP checks.
statebackup
Package statebackup exports a service's irreplaceable state (a node identity, a keystore, a wallet) as an encrypted file, and decides whether the user still has a backup of it.
Package statebackup exports a service's irreplaceable state (a node identity, a keystore, a wallet) as an encrypted file, and decides whether the user still has a backup of it.
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.
usage
Package usage keeps what each container costs this machine over time: CPU, memory and network traffic, per container per UTC hour, drawn as the three small line charts under the earnings chart.
Package usage keeps what each container costs this machine over time: CPU, memory and network traffic, per container per UTC hour, drawn as the three small line charts under the earnings chart.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL