Nespresso Stats

Self-hosted dashboard for your Nespresso Vertuo capsule inventory: what you have, how many of each, brew history, coffee stats and optional auto-decrement…

  • Business & Finance
  • Home Automation
  • Tools & Utilities
Self-hosted dashboard for your Nespresso Vertuo capsule inventory: what you have, how many of each, brew history, coffee stats and optional auto-decrement when the machine brews a coffee. No login is built in - it is made for a trusted home network. Expose it to the internet only behind an authenticating reverse proxy.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

50/100 Fair

Maintained
84last commit 13 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 20 days ago

GitHub stars
1
Open issues
0
Last commit
2026-11-07
Latest release
v0.96
License
GPL-3.0
Activity
declining

Checked 6 days ago - source: GitHub (avpnusr/nespresso-stats)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Running the app Start the dashboard with python3 server.py (default URL http://127.0.0.1:8787), or verify the setup with python3 server.py --selftest. Data is stored in a local SQLite file at data/nespresso.db, and the first run seeds a starter catalog. source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does Nespresso Stats have built-in login or SSO?

No login is built in; it is made for a trusted home network. If you expose it beyond the home network, put it behind an authenticating reverse proxy.

How do I change the port or bind to a LAN address?

The default is 127.0.0.1:8787. You can run it with PORT=9000 HOST=0.0.0.0 to bind to the LAN and use another port.

Where is the data stored and how can I move or back it up?

Data lives in SQLite at data/nespresso.db. Set NESPRESSO_DB to another path, or bind-mount ./data in Docker; deleting the database re-seeds the starter catalogue from capsules.json.

How do I update the Docker deployment?

The image is published as :latest on every push. Run docker compose pull to pick up a new version, but be aware that pulling can change what you run because :latest is the only tag.

How do I point the optional vision backend at Ollama on the Docker host?

Set VISION_BASE_URL, VISION_MODEL, and optionally VISION_API_KEY from the shell or a .env file. Inside the container, 127.0.0.1 is the container itself, so use the host's IP or host.docker.internal to reach Ollama on the host; set VISION_MODEL empty to disable vision.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads