The storehouse for your stuff. (Greek ἀποθήκη, apothḗkē: a place where things are put away for safekeeping.)
A small, fast, self-hosted web app for cataloguing your belongings: snap a photo on your phone, name the item, pick where it lives ("box 1023") and what it is ("Tools"), set a quantity, done. Then find anything again with instant search.
PHP 8.4 and CodeIgniter 4 (pinned Composer dependencies) with PDO (SQLite 3.38+ or PostgreSQL) and GD, plus Imagick in the Docker image for HEIC photos. No JavaScript build step and no CDNs: it works fully offline on your LAN.
3.0.0 is the CodeIgniter 4 app on main: no schema change, Docker-only, and one re-login at upgrade
(upgrading to 3.0). See ADR-001 and the
Feature 12 plan. For 90 days after 3.0.0, the 2.x line gets security fixes
only, as 2.6.x releases from the branch old (the former main, last release v2.6.26).
- Mobile-first UI with dark mode; every screen works one-handed on a phone.
- Items with up to 12 photos (crop, rotate, reorder), tags, notes in Markdown, attachments, purchase price and date, serial number, barcode, expiry or warranty date.
- Nested locations and categories, instant ranked full-text search (typo-tolerant, Greek included), a filter sheet and saved filters.
- Overview statistics, low-stock alerts, lending, bulk actions, duplicating, merging duplicates, undo, stocktakes and an activity history.
- QR labels, CSV import and export, and portable backup and restore across SQLite and PostgreSQL.
- Optional users with roles and permissions, guest browsing and self-registration.
- A Control Panel for branding, formats, defaults and limits, and optional AI autofill of name, category, tags and notes from a photo.
Every feature is described in the user guide.
| List & overview | Filter sheet | Item (dark) | Desktop |
|---|---|---|---|
git clone https://github.com/thordin9/apotheke.git && cd apotheke
echo 'APP_PASSWORD=change-me' > .env # pick your own (8+ characters): the password of the account admin
docker compose up -d --buildThe app then runs on http://127.0.0.1:9091. Docker installs are private by default: compose publishes the port on
127.0.0.1 only, and the container refuses to start with sign-in off unless ALLOW_NO_LOGIN=1 is set. To open it from
your phone, to encrypt stored secrets with APP_KEY, to use PostgreSQL or to run without Docker, see
Getting started.
Docker is the recommended way to self-host. To run it on your own Cloudflare account instead, see
self-hosting on Cloudflare. The project's hosted API already runs in storage mode
(D1, an Installation Durable Object and R2). A self-hosted copy can use the same storage code. On d1, a backup can
be restored (each restore keeps the catalog before it under the installation's backups/).
The manual lives in docs/:
getting started ·
self-hosting on Cloudflare · configuration ·
Control Panel · user guide · AI autofill ·
deployment and operations (backups, upgrades, reverse proxies, security) ·
upgrading to 3.0 ·
architecture · database · testing · CI ·
releasing · contributing. Changes are listed in CHANGELOG.md.
Agents: see AGENTS.md.
| Area | Module suite | Root suite (with HTTP) | Combined |
|---|---|---|---|
| Front controller, config & routes | 82.7 % | 86.7 % | 87.8 % |
| Items, search, bulk, lending | 39.9 % | 75.9 % | 83.5 % |
| Favourites, undo, history | 35.5 % | 65.4 % | 67.2 % |
| Stocktake & labels | 47.6 % | 95.6 % | 96.0 % |
| Users, roles & sign-in | 67.6 % | 64.1 % | 85.0 % |
| CSV import & export | 54.6 % | 79.9 % | 91.0 % |
| Photos & autofill | 70.9 % | 17.6 % | 72.3 % |
| Notes & layout | 87.5 % | 75.4 % | 94.8 % |
| Settings & Control Panel | 54.8 % | 48.7 % | 69.9 % |
| Backup & restore | 70.5 % | 59.9 % | 82.3 % |
| Database & migrations | 81.4 % | 57.6 % | 83.3 % |
| Core & dev server | 78.7 % | 58.9 % | 91.4 % |
| All PHP (21154 lines) | 67.9 % | 66.6 % | 84.8 % |
| Playwright project | Functional tests | Visual tests |
|---|---|---|
chromium-pixel |
148 | 22 |
chromium-pixel-dark |
2 | 22 |
desktop-chromium |
148 | 22 |
desktop-chromium-dark |
2 | 22 |
pgsql-smoke |
34 | 0 |
webkit-iphone-se |
148 | 22 |
webkit-iphone-se-dark |
2 | 22 |
webkit-iphone13 |
148 | 22 |
webkit-iphone13-dark |
2 | 22 |
| Total | 634 | 176 |
Line coverage from pcov: the module suite (tests/Modules), the root suite (tests/Unit, with every php -S request its servers answer, collected by tests/coverage/prepend.php) and both merged with phpcov, SQLite driver. Regenerate with npm run coverage:readme; the release workflow refreshes it from the CI artifact in every release commit.
Pull requests are welcome. Commits follow Conventional Commits (subject ≤ 72 characters, checked in CI); see CONTRIBUTING.md.
MIT © 2026 Stathis Papandreou
The logo, wordmark and mascot artwork is not covered by that licence; see frontend/brand/NOTICE.