> ## Documentation Index
> Fetch the complete documentation index at: https://kremis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Build Kremis from source or run with Docker.

## From Source

Requires **Rust 1.89+** (stable, edition 2024).

```bash theme={null}
git clone https://github.com/TyKolt/kremis.git
cd kremis
cargo build --release
```

The binaries are built to `target/release/`:

* `kremis` — CLI and HTTP server
* `kremis-mcp` — MCP server for AI assistants

### Verify

```bash theme={null}
cargo test --workspace
cargo clippy --all-targets --all-features -- -D warnings
```

## Docker

```bash theme={null}
docker build -t kremis .

# MCP server (default) — pipe MCP stdio JSON-RPC; suitable for any MCP client
docker run -i --rm kremis

# HTTP API only — override the entrypoint
docker run -d -p 8080:8080 -v kremis-data:/data \
  --entrypoint kremis kremis server -H 0.0.0.0 -D /data/kremis.db
```

## Environment Variables

| Variable              | Description                                    | Default                        |
| --------------------- | ---------------------------------------------- | ------------------------------ |
| `KREMIS_API_KEY`      | Enables Bearer token authentication            | (disabled)                     |
| `KREMIS_RATE_LIMIT`   | Requests per second rate limit                 | `100`                          |
| `KREMIS_CORS_ORIGINS` | Comma-separated allowed origins, or `*`        | localhost only                 |
| `KREMIS_LOG_FORMAT`   | Log output format: `text` or `json`            | `text`                         |
| `RUST_LOG`            | Log level filter (e.g. `kremis=debug`, `info`) | `kremis=info,tower_http=debug` |
| `KREMIS_URL`          | Kremis server URL (used by the MCP bridge)     | `http://localhost:8080`        |