README.md

May 25, 2026 · View on GitHub

CashPilot

Docker Pulls GitHub Stars License: GPL-3.0 Tests codecov

What is CashPilot?

CashPilot is a self-hosted platform that lets you deploy, manage, and monitor passive income services from a single web interface. Instead of manually setting up dozens of Docker containers, configuring credentials, and checking multiple dashboards, CashPilot handles everything from one place.

It supports both Docker-based services (deployed and managed automatically) and browser extension / desktop-only services (tracked via the web UI with signup links, earning estimates, and balance monitoring). Whether a service runs in a container or in your browser, CashPilot aggregates all your earnings into a unified dashboard with historical tracking.

The key differentiator: a browser-based setup wizard guides you through account creation and service deployment, orchestrates containers through Docker workers, and collects earnings from 40+ services across bandwidth sharing, DePIN, storage, and GPU compute categories.

Dashboard

Features

  • Web-based setup wizard with guided account creation for each service
  • One-click container deployment for 16+ passive income services
  • Real-time earnings dashboard with historical charts and trend analysis
  • Container health monitoring -- CPU, memory, network, and uptime at a glance
  • Multi-category support -- bandwidth sharing, DePIN, storage sharing, GPU compute
  • Automatic earnings collection from service APIs and dashboards
  • Mobile-responsive dark UI -- manage your fleet from any device
  • Simple two-container setup -- UI + Worker, no dependencies to install
  • Service catalog with earning estimates, requirements, and platform details

Quick Start

With Docker Compose (recommended):

docker compose up -d
# Open http://localhost:8080

This starts two containers:

  • cashpilot-ui -- Web dashboard, earnings collection, service catalog (port 8080)
  • cashpilot-worker -- Docker agent that deploys and monitors service containers (port 8081, requires Docker socket)

Then open http://localhost:8080 and follow the setup wizard.

Note: The worker container requires access to the Docker socket (/var/run/docker.sock) to deploy and manage service containers. Both containers are required for full functionality.

Supported Services

Docker-Deployable Services

Services CashPilot can deploy and manage automatically via Docker.

ServiceGuideResidential IPVPS IPDevices / AcctDevices / IPPayout
Anyone ProtocolGuide✅✅Unlimited1Crypto (ANYONE)
BitpingGuide✅✅Unlimited1Crypto (SOL)
Earn.fmGuide✅✅Unlimited1Crypto
EarnAppGuide✅❌151PayPal, Gift Cards, Wise
HoneygainGuide✅❌101PayPal, Crypto
IPRoyal PawnsGuide✅❌Unlimited1PayPal, Crypto, Bank Transfer
MystNodesGuide✅✅UnlimitedUnlimitedCrypto (MYST)
PacketStreamGuide✅❌Unlimited1PayPal
PresearchGuide✅✅Unlimited1Crypto (PRE)
ProxyBaseGuide✅❌Unlimited1Crypto
ProxyLiteGuide✅✅Unlimited1Crypto, PayPal
ProxyRackGuide✅✅5001PayPal, Crypto
RepocketGuide✅❌52PayPal, Crypto
StorjGuide✅✅Unlimited1 *Crypto (STORJ)
TraffmonetizerGuide✅✅ **UnlimitedUnlimitedCrypto (USDT), PayPal
URnetworkGuide✅✅Unlimited1Crypto

* Storj nodes on the same /24 subnet share data allocation, reducing per-node earnings.

** Traffmonetizer ToS requires residential IP, but VPS nodes are accepted in practice.

Browser Extension / Desktop Only

These services have no Docker image. CashPilot lists them in the catalog with signup links and earning estimates, but cannot deploy or monitor them.

ServiceGuideResidential IPVPS IPDevices / AcctDevices / IPPayoutStatus
BytelixirGuide✅❌Unlimited1CryptoActive
Dawn InternetGuide✅❌Unlimited1Crypto (DAWN)Active
Deeper NetworkGuide✅❌Unlimited1Crypto (DPR)Active
EbesucherGuide✅✅Unlimited1PayPalActive
Gradient NetworkGuide✅❌Unlimited1Crypto (GRADIENT)Active
GrassGuide✅❌Unlimited1Crypto (GRASS)Active
HeliumGuide✅❌Unlimited1Crypto (HNT)Active
NodepayGuide✅❌Unlimited1Crypto (NC)Active
NodleGuide✅✅Unlimited1Crypto (NODL)Active
PassiveAppGuide✅❌Unlimited1Crypto, PayPalActive
Sentinel dVPNGuide✅✅Unlimited1Crypto (DVPN)Active
SpideGuide✅❌Unlimited1CryptoActive
Teneo ProtocolGuide✅❌Unlimited1Crypto (TENEO)Active
Theta Edge NodeGuide✅✅Unlimited1Crypto (TFUEL)Active
Titan NetworkGuide✅❌Unlimited1Crypto (TNT)Active
UprockGuide✅❌Unlimited1CryptoActive

