HomeKB

Q: How do I update HomeKB?

Pull from the original repository and redeploy: add https://github.com/do-md/homekb.git as an upstream remote, run git pull upstream main, then npx wrangler deploy.

do-md/homekb

Local-first Markdown knowledge base with AI search and Q&A that stays on your computer.

A self-hosted alternative to Obsidian.

Install with CLI View source

What it sets up in your account

D1
D1 database
A SQL database for the app’s records.
DO
Durable Objects
Keeps live sessions and realtime state.

Category: Notes
Licence: MIT
Stars: 13
Last commit: 4 months ago
Latest release: engine-v0.3.3

Use it with AI or code

Markdown for AIPaste into ChatGPT, Claude or any LLM./apps/homekb.md
Open
JSON APIFree, no key, CORS open./api/v1/apps/homekb.json
Open

Keeping it up to date

Run this in your copy whenever a new version comes out.

terminal

git remote add upstream https://github.com/do-md/homekb.git
git pull upstream main
npx wrangler deploy

HomeKB questions

What is HomeKB?

Local-first Markdown knowledge base with AI search and Q&A that stays on your computer. It’s an open-source, self-hosted alternative to Obsidian. It runs on Cloudflare Workers in your own account.

What does HomeKB set up in my Cloudflare account?

D1 database and Durable Objects. They are created in your account, so the data stays yours.

How do I deploy HomeKB?

It installs from the command line. Follow the steps in the do-md/homekb README.

Is HomeKB free and open source?

Yes. It’s published under the MIT licence. Running it uses your own Cloudflare account, and small setups usually fit in the free plan.

How do I update HomeKB?

Pull from the original repository and redeploy: add https://github.com/do-md/homekb.git as an upstream remote, run git pull upstream main, then npx wrangler deploy.