Portainer Templates logo

Portainer Templates

CashPilot CashPilot

Container

ToolsMonitoring

Self-hosted passive income orchestrator for bandwidth sharing, DePIN, storage, and GPU compute services. Source: https://github.com/GeiserX/CashPilot

Image details

Pulls: 41.0k
Architecture: amd64, arm64
Image size: 32 MB
Latest: 1.39
User: drumsergio
Created: Mar 25, 2026
Updated: 15 hours ago
Status: active

Source details

Stars: 53
Forks: 14
Language: Python
License: GPL-3.0
Updated: 8 hours ago

Configuration

Type
Container
Platform
linux
Image
drumsergio/cashpilot:latest
Ports
8080:8080/tcp
Volumes
/data
Env vars
TZ=UTCCASHPILOT_SECRET_KEY=CASHPILOT_API_KEY=
Restart
unless-stopped

Notes

This template deploys only the CashPilot UI. To actually deploy and manage earning services you also need the companion worker container (drumsergio/cashpilot-worker) with Docker-socket access, paired via CASHPILOT_API_KEY. See the repo for the full compose.

Standalone Install

Select an install method, to see config/commands for deploying CashPilot

Installation method

Install on Portainer

Import all app templates into your Portainer instance, for easy 1-click deploys

  1. Ensure both Docker and Portainer are installed, and up-to-date
  2. Log into your Portainer web UI
  3. Under Settings → App Templates, paste the below URL
  4. Head to Home → App Templates, and the list of apps will show up
  5. Select CashPilot, fill in any config options, and hit Deploy

Template Import URL

https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json
Show Me demo

More install options in our documentation, or see GeiserX/CashPilot for app-specific guidance.

CashPilot


Release Tests License Docker Pulls codecov


CashPilot is a self-hosted platform to deploy, manage and monitor passive income services from one web interface. It runs as two Docker containers, deploys the Docker-based services for you, and tracks the browser-extension and desktop-only ones with signup links and balance monitoring. Its catalog covers 39 active services (50 in total) across bandwidth sharing, DePIN, storage and GPU compute, and it collects their earnings into one dashboard with history.
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
  • Runs on x86-64 and ARM -- Raspberry Pi, Apple Silicon and ARM cloud boxes; see Running on ARM
  • Service catalog with earning estimates, requirements, and platform details

Quick Start

curl -fsSLO https://raw.githubusercontent.com/GeiserX/CashPilot/main/docker-compose.yml
docker compose up -d
docker compose logs cashpilot-ui | grep -i "setup token"   # then open http://localhost:8080

This starts cashpilot-ui (dashboard, earnings collection, catalog, port 8080) and cashpilot-worker (Docker agent, port 8081, needs the Docker socket). Open http://localhost:8080 and enter the one-time setup token from docker compose logs cashpilot-ui to create the owner account. See Getting Started for details.
Security. The dashboard is published on loopback only (127.0.0.1:8080) because it can command the Docker-socket worker. Never publish the worker's port (8081) on a public interface. Remote access and fleet setup are in the configuration reference and fleet guide.

Supported Services

Docker-Deployable Services

Services CashPilot can deploy and manage automatically via Docker.

ServiceGuideResidential IP requiredVPS allowedDevices / AcctDevices / IPPayout
Anyone ProtocolGuide❌✅? \*\\? \*\\Crypto
BitpingGuide❌✅? \*\\? \*\\Crypto (SOL)
Earn.fmGuide✅✅? \*\\1Crypto
EarnApp \*\\\Guide✅❌15? \*\\PayPal, Amazon Gift Card, Wise
HoneygainGuide✅❌101PayPal, Crypto
IPRoyal PawnsGuide✅❌? \*\\1PayPal, Crypto, Bank Transfer
MystNodesGuide❌✅? \*\\UnlimitedCrypto
PacketStreamGuide✅❌? \*\\? \*\\PayPal
ProxyBaseGuide❌✅? \*\\? \*\\Crypto
ProxyBase MarketsGuide❌✅? \*\\? \*\\Crypto (USDC)
ProxyLiteGuide❌✅? \*\\? \*\\Crypto, PayPal
ProxyRackGuide❌✅500? \*\\PayPal, Crypto
RepocketGuide✅❌5? \*\\PayPal, Crypto
StorjGuide❌✅? \*\\? \*\\Crypto (USDC)
TraffmonetizerGuide❌✅? \*\\UnlimitedCrypto (USDT), PayPal
URnetworkGuide❌✅? \*\\? \*\\Crypto

