---
title: "Deploy Koffan"
description: "Free selfhosted groceries list for families and shared households."
category: "Other"
url: https://railway.com/deploy/koffan
---

# Deploy Koffan

Free selfhosted groceries list for families and shared households.

**[Deploy Koffan on Railway](https://railway.com/template/koffan)**

- **Creator:** Tom
- **Category:** Other
- **Total deploys:** 3

## Template content

### Koffan https://raw.githubusercontent.com/PanSalut/Koffan/main/static/koffan-logo.webp

- **Source:** PanSalut/Koffan
- **Public domain:** Yes

## Documentation

# Deploy and Host Koffan on Railway

Koffan is an ultra-lightweight, self-hosted shopping list web app designed for families and shared households. It provides real-time synchronization across devices, offline support, and a simple password-based login, all while consuming minimal system resources.

## About Hosting Koffan

Hosting Koffan is intentionally simple. The application is a single Go binary backed by SQLite, packaged to run cleanly in a containerized environment. On Railway, deployment requires no external services beyond persistent storage and environment variables. The app listens on a single port, manages its own database file, and supports WebSocket-based real-time updates out of the box. Resource usage is extremely low (~2.5 MB RAM idle), making it well-suited for small instances and cost-efficient deployments.

⚠️ **Authentication note**: Koffan requires an application password. Railway will generate an `APP_PASSWORD` environment variable at deploy time, or you may set it manually. This password is required to log in to the app after startup.

## Common Use Cases

- Shared grocery lists for couples or families with real-time updates
- Lightweight household coordination tool without third-party accounts
- Self-hosted alternative to commercial shopping list apps

## Dependencies for Koffan Hosting

- A Railway service running the Koffan container
- Persistent storage mounted to `/data` for the SQLite database

### Deployment Dependencies

- Railway platform  
- Application source: [PanSalut/Koffan](https://github.com/PanSalut/Koffan)
- Optional reference: https://github.com/PanSalut/Koffan

### Implementation Details

Koffan reads configuration exclusively from environment variables. At minimum, set:

```

APP_PASSWORD=your-secure-password

```

The SQLite database is stored at `/data/shopping.db`. Ensure a persistent volume is attached so data survives redeploys.

## Why Deploy Koffan on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Koffan on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/koffan