Deployment#

Deploying an instance of the Data Safe Haven involves the following steps:

  • Configuring the context used to host the Pulumi backend infrastructure

  • Configuring the Microsoft Entra directory where you will manage users

  • Deploying the Safe Haven management component

  • Deploying a Secure Research Environment for each project

Requirements#

Install the following requirements before starting

Docker Hub#

The Data Safe Haven uses several public Docker images. As Docker Hub now imposes rate limits on anonymous downloads, you will need to use a Docker Hub account to deploy the Data Safe Haven. You can create one following the instructions here if you do not already have one.

Important

We recommend using a personal access token (PAT) with Public Repo Read-Only permissions rather than your Docker account password. See the instructions here for details of how to create a PAT.

Install the project#

$ pipx install data-safe-haven

  • Or install a specific version with (for instance)

$ pipx install data-safe-haven==5.3.1

[Advanced] install into a virtual environment

If you prefer, you can install this package into a virtual environment:

$ python -m venv /path/to/new/virtual/environment
$ source /path/to/new/virtual/environment/bin/activate
$ pip install data-safe-haven

  • Test that this has worked by checking the version

$ dsh --version