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: 45.9k
Architecture: amd64, arm64
Image size: 35 MB
Latest: 1.41
User: drumsergio
Created: Mar 25, 2026
Updated: 10 hours ago
Status: active

Source details

Repo: GeiserX/CashPilot
Stars: 58
Forks: 16
Language: Python
License: GPL-3.0
Latest: v1.41.1 · 10 hours ago
Updated: 10 hours ago
Website: geiserx.github.io/CashPilot

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 GitHub Stars


CashPilot is a self-hosted platform that runs passive income services on your own servers and shows what they earn in one web dashboard. Two Docker containers start the 17 services that run in Docker, keep track of the 24 that run as a browser extension, a desktop app or a GPU node, and read the balances of 15 providers into one earnings history. Without it, each provider is a container you write by hand and a dashboard you log into separately.
The CashPilot dashboard: balance tiles, a 30-day earnings chart, a payout waiting to be confirmed, and the deployed services table

Features

  • Starts a Docker service with one click from the catalog; no compose file to write, no YAML to edit.
  • Keeps every balance as history: 15 providers are read by built-in collectors every hour, so "running but not earning" shows as a flat line.
  • Treats a balance drop as a probable payout and asks you to confirm it; nothing is counted as income by guess.
  • Runs a fleet: one worker per server, one dashboard for all of them, every figure per server and per service.
  • Checks before you deploy whether the machine fits (residential IP, GPU, disk), and warns when a stored credential is about to expire.
  • Encrypts stored credentials at rest; only the worker touches the Docker socket, and the dashboard listens on loopback until you say otherwise.
  • Runs on x86-64 and ARM: Raspberry Pi, Apple Silicon and ARM cloud boxes.
  • Works from a phone: the dashboard, catalog and wizard are responsive, dark by default, with a light theme.
  • Exports Prometheus metrics, and a compose file per service if you would rather run it yourself.

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"

You need Docker on a Linux, macOS or Windows host, amd64 or arm64. Open http://localhost:8080: the welcome page asks for the token from that log line, creates the owner account and opens the setup wizard. The dashboard listens on loopback only and the worker's port 8081 is never published, because both can command the Docker socket; Getting started covers remote access, updating and pinning a version.

Supported Services

40 active services and 1 in beta, 52 catalogued. Each has a guide with what it needs, whether it runs in Docker, the payout method and the minimum payout. Services that need a residential IP are marked there; the rest run on a VPS.
Run in Docker by CashPilot (17): Anyone Protocol, Bitping, Earn.fm, EarnApp \*, Honeygain, IPRoyal Pawns, MystNodes, PacketStream, ProxyBase, ProxyBase Markets, ProxyLite, ProxyRack, Repocket, Sia (hostd), Storj, Traffmonetizer, URnetwork
Browser extension or desktop app, tracked (18): 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, tracked (6): Flux, Golem Network, io.net, Nosana, Salad, Vast.ai
\ 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.
These lists 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 list.

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

How much can I earn? It depends on your country, your ISP, and how many devices and services you run. One home server running 10 to 15 services makes about $30 to $100 a month; more servers, or GPU compute, add to that. The dashboard shows what you really made.
Is bandwidth sharing safe? These services route other people's traffic (market research, ad verification, price checks) through your connection, so strangers use your IP. Read each provider's terms, and read Protecting your home network before running them on a LAN you care about. This is not legal advice.
Can I run it on a VPS? The services marked residential-only will not pay, or will ban, a datacenter IP. The others run anywhere and are the way to add machines without more home hardware.
Where are my credentials? Encrypted at rest in SQLite with a key at /data/.fernet_key. Back that file up: without it nothing can be decrypted. More 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. Release notes are on GitHub Releases.

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 35 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.41. 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.