diff --git a/content/codeberg-pages/index.md b/content/codeberg-pages/index.md
index 6e4c938..3383a4b 100644
--- a/content/codeberg-pages/index.md
+++ b/content/codeberg-pages/index.md
@@ -45,6 +45,14 @@ There are two ways to get started with Codeberg Pages on git-pages:
 
 This page documents the first method. See the [separate page on using Forgejo Actions](/codeberg-pages/forgejo-actions/) for information on the second method.
 
+{% admonition "warning" %}
+
+The `pages` repository **must** be public, as Codeberg Pages directly fetches the files from the repository,
+just like an ordinary visitor would.
+A private repository will not be served.
+
+{% endadmonition %}
+
 ### User/organization websites
 
 1. Create a repository called `pages` under your own username or under the organization you want to create a website for
diff --git a/content/codeberg-pages/troubleshooting.md b/content/codeberg-pages/troubleshooting.md
index b310b01..3f85116 100644
--- a/content/codeberg-pages/troubleshooting.md
+++ b/content/codeberg-pages/troubleshooting.md
@@ -14,6 +14,12 @@ contains a sub-sub-domain which does not work with Let's Encrypt wildcard certif
 Use the alternative URL <https://pages.codeberg.org/user.name/> as a workaround or rename you repository
 (e.g. replace `.` by `_`).
 
+## My website is not published
+
+Make sure the `pages` repository is **public**.
+Codeberg Pages directly fetches the files from the repository, just like an ordinary visitor would,
+so a private repository will not be served.
+
 ## My content is not updated
 
 The Codeberg Pages v2 server caches files under a certain size (currently 1 MiB).