nephatrine/gitea-pages repository overview

⁠Gitea Static Page Server

This is an Alpine-based container hosting a gitea-pages server for serving static HTML documentation from a Gitea repository.

The pages endpoints are exposed at /[USERNAME]/[REPONAME]. To get this behind a TLS certificate or just serve up specific endpoints, we suggest a separate reverse proxy server, such as nephatrine/nginx-ssl⁠.

⁠Supported Tags

• gitea-pages:1.0.1: Gitea Pages 1.0.1

⁠Software

• Alpine Linux⁠
• Skarnet S6⁠
• s6-overlay⁠
• gitea-pages⁠

⁠Configuration

You will need to generate a Gitea personal access token with adequate persmissions to read whatever repos you plan to serve.

All configuration is done through a set of simple environment variables.

⁠Container Variables

• TZ: Time Zone (i.e. America/New_York)
• GITEA_PAGES_BRANCH: Pages Branch (i.e. static-pages)
• GITEA_PAGES_SERVER: Gitea Server (i.e. https://gitea.com)
• GITEA_PAGES_TOKEN: Gitea Access Token

⁠Testing

⁠docker-compose

services:
  gitea-pages:
    image: nephatrine/gitea-pages:latest
    container_name: gitea-pages
    environment:
      TZ: America/New_York
      GITEA_PAGES_BRANCH: static-pages
      GITEA_PAGES_SERVER: https://gitea.com
      GITEA_PAGES_TOKEN: [TOKEN]
    ports:
      - 8000:8000/tcp

⁠docker run

docker run --rm -e TZ="America/New_York" -e GITEA_PAGES_BRANCH=static-pages \
    -e GITEA_PAGES_SERVER=https://gitea.com -e GITEA_PAGES_TOKEN=[TOKEN] \
    -p 8000:8000 code.nephatrine.net/nephnet/gitea-pages:latest