# Kepr

Kepr is a self-hosted website for your [Koh](https://koh.asha.software) projects.
It reads your Koh remote and lets people browse the code and history you choose
to publish. You run it on your own domain, with your own storage, and keep
working in Koh from the terminal.

Visitors can read highlighted source, see file descriptions, and inspect diffs
at any save. They can download source archives or published releases, with
checksums and update feeds available for releases. Bug reports and questions
don't require a visitor account.

Each instance has one operator. Repositories start private; you choose which
ones appear on the site. Kepr is built with TypeScript, Bun, Hono, and SQLite.

[See Kepr in use](https://kepr.uk) · [Self-hosting guide](docs/site/docs.md)

## Set up an instance

You'll need Bun and a Koh 3 remote. You can use an S3-compatible bucket or try
Kepr locally with a folder remote. A public instance needs a domain and an HTTPS
reverse proxy.

```sh
bun install --production
bun run start
```

On the first run, open `/setup` on your instance (`http://localhost:3000/setup`
locally). The terminal prints a setup code. Enter it in the browser and set your
password, domain, and storage connection. Kepr saves the configuration and
starts syncing from your remote.

Sign in to select the projects you want to make public.