gitea-pages

README

gitea-pages

A static pages server for Gitea

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

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