Bovine Pages Server Wiki
Welcome to the Bovine Pages Server documentation! This project brings GitHub Pages-style static site hosting to the open source Git platforms Forgejo and Gitea.
What is Bovine Pages Server?
Bovine Pages Server is a Traefik middleware plugin that transforms your self-hosted Forgejo or Gitea instance into a powerful static site hosting platform. Similar to how GitHub Pages, GitLab Pages, and Codeberg Pages work, it automatically serves static websites directly from your Git repositories.
Key Capabilities
Designed as a native Traefik plugin, Bovine Pages Server integrates effortlessly into your existing Traefik reverse proxy setup without requiring separate web servers or complex configurations. It serves static files from the public/ folder of any repository, making deployment as simple as git push while keeping your static sites alongside your source code in version control. The plugin brings the convenience and workflow of GitHub Pages to the open source ecosystem, enabling you to host documentation, project websites, personal blogs, and web applications all from your self-hosted Git platform. Built with production-ready features including caching, automatic HTTPS, custom domains, and password protection, it provides everything needed for real-world deployments.
Quick Links
Getting Started
- 🚀 Quick Start Guide - Start here! Complete setup with Traefik and Docker
User Documentation
- 📖 Configuration Guide
- 🔒 Password Protection
- 🌐 Custom Domains
- 🔄 Custom Domain Redirects - URL redirects for custom domains
- 📁 Directory Listings - Apache-style file browser
- 📋 Examples
- 🔧 Troubleshooting
Maintenance & Operations
- 💾 Cache Management - View, inspect, and flush cache for specific sites
- 🧹 Cache Reaper - Automated cleanup of stale domain mappings
Implementation Details
External Links
Features
- ✅ Static site hosting from
public/folders - ✅ Automatic HTTPS with Let's Encrypt
- ✅ Custom domain support
- ✅ URL redirects - 301 permanent redirects for custom domains
- ✅ Password protection for private sites
- ✅ Directory index support (auto
index.html) - ✅ Directory listings - Apache-style file browser (optional)
- ✅ Redis caching for high performance
- ✅ Profile sites and custom error pages
Getting Started
Ready to host your static sites? Check out our comprehensive Quick Start Guide for step-by-step instructions on setting up Bovine Pages Server with Traefik and Docker.
Support
- Issues: Report a bug
- Repository: View source code
- Changelog: See all changes