GPU Compute

GPU-intensive computing services. Requires compatible hardware.

ServiceGuideResidential IPGPUMin StoragePayoutStatus
FluxGuide✅❌220GBCrypto (FLUX)Active
Golem NetworkGuide✅❌20GBCrypto (GLM)Active
io.netGuide✅✅N/ACrypto (IO)Active
NosanaGuide✅✅50GBCrypto (NOS)Active
SaladGuide✅✅N/APayPal, Gift CardsActive
Vast.aiGuide✅✅100GBCrypto, Bank TransferActive

Note: Earnings vary widely by location, hardware, and demand -- see individual guide pages in docs/guides/ for details.

How It Works

  1. Deploy CashPilot -- a single docker compose up -d gets you running
  2. Open the web UI -- browse the full service catalog at http://localhost:8080
  3. Browse services -- filter by category, see earning estimates and requirements
  4. Sign up -- each service card has a signup link; create accounts as needed
  5. Enter your credentials -- the setup wizard collects only what each service needs
  6. CashPilot deploys and monitors -- the worker launches containers, health-checks them, and the UI tracks earnings automatically

Architecture

CashPilot uses a split UI + Worker architecture:

  • UI container (drumsergio/cashpilot) -- FastAPI web application with dashboard, earnings collection, service catalog, and credential storage. No Docker socket needed.
  • Worker container (drumsergio/cashpilot-worker) -- Agent with Docker socket access that deploys, monitors, and manages service containers. Reports status to the UI via API.
  • Database: SQLite -- zero configuration, backed up via the mounted volume
  • Service definitions: YAML files in services/ are the single source of truth for all service metadata, Docker configuration, and earning estimates
  • Frontend: Server-rendered templates with a responsive dark UI
cashpilot/
  app/            # FastAPI application (UI + worker API)
  services/       # YAML service definitions (source of truth)
    bandwidth/    # Bandwidth sharing services
    depin/        # DePIN services
    storage/      # Storage sharing services
    compute/      # GPU compute services
  docs/           # Documentation and guides

Configuration

UI Environment Variables

VariableDefaultDescription
TZUTCTimezone for scheduling and display
CASHPILOT_SECRET_KEY(auto-generated)Encryption key for stored credentials
CASHPILOT_API_KEY--Shared secret between UI and workers for API authentication
CASHPILOT_COLLECTION_INTERVAL3600Seconds between earnings collection cycles
CASHPILOT_PORT8080Web UI port inside the container
CASHPILOT_METRICS_ENABLEDfalseSet to true to expose Prometheus metrics at /metrics

Worker Environment Variables

VariableDefaultDescription
TZUTCTimezone
CASHPILOT_UI_URL--URL of the UI container, e.g. http://cashpilot-ui:8080
CASHPILOT_API_KEY--Must match the UI's API key
CASHPILOT_WORKER_NAME(hostname)Display name for this worker in the fleet dashboard

Multi-Node Fleet Management

For power users running services across multiple servers, deploy a single CashPilot UI and connect workers from each server. The UI aggregates everything into a unified fleet view; workers report via HTTP API.

CashPilot UI (dashboard + earnings + catalog)
        ^                ^                ^
        | HTTP           | HTTP           | HTTP
  Worker (server-a)  Worker (server-b)  Worker (server-n)
  + Docker socket    + Docker socket    + Docker socket

Setting up the fleet

Use docker-compose.fleet.yml on your main server to run both the UI and a local worker:

docker compose -f docker-compose.fleet.yml up -d

Adding remote workers

On each additional server, deploy only a worker pointing to the UI:

services:
  cashpilot-worker:
    image: drumsergio/cashpilot-worker:latest
    container_name: cashpilot-worker
    ports:
      - "8081:8081"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - cashpilot_worker_data:/data
    environment:
      - TZ=Europe/Madrid
      - CASHPILOT_UI_URL=http://main-server:8080
      - CASHPILOT_API_KEY=your-shared-api-key
      - CASHPILOT_WORKER_NAME=server-b
    restart: unless-stopped
    security_opt:
      - no-new-privileges:true

volumes:
  cashpilot_worker_data:

Workers connect outbound to the UI via HTTP -- no port forwarding needed on the worker side. The UI's fleet dashboard shows all connected workers, their containers, and live status. The UI can push commands (deploy, stop, restart) to any worker remotely.

FAQ

Is bandwidth sharing safe?

