Skip to main content
Table of contents

Development VM

SSH into GOV.UK servers from the VM

By default, your SSH agent is forwarded to the VM. To confirm your key has been forwarded you can run:

$ vagrant ssh # ssh onto vm
$ ssh-add -L  # list key and location on host machine

Things to check if it doesn’t work:

  • Can you SSH directly onto the jumpbox? ssh If not, check your ssh version (ssh -V) and config (~/.ssh/config). You can also try ssh jumpbox.integration.
  • Do you get a permission denied error? Make sure you’re in the user list in the govuk-secrets repo for production access (restricted access; ask your tech lead or line manager for access), or the govuk-puppet repo for access to other environments. Alternatively, are you the correct user? If you’re in the VM you might need to specify a username (example: ssh, as ‘vagrant’ might be the default ssh username.
  • Are you connecting from outside The White Chapel Building? You’ll need to connect to the VPN first; SSH connections are restricted to the White Chapel Building IP addresses.
This page was last reviewed on 10 September 2019. It needs to be reviewed again on 10 March 2020 by the page owner #govuk-2ndline .
This page was set to be reviewed before 10 March 2020 by the page owner #govuk-2ndline. This might mean the content is out of date.