Key details

  1. Codeberg announced the v2 shutdown October 7, 2026.
  2. The legacy Pages v2 service stops serving content December 31, 2026.
  3. Unmigrated legacy sites can go offline; git-pages sites are not being shut down.
  4. The supported paths use Forgejo webhooks or Actions to deploy to git-pages.
  5. Some URL and redirect conventions change; custom domains remain supported.
  6. Codeberg supplies a migration checker and migration documentation.

What builders should take away

  1. Check every Codeberg Pages project and custom domain now; do not assume an old pages branch automatically migrated.
  2. Use Codeberg's migration checker or response headers to establish whether the site still runs on v2.
  3. Configure a Forgejo webhook or Action, push a change and confirm the new site is served.
  4. Test internal links, repository branch URLs, redirects, custom-domain DNS and raw resource requests after migration.
  5. Complete and verify the switch well before December 31 rather than relying on a last-day cutover.

What changed

On October 7, 2026, Codeberg announced that its old Pages v2 server will shut down completely on December 31, 2026. Existing static websites still served by the unmaintained v2 implementation will stop being delivered unless their maintainers migrate to the git-pages backend. Codeberg has operated the replacement since December 2025, but old v2 sites were not all switched automatically. Users can test whether their site has migrated and switch deployment to a Forgejo webhook or direct Forgejo Actions deployment. The new service changes behaviour around automatic repository content fetching, arbitrary repository/branch URLs, raw.codeberg.page, and some HTML redirects.

Why it matters

Codeberg is a free, community-run Git forge used by open-source developers and small projects. Static documentation, project homepages and custom-domain sites may be low traffic but critical for users and package consumers. This is an explicit loss-of-service deadline for maintainers who have not migrated; changing the deployment mechanism and verifying URL semantics ahead of December prevents avoidable outages and broken inbound links.

The cutoff affects old deployments, not every Codeberg Pages site

The December 31 shutdown applies to sites still served by the old Pages v2 backend. Codeberg says a site that never configured the new repository webhook may still be on v2. Existing git-pages sites are not subject to the legacy-server shutdown. Codeberg provides a migration-check tool, and the server response header also distinguishes the backends: pages-server for legacy and git-pages for new.

Migrate via a Forgejo webhook or Action

For a simple pages branch, create a Forgejo webhook in repository settings, point it at the site URL, filter to the pages branch and push content to trigger deployment. For generated sites, Codeberg documents a Forgejo Actions deployment path. A webhook's Test delivery button is not a valid success test: Codeberg advises pushing content and checking the resulting delivery and public page.

Check URLs and custom domains before the switch

Git-pages no longer fetches repository content automatically; publishing needs a deployment trigger. Arbitrary /repository/@branch access and the raw.codeberg.page workaround disappear. Old implicit path-to-path.html redirects no longer happen, and splat redirect rules are more constrained. Custom domains remain supported, but DNS and redirect behaviour should be checked during migration.

What to watch next

  • Codeberg migration guidance updates or changes to the announced December 31 cutoff.
  • Community reports of broken redirects, custom domains or deployment triggers on git-pages.
  • Any extension or final enforcement notice before shutdown.

Still unclear

  • Codeberg has not provided a public count of sites still using v2.
  • Actual impact varies with each site's deployment method, custom domains and old URL dependencies.
  • Migration documentation is still being updated; check the latest instructions before switching.

Sources

Direct reading behind this dossier.

3 sources
Codeberg Pages documentation
Codeberg primary documentation

Current webhook, Actions and custom-domain instructions; distinguishes old and new servers.

Migrating from Pages v2
Codeberg primary documentation

Legacy behaviour changes, redirects, repository paths and migration steps.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment