What is sourcehut pages?

Updated

sourcehut pages is a static site publishing tool built into the sourcehut platform. Every sourcehut user gets a username.srht.site domain for hosting static websites, and you can also bring your own domain. It works with any content generator—Jekyll, Hugo, Doxygen, or something custom—and provides automatic, zero-config TLS.

What it does

sourcehut pages takes static files you've already generated and serves them as a website. It doesn't build your site for you; you run your generator (Hugo, Jekyll, Doxygen, etc.) locally or in CI, then publish the output.

Key capabilities from the sourcehut pages documentation:

  • Free subdomain per user — every sourcehut user receives username.srht.site
  • Custom domains — you can point your own domain at sourcehut pages
  • Any static generator — Jekyll, Hugo, Doxygen, or a custom tool
  • Automatic TLS — zero-config HTTPS, no certificate management
  • Automated deployments — publish from CI or scripts
  • Permission management — control who can publish to a site
  • REST and GraphQL APIs — programmatic control over sites and deployments
  • Gemini support — serve content over the Gemini protocol as well

Who it's for

sourcehut pages fits people already using sourcehut for git hosting, bug tracking, or mailing lists who want to publish project documentation, blogs, or landing pages without leaving the platform. It's also a reasonable choice if you want a minimal static host with built-in TLS and don't need a build pipeline on the server side.

It's less suited if you need server-side rendering, databases, or a full CMS—it serves static files only.

How it compares to other static hosts

Aspect sourcehut pages Typical static host
Build step You build locally/CI Often built on server
TLS Automatic, zero-config Usually automatic
Domain username.srht.site + BYOD Varies
Protocol HTTP + Gemini HTTP only
Integration Native to sourcehut Standalone

Getting started

The documentation points to a quick start guide and claims you can be published in about three minutes. The general flow:

  1. Generate your static site with your chosen tool.
  2. Create a site on sourcehut pages.
  3. Publish the generated files (manually or via CI).
  4. Access it at username.srht.site or your custom domain.

For exact commands and configuration, see the Quick start and Custom domains pages in the sourcehut pages documentation, along with the sections on automating deployments, managing permissions, advanced settings, and limitations.