pages.gay

A static site server for git.gay's pages.gay service

usage

follow instructions on pages.gay!

selfhosting

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
go build

configuration is done through a .env file:

# 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=80
HTTPS_PORT=443

ACME_ACCEPT_TERMS=true
ACME_EMAIL=example@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

# DNS provider for ACME DNS-01 challenges (wildcard certs).
# Supported values: cloudflare, porkbun, route53, hetzner, digitalocean,
# googleclouddns (or gcp), ovh, alidns (or alibaba/alicloud), powerdns,
# gandi, netcup, godaddy, inwx, duckdns, bunny, namecheap, technitium
# Defaults to "cloudflare" if not set.
DNS_PROVIDER=cloudflare

# --- Cloudflare ---
CLOUDFLARE_TOKEN=abcd1234

# --- Porkbun ---
# PORKBUN_KEY=
# PORKBUN_SECRET_KEY=

# --- Route53 (AWS) ---
# AWS_REGION=
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# AWS_SESSION_TOKEN=

# --- Hetzner ---
# HETZNER_API_TOKEN=

# --- DigitalOcean ---
# DIGITALOCEAN_AUTH_TOKEN=

# --- Google Cloud DNS ---
# GCP_PROJECT=
# GCP_SERVICE_ACCOUNT_JSON=

# --- OVH ---
# OVH_ENDPOINT=
# OVH_APPLICATION_KEY=
# OVH_APPLICATION_SECRET=
# OVH_CONSUMER_KEY=

# --- AliDNS (Alibaba Cloud) ---
# ALIDNS_ACCESS_KEY_ID=
# ALIDNS_ACCESS_KEY_SECRET=
# ALIDNS_REGION_ID=

# --- PowerDNS ---
# POWERDNS_SERVER_URL=
# POWERDNS_SERVER_ID=
# POWERDNS_API_TOKEN=

# --- Gandi ---
# GANDI_BEARER_TOKEN=

# --- Netcup ---
# NETCUP_CUSTOMER_NUMBER=
# NETCUP_API_KEY=
# NETCUP_API_PASSWORD=

# --- GoDaddy ---
# GODADDY_API_TOKEN=

# --- INWX ---
# INWX_USERNAME=
# INWX_PASSWORD=
# INWX_SHARED_SECRET=

# --- DuckDNS ---
# DUCKDNS_TOKEN=

# --- Bunny ---
# BUNNY_API_KEY=

# --- Namecheap ---
# NAMECHEAP_API_KEY=
# NAMECHEAP_USER=
# NAMECHEAP_CLIENT_IP=

# --- Technitium DNS Server ---
# TECHNITIUM_API_TOKEN=
# TECHNITIUM_API_URL=

features

• username.pages.gay pages
• username.pages.gay/repo pages
• custom domains
• https support
• auto-renewal of certificates
• support SPAs with _redirects file
• markdown rendering

license

the pages.gay server is copyright (c) hazycora 2023. it's under the OQL.

made with ❤️ by besties