reuse-surface/docs/deploy/reuse-kubernetes.md

reuse-surface Service — Kubernetes Deployment

Companion to RAILIANCE-WP-0007 (railiance-apps Helm release).

Image

Repository: gitea.coulomb.social/coulomb/reuse-surface (Gitea org coulomb, repo reuse-surface).

docker build -t gitea.coulomb.social/coulomb/reuse-surface:<tag> .
docker push gitea.coulomb.social/coulomb/reuse-surface:<tag>

Required environment

Variable	Purpose
REUSE_SURFACE_TOKEN	Bearer token for write API
REUSE_SURFACE_DB	SQLite path (default /data/reuse.db)
REUSE_SURFACE_CACHE_DIR	Remote index cache (default /data/cache)

Mount a PVC at /data for persistence. Inject secrets via Kubernetes Secret reuse-surface-env.

Probes

• Liveness/readiness: GET /health on port 8000

Public URL and DNS

Item	Value
URL	https://reuse.coulomb.social
DNS A record	92.205.62.239 (operator confirmed 2026-06-15)

Verify propagation: dig +short reuse.coulomb.social A

Client configuration

export REUSE_SURFACE_URL=https://reuse.coulomb.social
export REUSE_SURFACE_TOKEN=<write-token>
reuse-surface hub status