Skip to main content
Warning This document has not been updated for a while now. It may be out of date.
Last updated: 12 Jan 2022

SSH into machines

This document explains how to SSH into machines, and what commands exist to navigate machines and applications quickly. We use a tool called [GOV.UK Connect] to make this easier.


If you know the class of machine you want, you can SSH straight from the command line:

$ gds govuk connect -e staging ssh cache

This will automatically SSH into a random cache machine on AWS.

You can connect to a consistent machine by its index:

$ gds govuk connect -e staging ssh cache:1

To see all classes, run:

$ gds govuk connect -e staging ssh *

You can connect to specific machines if you know their internal IP address:

$ gds govuk connect ssh -e integration

You can also start a Rails Console on a remote server, from your local machine:

$ gds govuk connect -e staging app-console publishing-api

For a full list of commands, run gds govuk connect --help.


See Unable to SSH into a machine.