skills.rest
Aidas-dev
Aidas-devCOMMUNITY
Explore all skills by this author →
GitHub

gitea-registry

Manages container images and packages in a Gitea OCI-compatible registry.

4|2|Updated Jun 1, 2026
Search Tags:#package management#docker#container registry#oci#gitea#multi-arch#helm charts
One-click install
npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill gitea-registry-aidas-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gitea-registry
Source: https://github.com/Aidas-dev/k8s-agent-skills/tree/main/skills/gitea-registry
Command: npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill gitea-registry-aidas-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with a self-hosted Gitea container registry involves specific authentication rules, naming conventions, and API endpoints that differ from Docker Hub, and mistakes like using account passwords with 2FA or malformed delete requests waste debugging time. ## Core Features & Use Cases - Push and Pull OCI Artifacts: Push and pull Docker images, Helm charts, and any OCI artifact using the Docker Registry v2 API with correct {registry}/{owner}/{image}:{tag} naming. - Multi-Architecture Builds: Build and publish multi-arch images for linux/amd64 and linux/arm64 using docker buildx. - Package Management via API: List and delete packages through the Gitea REST API across 20+ supported package types including npm, maven, helm, and terraform. - Use Case: You need to publish a multi-arch image of your backend service to your organization's Gitea instance and later clean up old versions via the API. ## Quick Start Ask the agent to push a multi-arch build of your local Docker image to your Gitea registry and list the published package versions.

Frequently Asked Questions about gitea-registry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push a Docker image to a Gitea registry?▼

Tag the image as {registry}/{owner}/{image}:{tag}, run docker login with your Gitea username and a personal access token, then docker push. For example: docker push git.example.com/testuser/myapp:latest.

How do I build multi-arch images for a Gitea registry?▼

Use docker buildx with the --platform flag listing the target architectures and --push to publish directly. Example: docker buildx build --platform linux/amd64,linux/arm64 -t git.example.com/testuser/myapp:latest --push .

Why does Gitea registry login fail with my account password?▼

Gitea requires a personal access token instead of the account password, especially for users with two-factor authentication enabled. Generate a token in your Gitea settings and use it as the docker login password.

Can I push Helm charts to a Gitea registry?▼

Yes, Gitea supports Helm charts as OCI artifacts. Push them with the OCI protocol: helm push mychart-1.0.0.tgz oci://git.example.com/myorg.

How do I delete a package version from Gitea via API?▼

Send a DELETE request to /api/v1/packages/{owner}/{type}/{name}/{version} with a token Authorization header. All four path segments—owner, type, name, and version—are required or the request fails.

Are Gitea registry image tags case-sensitive?▼

No, tags are case-insensitive in the Gitea registry. Pushing image:Tag and image:tag refers to the same image, which can cause accidental overwrites if casing differs between pipelines.

Related Skills

Explore More Software Engineering Skills→
radius-projectradius-project
1.7k

radius-build-images

Build and push Radius container images from source to a registry.

Official
Intermediate
datasurfacedatasurface

Setup Kubernetes Registry Secret

Configure a Kubernetes docker-registry secret for GitLab image pulls.

Official
Advanced
AI-Strategy-LLCAI-Strategy-LLC

Container App Deploy

Build and push container images to registries with preflight validation and vulnerability scanning.

Official
Intermediate
dengineproblemdengineproblem

container-registry-setup

Configure and integrate container registries including AWS ECR, GCP Artifact Registry, Azure ACR, Docker Hub and Harbor with security and CI/CD support.

Community
Advanced