# Nespresso Stats

Nespresso Stats is a self-hosted business & finance app. 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. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3107/nespresso-stats

## Description

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.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 84 (last commit 13 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/nespresso-stats-0d3w4qk0u65me0?q=Nespresso-Stats

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3107/nespresso-stats), the self-hosted and open-source app directory.