\ 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.
\
\\\ 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 before deploying.
\\\ ? 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 for the values that are sourced. A number widely repeated on review sites is not a source.
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.

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 IP requiredVPS allowedDevices / AcctDevices / IPPayoutStatus
BytebenefitGuide✅❌? \*\\? \*\\PayPalActive
BytelixirGuide✅❌? \*\\? \*\\CryptoActive
Dawn InternetGuide✅❌? \*\\? \*\\CryptoActive
Deeper NetworkGuide✅❌? \*\\? \*\\CryptoActive
EbesucherGuide✅❌? \*\\1PayPalActive
Gradient NetworkGuide✅❌? \*\\? \*\\CryptoActive
GrassGuide✅❌? \*\\? \*\\CryptoActive
HeliumGuide✅❌? \*\\? \*\\CryptoActive
NodepayGuide✅❌? \*\\? \*\\CryptoActive
NodleGuide❌✅? \*\\? \*\\CryptoActive
PassiveAppGuide✅❌? \*\\? \*\\Crypto, PayPalActive
Sentinel dVPNGuide❌✅? \*\\? \*\\CryptoActive
SpideGuide✅❌? \*\\1CryptoActive
Teneo ProtocolGuide✅❌? \*\\? \*\\CryptoActive
Theta Edge NodeGuide❌✅? \*\\? \*\\CryptoActive
Titan NetworkGuide✅❌? \*\\? \*\\CryptoActive
UprockGuide✅❌? \*\\? \*\\CryptoActive

GPU Compute

GPU-intensive computing services. Requires compatible hardware.

ServiceGuideResidential IP requiredGPUMin StoragePayoutStatus
FluxGuide❌❌220GBCryptoActive
Golem NetworkGuide❌❌20GBCryptoActive
io.netGuide❌✅N/ACryptoActive
NosanaGuide❌✅50GBCryptoActive
SaladGuide✅✅N/APayPal, Gift CardsActive
Vast.aiGuide❌✅100GBCrypto, Bank TransferActive

Disclosure. The signup links in CashPilot and in this README are referral links. If you sign up through one, the maintainer may earn a commission, at no cost to you, which helps fund CashPilot's development. To avoid them, sign up on the provider's own website instead.

FAQ

Is bandwidth sharing safe? How much can I earn? Can I run on a VPS? How are credentials stored, and how do I back up the key? The answers are in the FAQ.

Documentation

Full documentation: geiserx.github.io/CashPilot.

Upgrading an existing install? Read UPGRADING.md first. It lists only the releases that need you to do something.

License

GPL-3.0-or-later. Sergio Fernandez, 2026.

Serve CashPilot on your own domain behind Caddy, Nginx or Traefik. Fill in your domain and copy the result. It's a starting point, some apps need their own base URL or extra headers set too.

Proxying cashpilot.example.com to http://cashpilot:8080

Add this to your Caddyfile

cashpilot.example.com {
	reverse_proxy http://cashpilot:8080
}

Check the logs first

Nine times out of ten the logs tell you exactly what went wrong.

  • In Portainer, go to Containers, click the container, then Logs. Or run docker logs cashpilot
  • Exit codes help too: 137 means killed, usually out of memory. 126 or 127 means the command inside the image is broken.

Port already in use

If deployment fails with "Bind for 0.0.0.0:8080 failed: port is already allocated", something else on your server is using that port.

  • Find what's using it: sudo ss -tlnp | grep :8080
  • Stop the other service, or pick a different host port. In 8080:8080 only the left number is yours to change, the right one belongs to the app.

Running but the page won't load

The container is up but nothing appears in your browser.

  • Use your server's real IP: http://your-server-ip:8080. The 0.0.0.0 link Portainer shows isn't a real address.
  • Give it a minute after first deploy, cashpilot can take a while to initialise.
  • Make sure your firewall allows the port, e.g. sudo ufw allow 8080

