Codeberg documentation content
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.8 KiB

[{key CodebergPages} {title Codeberg Pages} {icon server} {order 60}]

Codeberg Pages allows you to easily publish static websites with a human-friendly address ({user-name} via Git on Follow the simple steps below to get started, or check out the advanced usage below.

  1. Create a repository named 'pages' in your user account or organization.
  2. Create static content, HTML, style, fonts or images. Name the homepage file index.html
  3. Push your content to the main branch of the new repository.
  4. You should now be able to access your content using the domain {user-name}

See also

Advanced Usage: Canonical URLs

The Codeberg Pages server responds to four different URLs:

  • raw content, uses correct MIME types (HTML is forbidden though) and is accessible with CORS.
  • user page, points the default branch of a user's or organization's pages repository
  • repo page, points to the pages branch of the repository
  • custom domain, points to a repo of choice as outlined below

In all cases, you can append a branch using an @ (e.g.

Custom Domains

Currently known pitfalls for failed certificates:

For custom domains, two things are required:

If you can't use a CNAME record to configure the target (e.g. for a zone root), you can use an A/AAAA/ALIAS record to with an additional TXT record for the target (just as shown above for CNAME records).

Having Questions, Feedback or found a bug?

The source code for Codeberg Pages is maintained over at the Pages Server repository, feel free to head there and providing some feedback, suggestions, bug reports or even patches. We really appreciate your contribution.