Skip to content

Commit 74571b0

Browse files
committed
docs: record Qarina production source
1 parent e3f6620 commit 74571b0

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

CLAUDE.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,24 @@ uv run python checks.py # Sanity checks (not pytest)
3434
docker compose up --build # Full stack (Redis, PostgreSQL, Nginx)
3535
```
3636

37+
## Qarina production
38+
39+
Qarina's canonical application is this STK repository. Do not deploy the
40+
standalone `~/projects/qarina` Starlette prototype to `try.qarina.org`.
41+
42+
- Production: `try.qarina.org`
43+
- Server: Hetzner `try-qarina-demo` at `46.225.143.122`
44+
- Service: `try.qarina.org.service`
45+
- Runtime: `uvicorn run:app` on `127.0.0.1:5000`
46+
- Database: `/home/try/try.qarina.org/instance/stk.db`
47+
- Knowledge: `/home/try/try.qarina.org/stk/qarina/knowledge_store`
48+
- Releases: `/home/try/releases/<git-sha>`
49+
50+
Production uses versioned release directories. Each release links the existing
51+
`.env`, `instance`, and Qarina knowledge store so deploys never replace user
52+
data. Caddy and systemd must point at the same release SHA. The legacy
53+
`qarina.service` is disabled and must remain inactive.
54+
3755
### Agent Operability
3856

3957
Prefer these over guessing from files. Structured agent context lives in `.stk/context/` (architecture, commands, verification, frontend).

0 commit comments

Comments
 (0)