{"id":47688211,"url":"https://github.com/geiserx/cashpilot","last_synced_at":"2026-08-04T23:00:27.918Z","repository":{"id":346797385,"uuid":"1191597368","full_name":"GeiserX/CashPilot","owner":"GeiserX","description":"Self-hosted passive income platform. Deploy once, earn everywhere. Web UI guides you through setup, deploys containers, and tracks earnings — all from your browser.","archived":false,"fork":false,"pushed_at":"2026-07-31T15:41:01.000Z","size":2596,"stargazers_count":36,"open_issues_count":6,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-07-31T16:14:04.319Z","etag":null,"topics":["bandwidth-sharing","container-management","dashboard","depin","docker","docker-compose","earnapp","earnings-tracker","fastapi","homelab","honeygain","iproyal","mysterium","packetstream","passive-income","peer2profit","python","self-hosted","traffmonetizer","web-ui"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GeiserX.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null,"disclosure":null},"funding":{"github":"geiserx","patreon":"geiser","buy_me_a_coffee":"geiser","thanks_dev":"u/gh/geiserx"}},"created_at":"2026-03-25T12:01:09.000Z","updated_at":"2026-07-31T15:40:15.000Z","dependencies_parsed_at":"2026-06-07T20:02:18.941Z","dependency_job_id":null,"html_url":"https://github.com/GeiserX/CashPilot","commit_stats":null,"previous_names":["geiserx/cashpilot"],"tags_count":151,"template":false,"template_full_name":null,"purl":"pkg:github/GeiserX/CashPilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2FCashPilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2FCashPilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2FCashPilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2FCashPilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GeiserX","download_url":"https://codeload.github.com/GeiserX/CashPilot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GeiserX%2FCashPilot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36291062,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-08-04T02:00:06.901Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bandwidth-sharing","container-management","dashboard","depin","docker","docker-compose","earnapp","earnings-tracker","fastapi","homelab","honeygain","iproyal","mysterium","packetstream","passive-income","peer2profit","python","self-hosted","traffmonetizer","web-ui"],"created_at":"2026-04-02T15:04:27.950Z","updated_at":"2026-08-04T23:00:27.911Z","avatar_url":"https://github.com/GeiserX.png","language":"Python","funding_links":["https://github.com/sponsors/geiserx","https://patreon.com/geiser","https://buymeacoffee.com/geiser","https://thanks.dev/u/gh/geiserx"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/banner.svg\" alt=\"CashPilot\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hub.docker.com/r/drumsergio/cashpilot\"\u003e\u003cimg alt=\"Docker Pulls\" src=\"https://img.shields.io/docker/pulls/drumsergio/cashpilot?style=flat-square\u0026logo=docker\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/GeiserX/CashPilot/stargazers\"\u003e\u003cimg alt=\"GitHub Stars\" src=\"https://img.shields.io/github/stars/GeiserX/CashPilot?style=flat-square\u0026logo=github\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License: GPL-3.0\" src=\"https://img.shields.io/github/license/GeiserX/CashPilot?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/GeiserX/CashPilot/actions/workflows/test.yml\"\u003e\u003cimg alt=\"Tests\" src=\"https://img.shields.io/github/actions/workflow/status/GeiserX/CashPilot/test.yml?style=flat-square\u0026label=tests\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/GeiserX/CashPilot\"\u003e\u003cimg alt=\"codecov\" src=\"https://codecov.io/gh/GeiserX/CashPilot/graph/badge.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What is CashPilot?\n\nCashPilot 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.\n\nIt 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.\n\nThe 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.\n\n![Dashboard](docs/screenshot-dashboard.png)\n\n## Features\n\n- **Web-based setup wizard** with guided account creation for each service\n- **One-click container deployment** for 16+ passive income services\n- **Real-time earnings dashboard** with historical charts and trend analysis\n- **Container health monitoring** -- CPU, memory, network, and uptime at a glance\n- **Multi-category support** -- bandwidth sharing, DePIN, storage sharing, GPU compute\n- **Automatic earnings collection** from service APIs and dashboards\n- **Mobile-responsive dark UI** -- manage your fleet from any device\n- **Simple two-container setup** -- UI + Worker, no dependencies to install\n- **Service catalog** with earning estimates, requirements, and platform details\n\n## Quick Start\n\nWith Docker Compose (recommended):\n\n```bash\ndocker compose up -d\n# Open http://localhost:8080\n```\n\nThis starts two containers:\n\n- **cashpilot-ui** -- Web dashboard, earnings collection, service catalog (port 8080)\n- **cashpilot-worker** -- Docker agent that deploys and monitors service containers (port 8081, requires Docker socket)\n\nThen open [http://localhost:8080](http://localhost:8080) and follow the setup wizard. On first start, CashPilot prints a one-time **setup token** to the `cashpilot-ui` container logs (`docker compose logs cashpilot-ui`) — enter it on the registration form to create the first (owner) account. See [Getting Started](https://geiserx.github.io/CashPilot/getting-started/) for details.\n\n\u003e **Security — network exposure.** By default the dashboard is published on **loopback only** (`127.0.0.1:8080`), because it can command the Docker-socket worker. To reach it from another machine, set `CASHPILOT_BIND_ADDR` to a specific interface (e.g. a Tailscale/VPN IP) or, preferably, run an authenticating reverse proxy in front. **Never publish the worker's port (`8081`) on a public interface** — it exposes a Docker-socket API equivalent to root on the host.\n\n\u003e **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.\n\n## Supported Services\n\n### Docker-Deployable Services\n\nServices CashPilot can deploy and manage automatically via Docker.\n\n\u003c!-- BEGIN GENERATED: docker-services --\u003e\n| Service | Guide | Residential IP required | VPS allowed | Devices / Acct | Devices / IP | Payout |\n|---------|-------|:-:|:-:|:-:|:-:|--------|\n| [Anyone Protocol](https://anyone.io) | [Guide](docs/guides/anyone-protocol.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto |\n| [Bitping](https://app.bitping.com) | [Guide](docs/guides/bitping.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto (SOL) |\n| [Earn.fm](https://earn.fm/ref/GEISYB91) | [Guide](docs/guides/earnfm.md) | ✅ | ✅ | ? \\*\\*\\* | 1 | Crypto |\n| [EarnApp](https://earnapp.com/i/TSMD9wSm) \\*\\*\\*\\* | [Guide](docs/guides/earnapp.md) | ✅ | ❌ | 15 | ? \\*\\*\\* | PayPal, Amazon Gift Card, Wise |\n| [Honeygain](https://dashboard.honeygain.com/ref/SERGIB4014) | [Guide](docs/guides/honeygain.md) | ✅ | ❌ | 10 | 1 | PayPal, Crypto |\n| [IPRoyal Pawns](https://pawns.app?r=19266874) | [Guide](docs/guides/iproyal.md) | ✅ | ❌ | ? \\*\\*\\* | 1 | PayPal, Crypto, Bank Transfer |\n| [MystNodes](https://mystnodes.co/?referral_code=do7v7YOoBBpbOstKQovX2pUvZYKia4ZhH3QIdNtE) | [Guide](docs/guides/mysterium.md) | ❌ | ✅ | ? \\*\\*\\* | Unlimited | Crypto |\n| [PacketStream](https://packetstream.io/?psr=7xgZ) | [Guide](docs/guides/packetstream.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | PayPal |\n| [Presearch](https://presearch.com/signup?rid=4872322) | [Guide](docs/guides/presearch.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto |\n| [ProxyBase](https://peer.proxybase.org?referral=nXzS3c6iTO) | [Guide](docs/guides/proxybase.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto |\n| [ProxyBase Markets](https://proxybase.xyz?referral=nXzS3c6iTO) | [Guide](docs/guides/proxybase-xyz.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto (USDC) |\n| [ProxyLite](https://proxylite.ru/?r=KMUPRZIZ) | [Guide](docs/guides/proxylite.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto, PayPal |\n| [ProxyRack](https://peer.proxyrack.com/ref/mpwiok3xlaxeycnn5znqlg7ipjeutxyxr6xl7vmn) | [Guide](docs/guides/proxyrack.md) | ❌ | ✅ | 500 | ? \\*\\*\\* | PayPal, Crypto |\n| [Repocket](https://repocket.com/) | [Guide](docs/guides/repocket.md) | ✅ | ❌ | 5 | ? \\*\\*\\* | PayPal, Crypto |\n| [Storj](https://storj.dev/node/get-started/setup) | [Guide](docs/guides/storj.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto |\n| [Traffmonetizer](https://traffmonetizer.com/?aff=2111758) | [Guide](docs/guides/traffmonetizer.md) | ❌ | ✅ | ? \\*\\*\\* | Unlimited | Crypto (USDT), PayPal |\n| [URnetwork](https://ur.io/?referral_code=1Q3G19) | [Guide](docs/guides/urnetwork.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto |\n\u003c!-- END GENERATED: docker-services --\u003e\n\n\u003e \\* Storj nodes on the same /24 subnet share data allocation, reducing per-node earnings.\n\u003e\n\u003e \\*\\* Traffmonetizer ToS requires residential IP, but VPS nodes are accepted in practice.\n\u003e\n\u003e \\*\\*\\*\\* EarnApp's help centre **prohibits** Docker containers, VMs, hosting services and home servers, with account termination and cancellation of pending payments as the stated penalty — which is exactly how CashPilot deploys it. Read the [guide](docs/guides/earnapp.md) before deploying.\n\u003e\n\u003e \\*\\*\\* `?` means the catalog does not record this, so nobody has verified it against the provider. It is **not** a synonym for \"no limit\" — see [per-IP device limits](docs/research/per-ip-device-limits.md) for the values that are sourced. A number widely repeated on review sites is not a source.\n\u003e\n\u003e These tables are **generated from the service YAML** by `scripts/generate_readme_tables.py` and checked in CI, so they cannot drift from the catalog. Edit the YAML, not the table.\n\n### Browser Extension / Desktop Only\n\nThese services have no Docker image. CashPilot lists them in the catalog with signup links and earning estimates, but cannot deploy or monitor them.\n\n\u003c!-- BEGIN GENERATED: extension-services --\u003e\n| Service | Guide | Residential IP required | VPS allowed | Devices / Acct | Devices / IP | Payout | Status |\n|---------|-------|:-:|:-:|:-:|:-:|--------|--------|\n| [Bytelixir](https://bytelixir.com/r/OYEIRE0VSZBZ) | [Guide](docs/guides/bytelixir.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Dawn Internet](https://dawninternet.com/?code=2QLQV97F) | [Guide](docs/guides/dawn.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Deeper Network](https://deeper.network) | [Guide](docs/guides/deeper-network.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Ebesucher](https://www.ebesucher.com/?ref=geiserx) | [Guide](docs/guides/ebesucher.md) | ✅ | ❌ | ? \\*\\*\\* | 1 | PayPal | Active |\n| [Gradient Network](https://app.gradient.network/signup?referralCode=YSKMY7) | [Guide](docs/guides/gradient.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Grass](https://app.grass.io/register?referralCode=kn8FNEPnUr2tMqE) | [Guide](docs/guides/grass.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Helium](https://helium.com) | [Guide](docs/guides/helium.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Nodepay](https://app.nodepay.ai/register?ref=0wzzyznen64j9zx) | [Guide](docs/guides/nodepay.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Nodle](https://nodle.com) | [Guide](docs/guides/nodle.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [PassiveApp](https://passiveapp.com/i/bqpC4M) | [Guide](docs/guides/passiveapp.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto, PayPal | Active |\n| [Sentinel dVPN](https://sentinel.co) | [Guide](docs/guides/sentinel-dvpn.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Spide](https://spide.network/register.html?f3bc51) | [Guide](docs/guides/spide.md) | ✅ | ❌ | ? \\*\\*\\* | 1 | Crypto | Active |\n| [Teneo Protocol](https://dashboard.teneo.pro/?code=CAqef) | [Guide](docs/guides/teneo.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Theta Edge Node](https://thetatoken.org) | [Guide](docs/guides/theta-edge.md) | ❌ | ✅ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Titan Network](https://edge.titannet.info/signup?inviteCode=2GKKJ495) | [Guide](docs/guides/titan.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n| [Uprock](https://link.uprock.com/i/33e8492e) | [Guide](docs/guides/uprock.md) | ✅ | ❌ | ? \\*\\*\\* | ? \\*\\*\\* | Crypto | Active |\n\u003c!-- END GENERATED: extension-services --\u003e\n\n### GPU Compute\n\nGPU-intensive computing services. Requires compatible hardware.\n\n\u003c!-- BEGIN GENERATED: gpu-services --\u003e\n| Service | Guide | Residential IP required | GPU | Min Storage | Payout | Status |\n|---------|-------|:-:|:-:|:-:|--------|--------|\n| [Flux](https://runonflux.io) | [Guide](docs/guides/flux.md) | ❌ | ❌ | 220GB | Crypto | Active |\n| [Golem Network](https://golem.network) | [Guide](docs/guides/golem.md) | ❌ | ❌ | 20GB | Crypto | Active |\n| [io.net](https://io.net) | [Guide](docs/guides/ionet.md) | ❌ | ✅ | N/A | Crypto | Active |\n| [Nosana](https://nosana.io) | [Guide](docs/guides/nosana.md) | ❌ | ✅ | 50GB | Crypto | Active |\n| [Salad](https://salad.io) | [Guide](docs/guides/salad.md) | ✅ | ✅ | N/A | PayPal, Gift Cards | Active |\n| [Vast.ai](https://cloud.vast.ai/?ref_id=452772) | [Guide](docs/guides/vast-ai.md) | ❌ | ✅ | 100GB | Crypto, Bank Transfer | Active |\n\u003c!-- END GENERATED: gpu-services --\u003e\n\n\u003e **Note:** Earnings vary widely by location, hardware, and demand -- see individual guide pages in `docs/guides/` for details.\n\n## How It Works\n\n1. **Deploy CashPilot** -- a single `docker compose up -d` gets you running\n2. **Open the web UI** -- browse the full service catalog at `http://localhost:8080`\n3. **Browse services** -- filter by category, see earning estimates and requirements\n4. **Sign up** -- each service card has a signup link; create accounts as needed\n5. **Enter your credentials** -- the setup wizard collects only what each service needs\n6. **CashPilot deploys and monitors** -- the worker launches containers, health-checks them, and the UI tracks earnings automatically\n\n## Architecture\n\nCashPilot uses a split UI + Worker architecture:\n\n- **UI container** (`drumsergio/cashpilot`) -- FastAPI web application with dashboard, earnings collection, service catalog, and credential storage. No Docker socket needed.\n- **Worker container** (`drumsergio/cashpilot-worker`) -- Agent with Docker socket access that deploys, monitors, and manages service containers. Reports status to the UI via API.\n- **Database:** SQLite -- zero configuration, backed up via the mounted volume\n- **Service definitions:** YAML files in `services/` are the single source of truth for all service metadata, Docker configuration, and earning estimates\n- **Frontend:** Server-rendered templates with a responsive dark UI\n\n```\ncashpilot/\n  app/            # FastAPI application (UI + worker API)\n  services/       # YAML service definitions (source of truth)\n    bandwidth/    # Bandwidth sharing services\n    depin/        # DePIN services\n    storage/      # Storage sharing services\n    compute/      # GPU compute services\n  docs/           # Documentation and guides\n```\n\n## Configuration\n\n### UI Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `TZ` | `UTC` | Timezone for scheduling and display |\n| `CASHPILOT_SECRET_KEY` | *(auto-generated)* | Signing key for login sessions. Persisted at `/data/.secret_key`. **Does not encrypt credentials** |\n| `CASHPILOT_ENCRYPTION_KEY` | *(auto-generated)* | Fernet key encrypting stored credentials at rest. Persisted at `/data/.fernet_key`. Set this only to restore a backup — see [Backing up the encryption key](#backing-up-the-encryption-key) |\n| `CASHPILOT_ALLOW_EPHEMERAL_KEY` | `false` | Allow startup when the encryption key cannot be written to disk. Credentials are then lost on restart, so this is off by default |\n| `CASHPILOT_API_KEY` | -- | Enrollment/bootstrap key; each worker then gets its own key (per-worker fleet keys, v1.0.0+) |\n| `CASHPILOT_COLLECT_INTERVAL` | `60` | Minutes between earnings collection cycles |\n| `CASHPILOT_METRICS_ENABLED` | `false` | Set to `true` to expose Prometheus metrics at `/metrics` |\n| `CASHPILOT_BIND_ADDR` | `127.0.0.1` | Host interface the UI port is published on. Loopback by default; set a specific IP (e.g. a VPN address) or `0.0.0.0` to expose it — prefer a reverse proxy with auth |\n\nThe UI's web port inside the container is fixed at `8080` (set via the container's `CMD`); `CASHPILOT_BIND_ADDR` controls only which host interface it is published on.\n\n### Worker Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `TZ` | `UTC` | Timezone |\n| `CASHPILOT_UI_URL` | -- | URL of the UI container, e.g. `http://cashpilot-ui:8080` |\n| `CASHPILOT_API_KEY` | -- | Must match the UI's API key |\n| `CASHPILOT_WORKER_NAME` | *(hostname)* | Display name for this worker in the fleet dashboard |\n| `CASHPILOT_WORKER_URL` | *(auto-detected)* | URL the UI uses to reach this worker, e.g. `http://192.168.10.50:8081`. Set explicitly for remote/cross-host workers |\n| `CASHPILOT_WORKER_BIND_ADDR` | `127.0.0.1` | Host interface the worker's Docker-socket API port is published on. Loopback by default — for a remote worker set a private/VPN interface, **never** a public IP |\n| `CASHPILOT_PORT` | `8081` | Mini-UI/API port the worker listens on |\n| `CASHPILOT_WORKER_NETWORK` | *(detected)* | `residential` or `hosting`. Overrides the hardware-based guess used to warn about residential-only services |\n| `CASHPILOT_EGRESS_DETECT` | on | Set to `off` to stop this worker looking up its own public IP (see below) |\n| `CASHPILOT_EGRESS_IP` | -- | State this worker's public IP directly instead of looking it up. Must be a public address |\n| `CASHPILOT_EGRESS_IP_URL` | -- | Use your own IP-echo endpoint (returning a bare IP) instead of the public ones. Used **exclusively** — no fallback |\n\n#### Why the worker looks up its public IP\n\nBandwidth providers cap earnings **per IP address, not per machine**. Two\nworkers behind one home connection are two rows on your dashboard and *one*\ncustomer to the provider, so the second one usually earns nothing. To warn you\nbefore that happens, each worker asks a public IP-echo service what address it\ncomes from — one request per hour.\n\nThat is the only outbound call CashPilot makes purely to learn about your setup.\nTurn it off with `CASHPILOT_EGRESS_DETECT=off`, point it at your own endpoint\nwith `CASHPILOT_EGRESS_IP_URL`, or skip the lookup entirely by stating the\naddress with `CASHPILOT_EGRESS_IP`. With detection off, the fleet simply reports\nthat worker's exit as undetermined and raises no conflict warnings for it.\n\nKnown limitation: grouping matches on the exact address, so on a **native-IPv6**\nconnection each machine has its own global address and no conflict is detected.\nThe check is therefore best-effort — it can miss a conflict, but it will not\ninvent one.\n\n\n## Multi-Node Fleet Management\n\nFor 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.\n\n```\nCashPilot UI (dashboard + earnings + catalog)\n        ^                ^                ^\n        | HTTP           | HTTP           | HTTP\n  Worker (server-a)  Worker (server-b)  Worker (server-n)\n  + Docker socket    + Docker socket    + Docker socket\n```\n\n### Setting up the fleet\n\nUse `docker-compose.fleet.yml` on your main server to run both the UI and a local worker:\n\n```bash\ndocker compose -f docker-compose.fleet.yml up -d\n```\n\n### Adding remote workers\n\nOn each additional server, deploy only a worker pointing to the UI:\n\n```yaml\nservices:\n  cashpilot-worker:\n    image: drumsergio/cashpilot-worker:latest\n    pull_policy: always\n    container_name: cashpilot-worker\n    ports:\n      - \"8081:8081\"\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock\n      - cashpilot_worker_data:/data\n    environment:\n      - TZ=Europe/Madrid\n      - CASHPILOT_UI_URL=http://main-server:8080\n      - CASHPILOT_API_KEY=your-shared-api-key\n      - CASHPILOT_WORKER_NAME=server-b\n      - CASHPILOT_WORKER_URL=http://server-b:8081\n    restart: unless-stopped\n    security_opt:\n      - no-new-privileges:true\n\nvolumes:\n  cashpilot_worker_data:\n```\n\nCommunication goes both ways: workers connect outbound to the UI via HTTP for heartbeats, and the UI connects outbound to each worker's `:8081` API to push commands (deploy, stop, restart). This means **the worker must be reachable from the UI** (LAN, Tailscale, or port forwarding) -- set `CASHPILOT_WORKER_URL` to the address the UI should use, since auto-detection falls back to the container's own network interface, which is often unreachable from another host. The UI's fleet dashboard shows all connected workers, their containers, and live status.\n\n## FAQ\n\n**Is bandwidth sharing safe?**\n\nBandwidth 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.**\n\n**How much can I earn?**\n\nEarnings 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.\n\n**Can I run on a VPS or cloud server?**\n\nSome 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.\n\n**How are credentials stored?**\n\nAll service credentials are encrypted at rest in the SQLite database using a Fernet key stored at `/data/.fernet_key`, which is generated automatically on first run. The database file lives in the mounted Docker volume (`cashpilot_data:/data`). No credentials are ever sent anywhere except to the service containers themselves.\n\nNote that this is a different key from `CASHPILOT_SECRET_KEY`, which only signs login sessions.\n\n### Backing up the encryption key\n\nYour credentials are only as recoverable as `/data/.fernet_key`. If you lose that file you will have to re-enter every credential, because there is no way to decrypt the stored values without it.\n\n```bash\n# Back it up\ndocker exec cashpilot-ui cat /data/.fernet_key\n\n# Restore onto a fresh volume: pass the saved value when starting CashPilot.\n# It must reach the container, so put it on the same command line (or export it,\n# or set it in your .env) - a bare shell assignment on its own line does nothing.\nCASHPILOT_ENCRYPTION_KEY=\u003cthe value you saved\u003e docker compose up -d\n```\n\nThe file always takes precedence over the environment variable, so setting `CASHPILOT_ENCRYPTION_KEY` on an instance that already has a key changes nothing and is safe. It is adopted only when no key file exists, which is exactly the restore case.\n\nIf the key cannot be written to disk at all — an unwritable or unmounted `/data` — CashPilot refuses to start rather than encrypting your credentials under a key that disappears on the next restart. Set `CASHPILOT_ALLOW_EPHEMERAL_KEY=true` if that is genuinely what you want.\n\n**What about security?**\n\nEvery 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.\n\nThat 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.\n\n**What happens if a service container crashes?**\n\nCashPilot 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.\n\n## Disclosure\n\n\u003e 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.\n\n## Ecosystem\n\n| Project | Type | Description |\n|---------|------|-------------|\n| [CashPilot-android](https://github.com/GeiserX/CashPilot-android) | Android Agent | Monitoring agent for passive income apps running on Android devices |\n| [cashpilot-mcp](https://github.com/GeiserX/cashpilot-mcp) | MCP Server | Monitor earnings from AI assistants via the Model Context Protocol |\n| [cashpilot-ha](https://github.com/GeiserX/cashpilot-ha) | Home Assistant Integration | Earnings and service status sensors for your smart home dashboard |\n| [n8n-nodes-cashpilot](https://github.com/GeiserX/n8n-nodes-cashpilot) | n8n Community Node | Automate earnings workflows in n8n |\n\n## Contributing\n\nContributions are welcome. To add a new service:\n\n1. Create a YAML file in the appropriate `services/` subdirectory following `services/_schema.yml`\n2. Add a guide page in `docs/guides/` for the service\n3. Update the service tables in this README\n4. Submit a pull request\n\nFor bug reports and feature requests, open an issue on GitHub.\n\n## Discontinued / Broken Services\n\nServices 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.\n\n| Service | Status | Reason | Last checked |\n|---------|--------|--------|:------------:|\n| SpeedShare | Dead | Project confirmed dead in Discord | Mar 2026 |\n| Peer2Profit | Dead | Domain unreachable | Mar 2026 |\n| PacketShare | Dead | Signup process broken, no progress | Mar 2026 |\n| earn.cc | Broken | Server error on signup | Mar 2026 |\n| WizardGain | Broken | Under maintenance indefinitely | Mar 2026 |\n| Koii Network | Broken | Website says paused | Mar 2026 |\n| Network3 | Broken | No SSL, no updates in months | Mar 2026 |\n| GagaNode | Shady | Poorly made website, untrustworthy | Mar 2026 |\n| BlockMesh (Perceptron) | Dropped | Rebranded, requires browser dev mode, shady | Mar 2026 |\n| Bytebenefit | Dead | Domain sold/parked on marketplace | Mar 2026 |\n| Wipter | Dead | Domain resolves to DNS sinkhole, infrastructure gone | Mar 2026 |\n| Filecoin | Not viable | Enterprise-only (10 TiB min, datacenter infrastructure required) | Mar 2026 |\n| AntGain | Dead | Telegram channel unavailable | Mar 2026 |\n\n## How CashPilot Compares\n\nThere are several good open-source projects in this space, and the honest summary is that they overlap more than they differ. [money4band](https://github.com/MRColorR/money4band) is the most mature of them: it supports 20+ apps, ships a web dashboard, and is actively developed. If you want to run a handful of bandwidth-sharing apps on one machine, it is a perfectly good choice and has been doing this longer than CashPilot has.\n\nCashPilot is built around three things that shape its whole design:\n\n- **A fleet, not a machine.** One dashboard holds the state for many servers, each running a worker. Earnings are collected centrally exactly once, so nothing is double-counted, and every figure drills down per server and per service.\n- **Earnings pulled from the providers themselves.** 15 collectors authenticate against provider APIs and dashboards and record real balances into a local history, rather than reporting that a container is running. That is what makes \"running but not earning\" detectable at all.\n- **Breadth beyond bandwidth.** 50 catalogued services spanning bandwidth sharing, DePIN, storage and GPU compute, each with a setup guide, a payout method, and a status that is re-checked weekly in CI.\n\nIf none of those matter to you, use whichever tool you prefer — they will all start the same containers.\n\n\u003e **On this section.** It deliberately avoids a feature matrix claiming what other projects lack. Those tables go stale the moment someone ships a release, and a comparison a reader can falsify in thirty seconds is worse than no comparison at all. If anything above is out of date, please open an issue.\n\n## License\n\n[GPL-3.0](LICENSE) -- Sergio Fernandez, 2026\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeiserx%2Fcashpilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeiserx%2Fcashpilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeiserx%2Fcashpilot/lists"}