---
title: "Gitea Runner 4.0.0 Released: S3 Cache & Built-in Actions"
url: https://aideveloper44.com/blog/gitea-release-runner-v4
description: "Gitea releases version 4.0.0 of its runner, adding S3-compatible caching, native checkout actions, and OpenTelemetry tracing for improved CI/CD pipelines."
lang: en
---

Announcements (https://aideveloper44.com/blog/tag/announcements)

# Gitea Releases Runner v4: Shared S3 Cache and Faster CI/CD with Built-in Actions

Gitea has released version 4.0.0 of its runner, introducing S3-compatible caching, built-in actions, and improved observability via OpenTelemetry.

A

AIDeveloper44 Team

September 27, 2026 · 4 min read

Image: Gitea Releases Runner v4: Shared S3 Cache and Faster CI/CD with Built-in Actions (https://base44.app/api/apps/696b2bd107af20deac4cc200/files/mp/public/696b2bd107af20deac4cc200/eee30dd6a_runner-400-cover.svg)

Gitea Runner 4.0.0 introduces streamlined caching and built-in action support.

TL;DR

- The 4.0.0 release introduces native builtin:checkout actions, removing the need for external downloads or Node.js in job images.
- Runners can now use S3-compatible storage for shared caching, eliminating the requirement for a separate dedicated cache server.
- New features include OpenTelemetry tracing for job monitoring and self-referencing action resolution within the same Gitea instance.
- The update includes breaking changes regarding cache request routing and glob pattern matching in volume configurations.

## Overview of Gitea Runner 4.0.0

Gitea has announced the release of Gitea Runner 4.0.0, a significant update to its CI/CD runner technology. This version focuses on improving efficiency and simplifying infrastructure requirements for development teams. While the release features a major version bump, the project maintainers clarify that this reflects specific breaking changes in the runner's architecture rather than requiring a new server dependency. The software remains wire-compatible with existing Gitea versions currently in use.

### Key Features and Improvements

A primary addition in this release is the support for built-in actions, specifically `builtin:checkout`. This functionality allows the runner to execute native Go actions directly. By using `uses: builtin:checkout`, developers can perform repository cloning without needing to download external action code or ensure Node.js is present in the job's container image, thereby speeding up pipeline setup times and reducing potential points of failure.

For teams managing large build environments, the introduction of a shared S3-compatible cache is a notable improvement. Previously, runners often required a separate cache server. Version 4.0.0 enables runners to interface directly with S3-compatible storage solutions—such as AWS S3, MinIO, or RustFS—to store and retrieve action caches. Runners sharing the same settings can access a common cache pool, with cached data becoming available to other runners in the cluster within approximately 30 seconds. This capability allows for more scalable and resilient ephemeral runner configurations.

Observability has also been enhanced through the integration of OpenTelemetry tracing. Operators can now configure runners to send job traces to an OTLP collector. Each step in a job generates a specific span, which can be configured using standard `OTEL_*` environment variables. This provides deeper insight into CI/CD pipeline performance and behavior.

### Workflow and Configuration Changes

The update introduces a more flexible way to reference actions with the `self:` prefix. Developers can now use `uses: self:{owner}/{repo}[/{path}]@{ref}` to resolve actions within the same Gitea instance, removing the need to hard-code hostnames. Furthermore, the runner now supports `--umask` in container options, providing better control over file permissions for processes running within containers.

### Important Breaking Changes

Users planning to upgrade should be aware of two specific breaking changes:

- **Cache Request Routing:** Job-level cache requests are now routed through the runner itself. Previously, jobs communicated directly with the cache server. This change means that external cache servers no longer need direct connectivity to the Gitea instance, but they must be accessible by the runner. If jobs cannot reach the runner, configuration adjustments involving `cache.host` and `cache.port` may be required.
- **Volume Matching:** The `valid_volumes` configuration now uses doublestar matching rather than the previous glob implementation. Patterns using `*` will no longer cross directory boundaries. Configurations that previously relied on `*` to match nested paths must be updated to use `**` to maintain existing functionality.

The Gitea team recommends testing artifact uploads, cache restoration, and network configurations in a staging environment before performing a broad rollout to production infrastructure. The release is currently available for various platforms via the official Gitea Runner release pages.

References & Sources

1. Gitea Runner 4.0.0 Announcement on X: https://x.com/giteaio/status/2103224936106213697
2. Official Gitea Blog Release Notes: https://blog.gitea.com/release-of-runner-4.0.0/
3. Gitea Runner v4.0.0 Release Page: https://gitea.com/gitea/runner/releases/tag/v4.0.0

Read more: https://x.com/giteaio/status/2103224936106213697

Gitea: https://aideveloper44.com/blog/tag/gitea
CI/CD: https://aideveloper44.com/blog/tag/ci/cd
DevOps: https://aideveloper44.com/blog/tag/devops
Open Source: https://aideveloper44.com/blog/tag/open-source
Automation: https://aideveloper44.com/blog/tag/automation

### Enjoyed this?

Get more posts like this delivered to your inbox.

← Previous

Microsoft Introduces run-assert-eval for AI Agent Risk Management
https://aideveloper44.com/blog/microsoft-introduces-run-assert-eval

Next →

Anthropic Introduces New Plugin Submission Portal for Claude
https://aideveloper44.com/blog/anthropic-introduces-new-plugin-submission-portal

## Related Articles

Announcements

### Vercel Adds Spend Management Capabilities to CLI

3 min read
https://aideveloper44.com/blog/vercel-adds-spend-management-cli

Announcements

### AWS Launches Continuum: An Autonomous AI Security Agent Designed to Find, Prove, and Patch Code Vulnerabilities at Machine Speed

4 min read
https://aideveloper44.com/blog/aws-launches-continuum-for-automated-code-vulnerability-remediation

Announcements

### Microsoft Introduces Microsoft.UI.Reactor: An Experimental Framework for Building WinUI 3 Desktop Apps

4 min read
https://aideveloper44.com/blog/microsoft-ui-reactor-mvu-winui

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "@type": [
      "WebSite",
      "NewsArticle"
    ],
    "name": "AIDeveloper44",
    "url": "https://aideveloper44.com",
    "isAccessibleForFree": true,
    "isPartOf": {
      "productID": "CAowsfXgCw:openaccess",
      "@type": [
        "Product"
      ]
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "AIDeveloper44",
    "url": "https://aideveloper44.com",
    "logo": "https://qtrypzzcjebvfcihiynt.supabase.co/storage/v1/object/public/base44-prod/public/696b2bd107af20deac4cc200/9f77c0b91_a-digital-illustration-of-a-white-llama-_j4dyH5xoRnKf_3rtw-mvEQ_OdqL2BrSTtKHjJAuhTp_zg.png"
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://aideveloper44.com/"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Blog / Blog Index",
        "item": "https://aideveloper44.com/blog"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Blog Article",
        "item": "https://aideveloper44.com/blog/gitea-release-runner-v4"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "AINews.sh",
    "alternateName": "AI News",
    "url": "https://ai-dev-pulse-ac4cc200.base44.app",
    "logo": "https://ai-dev-pulse-ac4cc200.base44.app/logo.png",
    "description": "Developer-focused AI product releases, reviews, and news. Your source for the latest AI tools, open-source models, and platform updates.",
    "foundingDate": "2026",
    "slogan": "Stay ahead with AI product intelligence",
    "sameAs": [],
    "knowsAbout": [
      "Artificial Intelligence",
      "Machine Learning",
      "Large Language Models",
      "AI Tools",
      "Open Source AI",
      "AI Frameworks",
      "Developer Tools"
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "NewsArticle",
    "headline": "Gitea Releases Runner v4: Shared S3 Cache and Faster CI/CD with Built-in Actions",
    "description": "Gitea has released version 4.0.0 of its runner, introducing S3-compatible caching, built-in actions, and improved observability via OpenTelemetry.",
    "image": "https://base44.app/api/apps/696b2bd107af20deac4cc200/files/mp/public/696b2bd107af20deac4cc200/eee30dd6a_runner-400-cover.svg",
    "datePublished": "2026-09-27T17:48:24.882Z",
    "dateModified": "2026-09-27T17:49:00.952000",
    "author": {
      "@type": "Person",
      "name": "AIDeveloper44 Team"
    },
    "publisher": {
      "@type": "Organization",
      "name": "AIDeveloper44"
    },
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://aideveloper44.com/blog/gitea-release-runner-v4"
    },
    "isAccessibleForFree": true
  }
]
```