Skip to content

Repository files navigation

gitea-pages

A static pages server for Gitea

GitHub: Release Docker: ghcr CI: Main CI: Coverage

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

About

A static pages server for Gitea

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages