Skip to main content
Table of contents

Application: whitehall

Publishes government content on GOV.UK


#govuk-platform-health owns the application and is responsible for updating its dependencies.


The production version of this application is hosted on AWS.

SSH Access (AWS)

gds govuk connect ssh -e integration whitehall_backend
gds govuk connect ssh -e staging aws/whitehall_backend
gds govuk connect ssh -e production aws/whitehall_backend

Run a rake task

Relevant manual pages

Example pages published by whitehall


Warning The content below is pulled in directly from the repository.
Links might not function properly.

whitehall is a Ruby on Rails content management application for content published by government departments and agencies.


  • Govspeak A variation of Markdown used throughout whitehall as the general publishing format

Technical documentation

whitehall is a Ruby on Rails app built on a MySQL database. It is deployed in two modes: 'admin' for publishers to create and manage content and 'frontend' for rendering some content under and whitehall also sends most content to the publishing-api and rummager.


Local development dependencies

This application uses Ruby dependencies installed via Bundler and npm
installed via Yarn.

These can be installed with:

bundle install
yarn install

Dependent GOV.UK apps

Other documentation

Generating technical documentation

We use YARD for the technical documentation. You can generate a local copy with:

yard server --reload

You can also read the docs on


MIT License