keptinventory/kept

What is it?

Key features

• 013D location map showing floors, rooms, shelves and boxes
• 02QR code and short-ID labels that open the box when scanned
• 03AI-assisted item capture with a choice of providers, including local Ollama
• 04MCP server for connecting Claude and other AI agents
• 05Nightly encrypted backups to a directory, S3 or SFTP
• 06Warranty, maintenance and stocktake reminders

Use cases

• Keeping track of tools and supplies across a garage or storage unit
• Recording warranties, receipts and manuals alongside the items they cover
• Planning and tracking a house move with numbered, scannable boxes
• Managing a homelab's or household's shared inventory with other users

Quick start

1. 1

   Download the compose.yaml file

   mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml
2. 2

   Run init to set the address and write .env

   docker compose run --rm init
3. 3

   Start the stack

   docker compose up -d
4. 4

   Open the address, enter the setup code and create the admin account

Things to know

• !Licensed under AGPL-3.0, so modified versions run for others must offer their source.
• !Camera, app install, push and location features need HTTPS, which requires extra Caddy setup.
• !Self-hosting requires Docker Compose and at least 2 GB of RAM and 2 CPU cores.

In collections

Topics

FAQ

What is kept?

A self-hosted inventory app for tracking what you own, where it is, and its paperwork, with a 3D location map and a built-in MCP server. Kept is a self-hosted, open-source inventory for homes, garages and storage units. It records locations, rooms, shelves, boxes and the things inside them, along with receipts, manuals, warranties and history. Data stays on your own server, with no telemetry and the update check off by default.

Is kept free to use? What license does it have?

kept is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is kept still maintained?

Actively maintained. The last commit to kept was on Nov 6, 2026.

What can I use kept for?

Keeping track of tools and supplies across a garage or storage unit Recording warranties, receipts and manuals alongside the items they cover Planning and tracking a house move with numbered, scannable boxes Managing a homelab's or household's shared inventory with other users

How do I install kept?

Download the compose.yaml file: mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml Run init to set the address and write .env: docker compose run --rm init Start the stack: docker compose up -d Open the address, enter the setup code and create the admin account

Where can I get kept?

The source code and installation instructions are on GitHub: https://github.com/keptinventory/kept