A static site server for Forgejo instances.
sign into git.gay and make a repository called "pages". place static files in the repository (index.html for the homepage!) on the default branch, and visit
https://username.pages.gay in a browser!
you can make a page for a project by making a branch named "pages" in another repository, and putting your static files there. it can then be accessed at
to use a custom domain, create a .domains file in your repository with the domain you'd like to use.
then, add a DNS CNAME record on your domain pointing to
for apex domains, where CNAME records don't work, just add an A record pointing to
188.8.131.52, an AAAA record pointing to
2605:a142:2135:4519::1, and a TXT record with the content
selfhosting the pages.gay server somewhere else is simple- but you need a separate host for this. unlike typical web servers, where you can put them behind nginx and be fine, this server handles its own SSL in order to support custom domains.
git clone https://git.gay/gitgay/pages cd pages npm i
configuration is done through a
# the PAGES_DOMAIN should be just the domain, with no leading period: PAGES_DOMAIN=pages.gay FORGEJO_URL=https://git.gay # FORGEJO_USER_URL is needed for generated repository links if FORGEJO_URL is a local address inaccessible by users FORGEJO_USER_URL=https://git.gay PORT=443 ACME_ACCEPT_TERMS=true ACME_EMAILemail@example.com # mock ACME_DIRECTORY_URL, useful for testing: # ACME_DIRECTORY_URL=https://acme.mock.directory/ # staging LetsEncrypt: # ACME_DIRECTORY_URL=https://acme-staging-v02.api.letsencrypt.org/directory # actual LetsEncrypt: ACME_DIRECTORY_URL=https://acme-v02.api.letsencrypt.org/directory # A Cloudflare API token with Zone Edit permissions for the domain you'll be hosting this on. # This is used for solving the ACME challenges. CLOUDFLARE_TOKEN=abcd1234
- username.pages.gay pages
- username.pages.gay/repo pages
- custom domains
- https support
- auto-renewal of certificates
- custom 404 pages per-repo
- support SPAs with
- markdown rendering
the pages.gay server is copyright (c) hazycora 2023. it's under the AGPLv3 license.
made with ❤️ by besties