# EverShelf

> EverShelf is a self-hosted, open-source smart pantry manager with barcode scanning, AI expiry tracking, smart shopping lists, and Home Assistant integration.

- **Category:** Food & Agriculture
- **Licence:** MIT
- **Latest version:** v1.16.16
- **Open source:** oss
- **Languages:** JavaScript, PHP
- **Platforms:** Docker Compose, Unraid, Build from Source
- **Tags:** SQLite, Iot, Inventory Management, Pwa, Home Automation, Shopping List, Home Assistant, Docker, Open Source, AI, Php, Sustainability, Self Hosted, Inventory, Recipe management, Barcode scanner, Inventory tracking, Pantry, Food Tracking, Expiry Tracking, Android Kiosk, Food Waste, Smart Kitchen, Pantry Manager

## Description

EverShelf is a self-hosted pantry management application designed for home users who want to reduce food waste and organize their kitchen inventory. It runs as a PHP web application with a SQLite database, accessible via any browser and installable as a Progressive Web App (PWA) on mobile devices. Core capabilities include barcode scanning via camera, AI-powered product identification and expiry OCR using Gemini, OpenAI, or local Llama models, smart shopping lists with anti-waste quantity suggestions and optional Bring! sync, a cooking mode with step-by-step instructions and text-to-speech, calendar feeds (ICS/WebCal) for expiry alerts, and push notifications via ntfy, webhook, or Home Assistant. The Android Kiosk companion app turns a tablet into a dedicated kitchen display with scale integration for hands-free quantity entry. Installation is simplest via Docker Compose (pre-built multi-arch images on GHCR), with a Community Applications template for Unraid and a manual bare-metal option. The project is MIT-licensed, free forever with an optional one-time donation dialog, and has no paywalled features.

## Links

- [Homepage](https://github.com/dadaloop82/evershelf)
- [Website](https://evershelf.site)
- [Docker](ghcr.io/dadaloop82/evershelf)
- [Demo](https://evershelf.site/demo)
- [GitHub Repository](https://github.com/dadaloop82/EverShelf)
- [Documentation Wiki](https://github.com/dadaloop82/EverShelf/wiki)
- [Changelog](https://evershelf.site/pages/changelog.html)
- [Integrations Page](https://evershelf.site/pages/integrations.html)
- [Installation Guide](https://github.com/dadaloop82/EverShelf/wiki/Installation)
- [Configuration Reference](https://github.com/dadaloop82/EverShelf/wiki/Configuration)
- [Features Wiki](https://github.com/dadaloop82/EverShelf/wiki/Features)
- [FAQ](https://github.com/dadaloop82/EverShelf/wiki/FAQ)
- [YouTube Channel](https://www.youtube.com/@EverShelfProject)

---
Source: https://selfhost.directory/project/evershelf