Deploy Koffan

Free selfhosted groceries list for families and shared households.

Deploy Koffan

/data

Deploy and Host Koffan on Railway

Koffan is a lightweight, self-hosted shopping-list application for families and shared households. This template deploys Koffan 2.17.0 as one service with persistent SQLite storage and a public Railway HTTPS domain.

About Hosting Koffan

The template uses shared-password authentication. Railway generates APP_PASSWORD; read it from your service variables and use it to sign in. Keep this password private. The application stores its database at /data/shopping.db on the attached volume.

Common Use Cases

  • Share grocery lists between household members.
  • Organize items into sections and track purchased items.
  • Synchronize shopping updates across signed-in devices.

Dependencies for Koffan Hosting

  • Koffan 2.17.0, retaining the upstream application version and lockfiles.
  • One Koffan service and one persistent /data volume.
  • An HTTPS-capable browser; no separate database service is required.

Deployment Dependencies

Implementation Details

The maintenance source is pinned to 62747a0498f19f1c34f62dbccd5c037d05e8fdf8. It refreshes build/runtime images while leaving the application VERSION and dependency lockfiles unchanged: Go 1.26.11 builds the application, the CSS builder is pinned by digest, and the runtime uses Alpine 3.23.8 plus distribution security updates.

The Railway public domain targets port 80, matching the template's PORT variable. Preserve APP_ENV=production, DB_PATH=/data/shopping.db, the generated password and the existing volume. The database is not exposed separately. The square card/service icon is the unchanged first-party Koffan PWA icon, pinned to the same source commit.

Back up /data before updating, retain the original password and volume, and verify your existing lists after redeployment. This maintenance update does not itself change the application version. Older application upgrades can contain one-way SQLite migrations; consult upstream release notes before changing that version.

Shared-password shopping-list behavior and persisted original records are the release's validation scope. Multi-user mode, token REST integrations, outbound webhooks and offline-install behavior require separate operator configuration or testing and are not enabled or certified by this template's maintenance validation. No permanent demo is included.

Why Deploy Koffan on Railway?

Railway supplies HTTPS, persistent storage and deployment logs for a compact, single-service shopping application. Keep the volume and secrets stable across deliberate source updates rather than recreating the service.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0