gitea-pages
A static pages server for Gitea and Forgejo

Installation
docker pull ghcr.io/deadnews/gitea-pages
See compose.dev.yml for a Compose reference.
Configuration
| Variable |
Default |
Description |
GITEA_PAGES_SERVER |
|
Gitea server URL |
GITEA_PAGES_TOKEN |
|
Gitea API read token |
GITEA_PAGES_BRANCH |
gh-pages |
Branch to serve pages from |
GITEA_PAGES_ADDR |
:8000 |
Listen address |
- The token needs the
read:repository scope.
- The pages branch of every repository the token can read is served to anyone.
- A wrong server URL or token doesn't fail startup: every page answers 404, see the log.
Deploying a site
Deploy with any CI step that pushes to the pages branch:
- name: Deploy Docs
uses: peaceiris/actions-gh-pages@v4
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
force_orphan: true
publish_dir: site
Endpoints
GET /health
Health check endpoint.
curl http://127.0.0.1:8000/health
GET /{owner}/{repo}/{path...}
Serves static files from the pages branch of the specified repository.
# Serves index.html from the pages branch of owner/repo
curl http://127.0.0.1:8000/myorg/myrepo/
# Serves a specific file
curl http://127.0.0.1:8000/myorg/myrepo/assets/style.css