Skip to content

Documentation Site Hosting

River Oaks Church - Updated August 2026

The documentation source lives in the River Oaks GitLab riveroaks/docs project and is built with MkDocs by GitLab CI.

Each successful main build deploys the same static site to two locations:

  • docs.riveroaks.cc is served locally from rocc-db for devices on the River Oaks campus or Cloudflare WARP private network.
  • docs.ro.church is hosted on Cloudflare Pages behind Cloudflare Access and remains the authenticated fallback.

The local deployment stores immutable releases under /srv/riveroaks-docs/releases, verifies the candidate, atomically switches the current link, and rolls back automatically if either the nginx health endpoint or the site homepage fails. Nginx configuration is managed from the riveroaks/infra repository rather than edited directly on the server.

Pushing a reviewed change to main rebuilds and deploys both copies automatically. The Cloudflare Pages site can remain available if the church connection or local docs deployment is unavailable.