Image won't pull

Test the pull directly on the host: docker pull drumsergio/cashpilot:latest

  • "manifest unknown" means the tag no longer exists. This template uses latest, so try pinning a specific version instead.
  • "toomanyrequests" is the Docker Hub rate limit. Log in with docker login to raise it.
  • "no space left on device" means a full disk. Reclaim space with docker system prune

"exec format error"

This means the image was built for a different CPU architecture than your server.

  • This image supports: amd64, arm64
  • Check yours with uname -m: x86_64 is amd64, aarch64 is arm64. Raspberry Pi and other ARM boards are the usual culprits.

Container keeps restarting

The unless-stopped restart policy relaunches the app after every crash, so the real error can scroll past.

  • Check the logs right after a restart, the last few lines before it died are the useful ones.
  • Get the exit code with docker inspect cashpilot --format '{{.State.ExitCode}}'
  • Still stuck? Redeploy once with the restart policy set to no so the failure stays visible.

Required settings are blank

CASHPILOT_SECRET_KEY, CASHPILOT_API_KEY have no default value, and cashpilot may crash or misbehave if left empty.

  • Fill them in on the deploy screen before hitting deploy.

Raise an issue

Found something which isn't working as it should? Here's how to report it.

A single container

CashPilot runs as one container, the simplest kind of app here. Just the one image to pull and nothing else wired up alongside it.

The app image

An image is the app packed up ready to go, everything CashPilot needs bundled into one download. This template pulls drumsergio/cashpilot:latest, which Docker fetches once (about 32 MB) and then starts your own copy from.

Where the image comes from

Docker pulls its images from registries, public libraries of ready-built apps. CashPilot's comes from Docker Hub, published by drumsergio.

Version tags

The bit after the colon in the image name is the version tag. Here it's latest, which always points at the newest build, so a redeploy can bump you to a newer release without you asking. Newest right now is 1.39. Pin a specific tag if you would rather stay on one version.

Which machines it runs on

Every image is built for particular CPU types. This one ships for amd64, arm64, so it runs on both regular x86 servers and ARM boards like a Raspberry Pi.

Ports

A port is the door the app answers on. A mapping like 8080:8080 means it's reachable on port 8080 of your server, where the left number is yours to change and the right one belongs to the app. Once it's running, open http://your-server-ip:8080 in a browser. It opens:

  • 8080:8080, likely the web interface

Volumes

A volume is where CashPilot keeps its files so they survive an update or a restart. Without one, anything it saves would sit inside the container and vanish the moment it's recreated. This template mounts:

  • /data as a volume Docker manages for you

Environment variables

Environment variables are the settings you hand over when you deploy, things like a password or a timezone. CashPilot takes 3 of them, and 2 need a value before it'll start properly:

  • TZ, defaults to UTC. Timezone
  • CASHPILOT_SECRET_KEY, needs a value. Encryption key — blank to auto-generate (set a fixed value to keep stored credentials across redeploys)
  • CASHPILOT_API_KEY, needs a value. Worker enrollment key (optional)

Restart policy

The restart policy here is unless-stopped, so Docker restarts CashPilot after a crash or reboot, but leaves it off when you stop it on purpose. You can change this on the deploy screen. The choices are no (never restart), on-failure (only after a crash), unless-stopped (restart unless you stop it), and always (bring it back no matter what).

Networking

Nothing custom is set, so CashPilot sits on Docker's default bridge network: its own private space that reaches the outside world only through the ports it publishes.

Container name

Once it's deployed, Portainer names the container cashpilot. That's what you'll spot in the containers list and use in commands like docker logs cashpilot.

Platform

The platform is linux, the kind of system the container is built to run on. Docker and Portainer handle this on a normal Linux server.

Open source license

CashPilot is open source, released under the GPL-3.0 license. In plain terms the code is out in the open, so you're free to run it and change it to fit what you need.

Portainer app templates

Zooming out, this whole page comes from a Portainer app template: a short recipe telling Portainer how to set CashPilot up. Add the template list to Portainer once, then deploying CashPilot is a click rather than a wall of config.