Koffan

Koffan is a lightweight, self-hosted shopping list app designed for families and couples.

  • Productivity
Koffan is a lightweight, self-hosted shopping list app designed for families and couples. It syncs your list in real time across devices and works offline as a Progressive Web App, with a single shared password for login.

Platform availability

Available on 3 of 10 platforms

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

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.

60/100 Good

Maintained
95last commit 36 days ago
Popular
58827 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data
Security check
07 serious findings, 2 minor, CI, tests

Based on 4 of 5 factors.

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

GitHub stars
827
Open issues
55
Last commit
2026-10-16
Latest release
v2.17.0
Activity
stale

Checked 7 days ago - source: GitHub (PanSalut/Koffan)

Resources & Compatibility

Requirements not published yet.

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

First-install notes

  • Set a password and save your lists Use -e APP_PASSWORD=yourpassword to choose a login password and add a data volume like -v koffan-data:/data. Without the password, anyone can use it, and without the volume your lists disappear when the container is recreated. source
  • Open port 3000 in your browser Use a port mapping like -p 3000:8080 so the app is reachable at http://your-server:3000. If that port is not open or blocked by a firewall, you will not be able to log in or see the shopping list. source
  • Optional: add webhook notifications If you want Koffan to tell other apps when items change, set WEBHOOK_URL, WEBHOOK_SECRET, and WEBHOOK_EVENTS before starting it. Without these settings, webhooks are not sent, but Koffan itself still works. source

Fetched 47 days ago - each note links to its source

Alternatives (4)

  • AnyList - Easily create grocery lists, share with others instantly, and sync across devices.
  • Bring! - Bring! allows you to create a shopping list in seconds.
  • Grocy - Grocy is a web-based, self-hosted household management solution for tracking groceries, recipes, chores, and consumables to reduce food was…
  • Out of Milk - Have you ever returned from grocery shopping and realized you forgot that one item you really needed?

Checked 54 days ago - source: AlternativeTo

Common questions

Which deployment path is highlighted as the easiest for Koffan?

The repository says the easiest way to deploy Koffan is with Coolify.

Do Koffan users see list changes immediately on other devices?

Yes. Koffan allows real-time synchronization between multiple devices.

Can a household use Koffan as a shared shopping list?

Yes. The article says it is a self-hosted grocery list you can share with your family and that it behaves like a shared notepad.

Does Koffan require a long setup process?

The article describes it as a home lab project that does not ask for a weekend of tinkering.

Answers sourced from github.com, github.com, www.xda-developers.com

Community

Collected 49 days ago - public community threads