Skip to main content

Installation

You can install CIPP two different ways, click-to-deploy and manual. When you use a hosted setup, this is all performed for you.

A click-to-deploy install is the preferred way to install CIPP using a GitHub fork of the CIPP UI and API repositories. It utilises Azure deployment templates to automate the deployment of the CIPP UI and API.

A manual install is an advanced method of installing CIPP, requiring more knowledge of Git and Azure but providing wider choice of Git hosting services and greater flexibility around deployment.

Detailed information about each of these installation methods is in the tabs below:

Installation Tips

You must replace the preset "Github Repository" and "Github API Repository" fields with the URL's of your own Github forks of the CIPP and CIPP-API repositories

Unless you know what you're doing manual installation isn't advised, there's a lot of moving parts where one could make a mistake. You must use the manual installation instructions if you wish to host your repository in Azure DevOps or GitLab.

caution

Please read all of the instructions below before proceeding to click the "Deploy to Azure" button, to determine which option you should select.

After you have completed the prerequisites in the Prerequisites section, select the button below to run the automated setup. This does most of the work for you. If you don't want to use the automated installer, use the manual installation instructions.

Deploy to an another region

Azure Static Web Apps (SWA) is global by default (it picks the data center closest to you) however some regions don't support deployment. Regions that support SWA deployment at the moment are:

  • Central US
  • East US 2
  • East Asia
  • West Europe
  • West US 2

To work around this use the alternative installation button below. This deploys the Static Web App in the Central US region however the SWA gets served from your nearest data center anyway. The other parts of CIPP get installed in the region you choose so you shouldn't experience any latency.