Back to Blog
team@tinypod.app

Self-Hosting Gitea Pages: Static Site Hosting

Gitea supports static site hosting similar to GitHub Pages. Deploy static websites directly from your Git repositories.

giteastatic-siteshostinggit

What Are Gitea Pages?


Gitea can serve static websites directly from repositories, similar to GitHub Pages. Push HTML, CSS, and JS — Gitea serves them.


Use Cases


  • Project documentation sites
  • Personal portfolios
  • Landing pages
  • Static blogs (Hugo, Jekyll, Astro)

    • How It Works


    1. Create a repository named username.yourdomain.com (or use any repo)

    2. Push static HTML/CSS/JS

    3. Gitea serves the files at the configured URL


    Static Site Generators


    Use Gitea Actions to build from source:

    1. Push Markdown/templates to repo

    2. Gitea Actions runs Hugo/Jekyll/Astro build

    3. Output goes to the pages branch

    4. Gitea serves the built site


    Setup


    1. Enable Gitea Pages in server configuration

    2. Configure DNS for pages domain

    3. Push your static site

    4. Access at the pages URL


    Combined with Gitea Actions for building, you get a complete self-hosted GitHub Pages + Actions experience.