Koffan

Koffan

Docker app from Uderzo's Repository

Overview

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

Features:

  • Real-time sync (WebSockets)
  • Offline-first / PWA support
  • Minimal resource usage
  • Simple password-based auth

Change APP_PASSWORD on first install.

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart unless-stopped

Template configuration

WebUI PortPorttcp
Target
8080
Default
3000
Value
3000
AppData DirectoryPathrw
Target
/data
Default
/mnt/user/appdata/koffan
Value
/mnt/user/appdata/koffan
Application PasswordVariable

Login password for Koffan (CHANGE THIS)

Target
APP_PASSWORD
Default
change-me
Value
change-me
Application EnvironmentVariable

Set to 'production' when using HTTPS or reverse proxy

Target
APP_ENV
Default
development
Value
development
Disable AuthenticationVariable

Disable login entirely (ONLY if proxy handles auth)

Target
DISABLE_AUTH
Default
false
Value
false
Database PathVariable

SQLite database file location

Target
DB_PATH
Default
/data/shopping.db
Value
/data/shopping.db
Default LanguageVariable

UI language (en, no, de, fr, es, pl, pt, uk, lt)

Target
DEFAULT_LANG
Default
en
Value
en
API TokenVariable

Optional REST API token (leave empty to disable)

Target
API_TOKEN

Categories

Details

Repository
ghcr.io/pansalut/koffan:latest
Last Updated2026-05-31
First Seen2026-01-15

Run Koffan on Unraid.

Koffan is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.