The ASF Website

Clone this repo:
  1. 62f48d6 Merge pull request #205 from apache/legal-644-redirect by Brian Proffitt · 5 hours ago main
  2. f48f981 The page is back here by Sebb · 6 hours ago legal-644-redirect
  3. e74418a Merge pull request #202 from rvs/main by Brian Proffitt · 11 hours ago
  4. 21771a2 Merge pull request #200 from apache/obsolete by Brian Proffitt · 32 hours ago
  5. 6a2fc68 Merge pull request #203 from jogep/main by Brian Proffitt · 33 hours ago

Apache Foundation Website (

This repository provides the source for the main website of The Apache Software Foundation.

Linking to Markdown (.md) sources

Markdown (.md) files appear in the preview pane of the editor approximately as they will appear in the generated website. This is convenient for reviewing changes, but means that linking to the source requires a bit more work compared with other files. If you want to create a permalink or raise an issue that relates to a particular Markdown source line, proceed as follows:


Read the Getting started guide and the pages it links to.


The website is built with Pelican.

You can use the infrastructure-pelican Dockerfile build the website locally for testing.

Continuous Integration / Continuous Deployment (CI/CD) is via the .asf.yaml file mechanism, which runs Buildbot.

The svn history was not migrated and remains available.

Foundation records, including minutes of Board meetings, remain in svn, except for the index page.

Wimsy maintains the board calendar - in SVN. At the start of each build, a setup entry in pelicanconf.yaml calls the script, which copies the calendar into content/foundation/board.

Changes to the file do not automatically trigger a build, but the file changes rarely (about once a month) and there are regular builds which pick up changes within an hour or so.

Local development and testing

If you wish to update and test the site locally, there is a Docker build script you can use. You will also need Git, and familiarity with working in a command-line shell.

The following instructions should work for Unix, Linux, and macOS, but will need adjustment for Windows.

  • Install Docker.
  • Change to a suitable directory.
  • Get the Infra Pelican setup: git clone
  • Change to the checkout: cd infrastructure-pelican.
  • Build the container: docker build -t pelican-asf .. This will take a while the first time.
  • Change to a suitable directory.
  • Get the ASF website source: git clone
  • Change to the website checkout: cd www-site.
  • Create a dummy authorisation file: touch .authtokens.
  • Start the continuous builder: docker run -it -p8000:8000 -v $PWD:/site pelican-asf. This will generate a lot of output, but will eventually stop. [N.B. Pelican calls the data generation plugins 3 times before generating the pages.]
  • If you want to add some additional debug output, add the following line to pelicanconf.yaml: debug: true
  • Browse to http://localhost:8000/ .
  • If the builder reports a failure trying to find content/theme/apache, try changing the theme entry in pelicanconf.yaml to theme: ../theme/apache and re-run

If you make changes to the local copy of www-site, these will be automatically built, and should appear in the browser when you refresh the page.

Previewing proposed changes

Any branch in the www-site repository that is named preview/* will auto-build and stage to www-*

If you need to test your changes, create a branch such as preview/your-asf-id

Commits to it will be staged at