keptinventory / kept

A self-hosted, open-source inventory of everything you own and where it is, 
 with its paperwork and its history.
 Try Kept ·
 Try the map ·
 Host it ·
 Docs 
Homes, garages and storage units; the rooms, shelves and boxes inside them; the things inside
those, with receipts, manuals, warranties and history. Self-hosted, on your own server or homelab.
Nothing leaves it unless you turn it on: no telemetry, the update check off by default, the AI
provider yours to choose.
## Try it in your browser
Nothing to install, nothing saved.
- **Try Kept:** the whole app, with a sample household.
- **Try the map:** the 3D map, with a sample home.
## A look around
### The location map
Each location as a 3D map: floors, rooms, shelves and boxes, what's inside one tap away. Arranged
by you, or laid out by Kept. Plan view, balconies and terraces, phones included
(the map).
### On a phone
Installs as an app. Capture, scan and search, offline too.
### A thing
A short ID, where it is down to the box, its details, paperwork, value, loans and history.
### Labels
A short ID and a QR code for every box. Label-printer rolls or office-printer sheets; scan one to
open the box.
## What it does
- **Inventory.** Locations, places, boxes and things, with photos, documents, tags, custom fields,
 quantities, saved views, search and a trash you can restore from.
- **Capture.** Photograph a thing, a receipt or a label, online or offline; your AI provider
 (OpenAI, Anthropic, Google, OpenRouter, Groq, or an OpenAI-compatible server such as Ollama)
 suggests the details and you confirm them. Without one, you type them.
- **Labels.** Print label sheets with a short ID and a QR code; scan one to open the box it is on.
- **The household.** Shared locations with roles, lending, schedules, warranties, paperwork and an
 insurance report; reminders in the app, by mail, by push and in a calendar feed.
- **Moving house.** Numbered boxes, a label and a contents sheet for each, tracked in the van,
 unpacked by scanning (moving).
- **Vehicles and machines.** Readings, services, fuel and running costs.
- **AI assistant and MCP server.** Ask in plain words; changes wait for your OK. Claude and other
 AI agents connect at `/mcp` (how).
- **Backups you can read.** Nightly restic backups to a directory, S3 or SFTP, each with a copy
 that opens in a browser without Kept; imports from Homebox and CSV, full exports.
- **Five languages:** English, Arabic (right to left), French, German and Italian.
## Quick start: host it
Docker with Compose v2, on a machine with at least 2 GB of RAM and 2 CPU cores
(what it needs).
 [code] 
1. **`.env`:** five generated database passwords, the released image, and `KEPT_PUBLIC_URL`:
 exactly the address the browser shows (links and QR codes are built from it).
2. **Start:** the database, then the one-shot `migrate`, then Kept on port 8080
 (`KEPT_HTTP_PORT` changes it).
3. **First run:** open `KEPT_PUBLIC_URL`, enter the setup code from the log, create the first
 account