PanSalut/Koffan

これは何？

主な機能

• 01WebSocket経由で共有リストを複数のデバイス間でリアルタイム同期
• 02オフラインでの作成・編集と、再接続時の自動同期
• 03セクション、カスタムリストアイコン、複数のリスト
• 04購入履歴に基づく自動補完
• 05任意で使える個人アカウントと個別のワークスペース
• 06REST APIと署名付きの送信Webhook

ユースケース

• カップルや家族が、それぞれのスマートフォンから1つの買い物リストを共同で作成する
• 複数の世帯が、リストを分けて1台のセルフホストサーバーを共有する
• Webhook経由で買い物アイテムをn8nやZapierなどの自動化ツールに同期する
• 電波の弱い店舗でリストをオフライン利用する

クイックスタート

1. 1

   README のクイックスタートコマンドを使って、Docker で Koffan を起動します

   docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest
2. 2

   ブラウザーで http://localhost:3000 を開き、パスワードでサインインします

使う前に知っておきたいこと

• !README に明確なオープンソースライセンスが記載されていないため、再利用する前にリポジトリのライセンス条件を確認してください。
• !オフライン対応には Koffan を HTTPS で配信する必要があります。ホームネットワーク上の通常の HTTP では利用できません。
• !2.16.0 へのアップグレードではデータベースが移行され、ダウングレードできません。事前にデータベースをバックアップしてください。

収録されている特集

トピック

よくある質問

Koffan とは？

家族や世帯で共有できるセルフホスト型の買い物リストWebアプリ。リアルタイム同期とオフラインモードに対応。 Koffanは、買い物リストを共同で管理できる軽量なWebアプリです。複数人が異なるデバイスから同じリストを編集でき、変更はWebSocket経由でリアルタイムに同期されるため、必要なものとカートに入れたものを全員が確認できます。

Koffan は無料で使えますか？ライセンスは？

Koffan は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

Koffan は今もメンテナンスされていますか？

活発にメンテナンス中。Koffan の最終コミットは 2026年10月16日 です。

Koffan は何に使えますか？

カップルや家族が、それぞれのスマートフォンから1つの買い物リストを共同で作成する 複数の世帯が、リストを分けて1台のセルフホストサーバーを共有する Webhook経由で買い物アイテムをn8nやZapierなどの自動化ツールに同期する 電波の弱い店舗でリストをオフライン利用する

Koffan のインストール方法は？

README のクイックスタートコマンドを使って、Docker で Koffan を起動します: docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest ブラウザーで http://localhost:3000 を開き、パスワードでサインインします

Koffan はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/PanSalut/Koffan