gitea-docker/CLAUDE.md

CLAUDE.md

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

Project Overview

This is a Gitea Git server setup using Docker Compose with PostgreSQL database. The repository includes configuration files and helper scripts for managing the service.

Architecture

Services:

• gitea - Gitea web application container (gitea/gitea:latest)
• db - PostgreSQL 14 database

Network: Both services communicate via a dedicated gitea network.

Data Persistence:

• ./data - Gitea application data (repositories, config, uploads)
• ./postgres - PostgreSQL database data

Ports:

• Web UI: 31337 (mapped to container port 3000)
• SSH Git: 31338 (mapped to container port 22)

Database Configuration:

• Type: PostgreSQL
• Host: db:5432 (internal docker network)
• Database: gitea
• User/Password: gitea/gitea
• Configured via environment variables in docker-compose.yml

Common Commands

Service Management:

./start.sh          # Start services
./stop.sh           # Stop services
docker-compose logs -f          # View logs
docker-compose restart          # Restart services

Git Workflow:

./push.sh "message"     # Add, commit, and push to remote
git push                # Push directly (if already committed)

Backup:

tar -czf gitea-backup-$(date +%Y%m%d).tar.gz data/

Remote Setup

The git repository has a remote configured at:

• root@192.168.88.81:/mnt/mydata/gitea (bare repository)
• Working directory syncs to /mnt/mydata/gitea-www via post-receive hook
• HEAD points to refs/heads/main (not master)

When pushing to the remote, a post-receive hook automatically checks out files to the working directory.

Important Notes

• The .gitignore excludes data/ directory only (not postgres/)
• Scripts are executable and use bash shebang
• All data directories are local mounts for easy backup
• Container runs with UID/GID 1000 for file permissions