bin/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

Personal ~/bin repository containing Podman pod creation scripts for self-hosted services on a Linux server. Each script creates a rootless Podman pod with systemd user service integration.

Repository

• Main branch: main
• Remote: ssh://git@git.destengs.com:8085/pln/bin.git (Gitea)
• Run by user pln with rootless Podman permissions

Shell script conventions

All pod creation scripts follow the same pattern (see existing scripts and examples in /home/lwc/bin/create_pod_langflow.sh, /home/krt/bin/create_pod_qdrant.sh):

• Naming: create_pod_<service>.sh
• #!/bin/bash shebang with set -e
• Variables declared at top: POD_NAME, CTR_NAME, container images with pinned tags, ports, bind dirs
• Data persisted under $HOME/.local/share/<pod_name>/
• Pod ports bound to 127.0.0.1 (localhost only)
• Containers removed and recreated on each run (idempotent)
• Systemd user service files generated via podman generate systemd --name --new --files
• Pod stopped/removed after systemd generation, then re-started via systemctl --user enable --now
• Readiness check loop using curl with 30 attempts, 2s interval

Current services

• AFFiNE (create_pod_affine.sh): AFFiNE v0.26.3 with pgvector/PostgreSQL and Redis. Web UI on port 8092, GraphQL API at /graphql.