Bandwidth sharing services generally route legitimate traffic (market research, ad verification, price comparison, content delivery) through your connection. That said, you are sharing your IP address, so review each service's terms of service and privacy policy carefully before signing up. Running these on a VPS rather than residential IP is an option for some services. This is not legal advice -- consult with the particular services you intend to use and, if needed, seek independent legal counsel regarding your jurisdiction.

How much can I earn?

Earnings vary widely based on location, ISP, number of devices, and which services you run. The dashboard tracks your actual earnings over time so you can optimize your setup.

Can I run on a VPS or cloud server?

Some services require a residential IP and will not pay (or will ban) VPS/datacenter IPs. These are marked as "Residential Only" in the service catalog. Services that work on VPS are a good way to scale up without additional home hardware.

How are credentials stored?

All service credentials are encrypted at rest in the SQLite database using your CASHPILOT_SECRET_KEY. The database file lives in the mounted Docker volume (cashpilot_data:/data). No credentials are ever sent anywhere except to the service containers themselves.

What about security?

Every service CashPilot deploys runs inside its own isolated Docker container. Containers cannot access your host filesystem, other containers, or your local network unless explicitly configured to do so. CashPilot further hardens deployments with --security-opt no-new-privileges, preventing privilege escalation inside containers. Service credentials are encrypted at rest using Fernet symmetric encryption. Only the worker container requires Docker socket access; the UI container has no privileged access.

That said, no setup is bulletproof. You are still running third-party software that routes external traffic through your network. Docker isolation significantly reduces the attack surface compared to running these services directly on your host, but it does not eliminate all risk. We recommend running CashPilot on a dedicated machine or VLAN, keeping Docker and your host OS up to date, and reviewing the open-source code of any service before deploying it.

What happens if a service container crashes?

CashPilot monitors container health continuously. If a service container exits unexpectedly, it is automatically restarted. The dashboard shows uptime and health status for every running service.

Disclosure

This project contains affiliate/referral links. If you sign up through these links, the project maintainer may earn a small commission at no extra cost to you. This helps support the development of CashPilot. You are free to replace all referral codes with your own in the Settings page.

Ecosystem

ProjectTypeDescription
CashPilot-androidAndroid AgentMonitoring agent for passive income apps running on Android devices
cashpilot-mcpMCP ServerMonitor earnings from AI assistants via the Model Context Protocol
cashpilot-haHome Assistant IntegrationEarnings and service status sensors for your smart home dashboard
n8n-nodes-cashpilotn8n Community NodeAutomate earnings workflows in n8n

Contributing

Contributions are welcome. To add a new service:

  1. Create a YAML file in the appropriate services/ subdirectory following services/_schema.yml
  2. Add a guide page in docs/guides/ for the service
  3. Update the service tables in this README
  4. Submit a pull request

For bug reports and feature requests, open an issue on GitHub.

Discontinued / Broken Services

Services that were evaluated but are no longer listed in the catalog due to being dead, broken, or untrustworthy. Kept here for reference so they are not re-added.

ServiceStatusReasonLast checked
SpeedShareDeadProject confirmed dead in DiscordMar 2026
Peer2ProfitDeadDomain unreachableMar 2026
PacketShareDeadSignup process broken, no progressMar 2026
earn.ccBrokenServer error on signupMar 2026
WizardGainBrokenUnder maintenance indefinitelyMar 2026
Koii NetworkBrokenWebsite says pausedMar 2026
Network3BrokenNo SSL, no updates in monthsMar 2026
GagaNodeShadyPoorly made website, untrustworthyMar 2026
BlockMesh (Perceptron)DroppedRebranded, requires browser dev mode, shadyMar 2026
BytebenefitDeadDomain sold/parked on marketplaceMar 2026
WipterDeadDomain resolves to DNS sinkhole, infrastructure goneMar 2026
FilecoinNot viableEnterprise-only (10 TiB min, datacenter infrastructure required)Mar 2026
AntGainDeadTelegram channel unavailableMar 2026

How CashPilot Compares

FeatureCashPilotmoney4bandCashFactoryincome-generatorInternetIncome
Web UI with guided setupYesNo (CLI)Partial (links only)No (CLI)No (CLI)
One-click container deployYesNo (compose)No (compose)NoNo (compose)
Earnings dashboardYesNoNoNoNo
Historical chartsYesNoNoNoNo
Multi-node fleet managementYesNoNoNoNo
Service catalog with guides49 services178148
Automated earnings collection13 collectors0000
Multi-arch (amd64 + arm64)YesYesYesNoNo
Credential encryptionYesNoNoNoNo
Compose exportYesYesYesYesYes

License

GPL-3.0 -- Sergio Fernandez, 2026