Skip to content
Back to search

kept

Self-hosted, open-source inventory of everything you own and where it is. AI assistant and MCP server built in.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/keptinventory/kept with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/keptinventory/kept'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/keptinventory--kept/badge.svg)](/listings/keptinventory--kept)

HTML

<a href="/listings/keptinventory--kept"><img src="/api/listings/keptinventory--kept/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Docker with Compose v2, on a machine with at least 2 GB of RAM and 2 CPU cores ([what it needs](https://keptinventory.info/install/hardware/)).

git clone --branch v1.12.5 --depth 1 https://github.com/keptinventory/kept.git && cd kept
cp compose.env.example .env
for v in SUPERUSER OWNER APP AUTH SYSTEM; do
  sed -i.bak "s/^KEPT_DB_${v}_PASSWORD=\$/KEPT_DB_${v}_PASSWORD=$(openssl rand -hex 32)/" .env
done
sed -i.bak 's|^KEPT_IMAGE=$|KEPT_IMAGE=ghcr.io/keptinventory/kept:1.12.5|' .env && rm .env.bak
# Set KEPT_PUBLIC_URL in .env to the address you will open, e.g. http://<this host>:8080
docker compose pull
docker compose up -d
docker compose logs kept | grep "KEPT SETUP 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. It becomes the instance admin. 4. **Keep the keys:** `docker compose exec kept kept admin recovery-kit` prints them. Store them off this server: a backup restores secret values only with the key.

