# Gitea Registry

> Use when working with the Gitea container registry — OCI/Docker v2 API, push/pull images, multi-arch builds, package management via API, and configuration for supported package types.

- **Type:** Skill
- **Install:** `agentstack add skill-aidas-dev-k8s-agent-skills-gitea-registry`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Aidas-dev](https://agentstack.voostack.com/s/aidas-dev)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Aidas-dev](https://github.com/Aidas-dev)
- **Source:** https://github.com/Aidas-dev/k8s-agent-skills/tree/main/skills/gitea-registry
- **Website:** https://git.kubexa.tech/Aidas/k8s-agent-skills

## Install

```sh
agentstack add skill-aidas-dev-k8s-agent-skills-gitea-registry
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Gitea Container Registry (v1.26)

OCI-compatible registry using Docker Registry API v2. Supports Docker images, Helm charts, and all OCI artifacts.

## Auth

```bash
docker login git.example.com
# Username: gitea username
# Password: personal access token (NOT account password for 2FA users)
```

## Image Naming

```text
{registry}/{owner}/{image}:{tag}
```

Examples: `git.example.com/testuser/myapp:latest`, `git.example.com/myorg/backend:v1.2.3`

## Push / Pull

```bash
docker tag myapp:latest git.example.com/testuser/myapp:latest
docker push git.example.com/testuser/myapp:latest

docker pull git.example.com/testuser/myapp:latest
```

## Multi-Arch

```bash
docker buildx build --platform linux/amd64,linux/arm64 \
  -t git.example.com/testuser/myapp:latest --push .
```

## API

```bash
# List packages for owner
curl -H "Authorization: token " \
  https://git.example.com/api/v1/packages/testuser

# Delete package version
curl -X DELETE -H "Authorization: token " \
  https://git.example.com/api/v1/packages/testuser/container/myapp/1.0.0
```

## Supported Package Types

alpine, cargo, chef, composer, conan, conda, container, cran, debian, generic, go, helm, maven, npm, nuget, pub, pypi, rpm, rubygems, swift, vagrant, **terraform** (v1.26+).

## Config

```ini
[packages]
ENABLED = true
LIMIT_SIZE_CONTAINER = -1  # No size limit for container images
```

## Common Mistakes

- **Tag case** — Tags are case-insensitive. `image:Tag` and `image:tag` are the same image.
- **Auth for 2FA users** — Always use a personal access token as password, not account password.
- **Delete needs all segments** — REST delete endpoint requires owner, type, name, and version.
- **Helm chart push** — Use `helm push` with OCI format: `helm push mychart-1.0.0.tgz oci://git.example.com/myorg`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Aidas-dev](https://github.com/Aidas-dev)
- **Source:** [Aidas-dev/k8s-agent-skills](https://github.com/Aidas-dev/k8s-agent-skills)
- **License:** MIT
- **Homepage:** https://git.kubexa.tech/Aidas/k8s-agent-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-aidas-dev-k8s-agent-skills-gitea-registry
- Seller: https://agentstack.voostack.com/s/aidas-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.