Prometheus documentation: content and static site generator
This repository contains both the content and the static-site generator code for the Prometheus documentation site.
Documentation concerning the Prometheus server is maintained in the Prometheus server repository and cloned into the website at build time.
As a guideline, please keep the documentation generally applicable and avoid use-case-specific changes.
You need to have a working Ruby environment set up (including bundler) and then install the necessary gems:
cd docs make bundle
To generate the static site, run:
The resulting static site will be stored in the
Optionally, you can use an API token to avoid rate limits on the API. You can get an API token from https://github.com/settings/tokens/new.
bash export GITHUB_AUTHENTICATION='-u user:token'
To run a local server that displays the generated site, run:
# Rebuild the site whenever relevant files change: make guard # Start the local development server in a separate shell: make serve
You should now be able to view the generated site at http://localhost:3000/.
This site is automatically deployed using Netlify.
If you have the prerequisite access rights, you can view the Netlify settings here:
Changes to the
masterbranch are deployed to the main site at https://prometheus.io.
Netlify also creates preview deploys for every pull request. To view these for a PR where all checks have passed:
You may have to wait a while for the "deploy/netlify" check to appear after creating or updating the PR, even if the other checks have already passed.
Apache License 2.0, see LICENSE.