The camera, installing the app, push and location need HTTPS: `docker compose --profile https up -d` adds Caddy with a certificate for `KEPT_DOMAIN` ([HTTPS](https://keptinventory.info/install/https/)). Every step in full: [the install guide](https://keptinventory.info/install/compose/).

- **Kubernetes:** the Helm chart, `oci://ghcr.io/keptinventory/charts/kept`, signed and published with each release ([install on Kubernetes](https://keptinventory.info/install/kubernetes/)). - **Verify the image:** `cosign verify --key cosign.pub <image>:<version>`, with `cosign.pub` from this repository ([verifying a release](https://keptinventory.info/admin/verify-release/)). - **Backups:** nightly, encrypted, to a directory, S3 or SFTP ([backups](https://keptinventory.info/admin/backups/)).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 250 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/assets/kept-lockup-dark.svg">
  4. <img src="docs/assets/kept-lockup-light.svg" alt="Kept" width="240">
  5. </picture>
  6. </p>
  7. <p align="center">
  8. A self-hosted, open-source inventory of everything you own and where it is.
  9. </p>
  10. <!--
  11. One style for every badge: flat-square, the kit's ink-2 (#55524C) label and amber (#F0B03A)
  12. value (apps/web/src/styles/tokens.css); a badge for another product takes that product's colour
  13. and logo (Docker's blue, Discord's, Home Assistant's #18BCF2). Release and CI are live (shields.io reads GitHub): CI
  14. turns red when the ci workflow fails on main. Both read public data, so they render once the
  15. repository is public. Discord counts the members of the invite's server, live.
  16. -->
  17. <p align="center">
  18. <a href="https://github.com/keptinventory/kept/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/keptinventory/kept?sort=semver&display_name=tag&style=flat-square&label=release&labelColor=55524C&color=F0B03A"></a>
  19. <a href="https://github.com/keptinventory/kept/actions/workflows/ci.yml"><img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/keptinventory/kept/ci.yml?branch=main&style=flat-square&label=ci&labelColor=55524C"></a>
  20. <a href="LICENSE"><img alt="Licence: AGPL-3.0" src="https://img.shields.io/badge/licence-AGPL--3.0-F0B03A?style=flat-square&labelColor=55524C"></a>
  21. <a href="https://keptinventory.info/"><img alt="Documentation" src="https://img.shields.io/badge/docs-keptinventory.info-F0B03A?style=flat-square&labelColor=55524C&label=docs"></a>
  22. <a href="https://github.com/orgs/keptinventory/packages/container/package/kept"><img alt="Container image: ghcr.io/keptinventory/kept" src="https://img.shields.io/badge/image-ghcr.io%2Fkeptinventory%2Fkept-F0B03A?style=flat-square&labelColor=55524C"></a>
  23. <a href="https://hub.docker.com/r/keptinventory/kept"><img alt="Docker Hub: keptinventory/kept" src="https://img.shields.io/badge/docker%20hub-keptinventory%2Fkept-2496ED?style=flat-square&labelColor=55524C&logo=docker&logoColor=white"></a>
  24. <a href="https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fkeptinventory%2Fkept"><img alt="Add Kept to Home Assistant" src="https://img.shields.io/badge/home%20assistant-add%20Kept-18BCF2?style=flat-square&labelColor=55524C&logo=homeassistant&logoColor=white"></a>
  25. <a href="https://discord.gg/g4WCXPfuNv"><img alt="Discord members" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Fv10%2Finvites%2Fg4WCXPfuNv%3Fwith_counts%3Dtrue&query=%24.approximate_member_count&label=discord&suffix=%20members&style=flat-square&logo=discord&logoColor=white&color=5865F2&labelColor=55524C"></a>
  26. <a href="CONTRIBUTING.md#sign-the-cla-once"><img alt="CLA: sign once" src="https://img.shields.io/badge/CLA-sign%20once-F0B03A?style=flat-square&labelColor=55524C"></a>
  27. </p>
  28. <p align="center">
  29. <picture>
  30. <source media="(prefers-color-scheme: dark)" srcset="docs/assets/kept-hero-dark.webp">
  31. <img src="docs/assets/kept-hero-light.webp" alt="Kept's home screen on a desktop, with the same screen on a phone in front: the get-started checklist, what needs you, the locations and the shortcuts">
  32. </picture>
  33. </p>
  34. Homes, garages and storage units; the rooms, shelves and boxes inside them; the things inside
  35. those, with receipts, manuals, warranties and history. Self-hosted, on your own server or homelab.
  36. Nothing leaves it unless you turn it on: no telemetry, the update check off by default, the AI
  37. provider yours to choose.
  38. ## Try it
  39. Nothing to install, nothing saved.
  40. - **[Try Kept](https://keptinventory.info/try/kept/):** the whole app, with a sample household.
  41. - **[Try the map](https://keptinventory.info/try/map/):** the 3D map, with a sample home.
  42. - **[Host it](#quick-start-host-it):** Docker Compose or Kubernetes.
  43. ## A look around
  44. <p align="center">
  45. <img src="docs/assets/kept-tour.webp" alt="A tour of Kept on a desktop: Home; Home's things as a list, each with its type, boxes with their counts and the label tape on printed labels; the 3D map with the kitchen's card; the graph in 2D, going into the office and back; the graph in 3D, turning, with the kitchen picked; AA batteries' card and page; a search for cable that opens the HDMI cable" width="720">
  46. </p>
  47. - **List:** names first, each with its type; a box says how much is inside; the amber tape only
  48. on things with a printed label.
  49. - **Map:** each location in 3D: floors, rooms, shelves and boxes, what's inside one tap away.
  50. Arranged by you, or laid out by Kept. Plan view, balconies and terraces
  51. ([the map](https://keptinventory.info/users/location-map/)).
  52. - **Graph:** a location's places, boxes and things, in 2D or 3D.
  53. ### On a phone
  54. Installs as an app. Capture, scan and search, offline too.
  55. <p align="center">
  56. <img src="docs/assets/kept-demo-phone.webp" alt="Kept on a phone, in a short loop: Home, a location's list, the map with a room and a box's card, a search for cable, and the capture screen" width="240">
  57. <img src="docs/assets/kept-map-phone-light.webp" alt="The location map on a phone, with a thing's card at the bottom" width="240">
  58. <picture>
  59. <source media="(prefers-color-scheme: dark)" srcset="apps/docs/src/assets/screens/list-phone-dark.webp">
  60. <img src="apps/docs/src/assets/screens/list-phone-light.webp" alt="Home's things on a phone: each name with its type underneath, boxes with their counts, the label tape on printed labels" width="240">
  61. </picture>
  62. </p>
  63. ### Labels
  64. A short ID and a QR code for every box. Label-printer rolls or office-printer sheets; scan one to
  65. open the box.
  66. <p align="center">
  67. <picture>
  68. <source media="(prefers-color-scheme: dark)" srcset="apps/docs/src/assets/screens/labels-dark.webp">
  69. <img src="apps/docs/src/assets/screens/labels-light.webp" alt="Printing labels: the six things in Home with no printed label, on an A4 sheet of 24, each label a QR code with its name, place and short ID" width="720">
  70. </picture>
  71. </p>
  72. ## What it does
  73. Every feature, with its page: [all features](https://keptinventory.info/users/features/).
  74. - **Inventory.** Locations, places, boxes and things, with photos, documents, purchases, tags,
  75. custom fields, quantities, saved views, search, an archive for what you no longer use and a trash
  76. you can restore from. Furniture with compartments you can turn, merge and split;
  77. [server racks](https://keptinventory.info/users/locations/#racks) in rack units. A place tree
  78. you can widen or collapse. Hide your Personal location if you don't use it.
  79. - **3D map and graph.** Each location in 3D, rooms at their real size, started from a floor plan
  80. if you have one; its places and things as a graph
  81. ([the map](https://keptinventory.info/users/location-map/)).
  82. - **Labels and scanning.** Print label sheets with a short ID and a QR code; scan one to open the
  83. box it is on. Scan sessions count a shelf, pack a box or move a pile in one go; counts can be
  84. turned off where nobody counts. If the scanner doesn't start, Try again starts it afresh; on a
  85. phone, sheets stay above the keyboard.
  86. - **Lending and borrowing.** Who has what and when it's due back; borrowers need no account.
  87. Reminders before and after the due date, one list of everything out, and each thing's trail of
  88. who had it and how it came back ([lending](https://keptinventory.info/users/lending/)).
  89. - **Kits and hand-overs.** Lend a box with everything in it; each thing comes back on its own
  90. record ([kits](https://keptinventory.info/users/kits/)).
  91. - **Moving house.** Numbered boxes, a label and a contents sheet for each, tracked in the van,
  92. unpacked by scanning ([moving](https://keptinventory.info/users/moving/)).
  93. - **Reminders.** Warranties, services, documents, loans and low stock: in the app, by mail, push,
  94. ntfy, Telegram and a calendar feed.
  95. - **Vehicles and machines.** Readings, services, fuel and running costs,
  96. [metric or imperial](https://keptinventory.info/users/vehicles/#units).
  97. - **The household.** Shared locations with roles and end dates, share links, stocktakes,
  98. condition reports, an insurance report and insights.
  99. [PDFs](https://keptinventory.info/users/reports/) in the reader's language.
  100. - **Capture.** Photograph a thing, a receipt, a label or a whole room, online or offline; your AI
  101. provider (OpenAI, Anthropic, Google, OpenRouter, Groq, or an OpenAI-compatible server such as
  102. Ollama) suggests the details and you confirm them. Without one, you type them. Give a location
  103. [its position](https://keptinventory.info/users/locations/#its-position) and Capture suggests it
  104. when you are there.
  105. - **AI assistant and MCP server.** Ask in plain words; changes wait for your OK. Claude and other
  106. AI agents connect at `/mcp` and stay connected ([how](https://keptinventory.info/users/mcp-clients/)).
  107. - **Home Assistant.** Install Kept as a Home Assistant app; an integration brings what's due into
  108. dashboards and automations, and the app offers to set it up: no token to copy
  109. ([Home Assistant](https://keptinventory.info/users/home-assistant/)).
  110. - **Paperless-ngx.** Link documents instead of copying them; the start of a word finds one, and a
  111. Homebox import takes its links' titles from Paperless
  112. ([Paperless](https://keptinventory.info/users/paperless/)).
  113. - **Install.** Pick how you run Kept (Docker Compose, Kubernetes, from source or Home Assistant)
  114. and follow its steps on one page ([install](https://keptinventory.info/install/)).
  115. - **Backups you can read.** Nightly restic backups to a directory, S3 or SFTP, each with a copy
  116. that opens in a browser without Kept; imports from Homebox (a past import can be repaired) and
  117. CSV, full exports.
  118. - **Your own network or HTTPS.** Works over plain http at home, with sign-ins as long as you set
  119. and more than one address; an export with secret values needs HTTPS.
  120. - **Languages:** Arabic (right to left), English, French, German, Italian, Spanish, Ukrainian and
  121. Vietnamese; type to find yours, and amounts are read as your language writes them. The user,
  122. admin and install docs are in every language too.
  123. <p align="center">
  124. <img src="docs/assets/claude-mcp.webp" alt="Claude Code connected to Kept over MCP: asked to add a TV with its serial number, it puts it in Home › Living room" width="720">
  125. </p>
  126. ## Quick start: host it
  127. Docker with Compose v2. Tested on 1 GB of RAM and one CPU core, a backup during photo uploads
  128. included; Kept and its database use about 200–400 MB
  129. ([what was tested](https://keptinventory.info/install/hardware/)).
  130. ```sh
  131. mkdir kept && cd kept
  132. curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.14.7/compose.yaml
  133. docker compose run --rm init
  134. docker compose up -d
  135. ```
  136. 1. **`compose.yaml`:** Kept and its database in one file; no clone, no passwords to make.
  137. 2. **`init`:** asks the address you'll open Kept at (a name such as `http://kept.home.arpa:8080`
  138. beats an IP address: printed labels carry it), writes `.env` and shows the setup code.
  139. 3. **Start:** the database, a one-shot bootstrap that makes the database logins and their
  140. passwords, the one-shot `migrate`, then Kept on port 8080 (`KEPT_HTTP_PORT` changes it).
  141. 4. **First run:** open the address, enter the setup code, create the first account. It becomes
  142. the instance admin. Then keep the keys off this server:
  143. `docker compose exec kept kept admin recovery-kit` prints them.
  144. The camera, installing the app, push and location need HTTPS. Caddy, with a certificate for
  145. `KEPT_DOMAIN`, and Ollama for local AI come with `compose.full.yaml`: the same file plus those
  146. ([Caddy and Ollama](https://keptinventory.info/install/compose/#caddy-and-ollama),
  147. [HTTPS](https://keptinventory.info/install/https/)). Every step in full:
  148. [the install guide](https://keptinventory.info/install/compose/).
  149. - **Home Assistant:** on Home Assistant OS, Kept installs as an app with its own database, backed
  150. up with Home Assistant's backups ([install as a Home Assistant app](https://keptinventory.info/install/home-assistant/)):
  151. <a href="https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fkeptinventory%2Fkept"><img alt="Add Kept to Home Assistant" src="https://img.shields.io/badge/add%20Kept%20to-Home%20Assistant-18BCF2?style=for-the-badge&labelColor=55524C&logo=homeassistant&logoColor=white"></a>
  152. Sensors and the calendar come from the separate integration ([Works with](#works-with)).
  153. - **Kubernetes:** the Helm chart, `oci://ghcr.io/keptinventory/charts/kept`, signed and published
  154. with each release ([install on Kubernetes](https://keptinventory.info/install/kubernetes/)).
  155. - **Verify the image:** `cosign verify --key cosign.pub <image>:<version>`, with `cosign.pub` from
  156. this repository ([verifying a release](https://keptinventory.info/admin/verify-release/)).
  157. - **Backups:** nightly, encrypted, to a directory, S3 or SFTP
  158. ([backups](https://keptinventory.info/admin/backups/)).
  159. ## Works with
  160. <p align="center">
  161. <a href="https://keptinventory.info/integrations/"><img src="apps/docs/src/assets/landing/kept-integrations.webp" alt="Kept works with what you already run: Home Assistant and Paperless-ngx both ways; imports from Homebox, LubeLogger and spreadsheets; notifications to ntfy, Telegram, Slack, Discord, Matrix, Signal, email and webhooks; the MCP server for Claude and ChatGPT; AI models from OpenAI, Anthropic, Gemini, Groq, OpenRouter and Ollama" width="800"></a>
  162. </p>
  163. - **Home Assistant:** the [kept-homeassistant](https://github.com/keptinventory/kept-homeassistant)
  164. integration, a HACS custom repository ([setup](https://keptinventory.info/users/home-assistant/)).
  165. The app runs Kept; the integration brings it into Home Assistant. With the app, Home Assistant
  166. finds Kept and you allow it in Kept: no token, no https ([set up from the app](https://keptinventory.info/users/home-assistant/#set-up-from-the-app)).
  167. <picture>
  168. <source media="(prefers-color-scheme: dark)" srcset="apps/docs/src/assets/diagrams/home-assistant-dark.svg">
  169. <img src="apps/docs/src/assets/diagrams/home-assistant-light.svg" alt="Kept, on your server or as the Home Assistant app, and the Kept integration inside Home Assistant: it reads Kept every 5 minutes, sends readings back, and feeds dashboards, automations and the calendar" width="720">
  170. </picture>
  171. - **Paperless-ngx:** receipts, manuals and warranty cards linked to things
  172. ([setup](https://keptinventory.info/users/paperless/)).
  173. - **The rest:** [integrations](https://keptinventory.info/integrations/).
  174. ## What's next
  175. - **Next:** [compartments on the 3D map](https://github.com/keptinventory/kept/issues/238)
  176. - **Later:** [mobile and desktop apps](https://github.com/keptinventory/kept/issues/169),
  177. [scan a room into the 3D map](https://github.com/keptinventory/kept/issues/197),
  178. [storage furniture templates](https://github.com/keptinventory/kept/issues/238)
  179. [Full roadmap →](https://github.com/orgs/keptinventory/projects/1): 👍 the themes you want most.
  180. ## Links
  181. | | |
  182. |---|---|
  183. | Documentation | [keptinventory.info](https://keptinventory.info/) |
  184. | Install | [Start here](https://keptinventory.info/install/): pick how you run Kept; [Docker Compose](https://keptinventory.info/install/compose/), [HTTPS](https://keptinventory.info/install/https/), [Kubernetes](https://keptinventory.info/install/kubernetes/) (Helm chart in [`charts/kept`](charts/kept/)), [configuration](https://keptinventory.info/reference/configuration/) |
  185. | API | [HTTP API reference](https://keptinventory.info/api/), generated from the OpenAPI document |
  186. | MCP | [Connect an AI client](https://keptinventory.info/users/mcp-clients/) |
  187. | Roadmap | [Now, next and later](https://github.com/orgs/keptinventory/projects/1) |
  188. | Questions and ideas | [Discussions](https://github.com/keptinventory/kept/discussions) |
  189. | Chat | [Discord](https://discord.gg/g4WCXPfuNv) |
  190. | Contributing | [CONTRIBUTING.md](CONTRIBUTING.md): a discussion or an issue first for anything larger than a fix; [sign the CLA once](CONTRIBUTING.md#sign-the-cla-once) |
  191. | Security | [SECURITY.md](SECURITY.md): report privately, never in a public issue |
  192. | Changelog | [CHANGELOG.md](CHANGELOG.md) |
  193. ## Licence
  194. Kept is free software under the GNU Affero General Public License, version 3
  195. ([`LICENSE`](LICENSE)), and every feature ships in it: nothing is held back. If you run a modified
  196. Kept for other people, you must offer them its source. The image carries the third-party notices
  197. of everything inside it, served at `/notices.txt`.
  198. ## Star history
  199. <p align="center">
  200. <a href="https://www.star-history.com/?repos=keptinventory%2Fkept&type=date&logscale=&releases=&legend=bottom-right">
  201. <picture>
  202. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=keptinventory/kept&type=date&theme=dark&legend=bottom-right">
  203. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=keptinventory/kept&type=date&legend=bottom-right">
  204. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=keptinventory/kept&type=date&legend=bottom-right" width="600">
  205. </picture>
  206. </a>
  207. </p>
  208. Created by [Ibrahim Roshdy](https://github.com/ibrahimroshdy), AGPL-3.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.