Prerequisites

This page covers everything you need before installing CIPP on your own infrastructure.

If you choose to sponsor and use the CyberDrain hosted version, you can skip over these steps and jump over to Sponsor Quick Start guide for further direction.

To get started you must follow or have the following ready. Click on the links for instructions on how to perform some of these tasks, or for more information on the functionality in question.

1

Microsoft Tenant Requirements

• Multi-Tenant Mode: A Microsoft Partner account with your clients’ tenants added. If you’re an MSP managing multiple tenants, this is essential for CIPP to function across them.

2

GitHub Forks

Fork each repository into your own GitHub organization so you can push updates, track changes, and deploy under your namespace.

• CIPP Frontend Fork: GitHub Repo

• CIPP API Fork: GitHub Repo

3

Azure Subscription

You’ll need an active Azure Subscription where your CIPP resources (Function Apps, Static Web Apps, Key Vault, etc.) will live. If you’re new to Azure, check out Azure’s free trial or confirm your existing subscription’s permissions

4

GitHub Personal Access Token

CIPP uses Azure Static Web Apps (SWA) to deploy from GitHub. You’ll need a classic PAT (Personal Access Token) with the relevant repo permissions included in Microsoft’s Create a GitHub Personal Access Token documentation.

5

(Optional) Microsoft 365 Lighthouse License

• Recommended for MSP Usage: A Microsoft 365 Lighthouse license is needed to access various API endpoints used in CIPP, but CIPP will function without it.

• If you buy a Lighthouse license purely for CIPP, remember to accept the EULA in the Lighthouse portal to activate it.

6

Azure Expertise (Assumed)

For the installation and maintenance of CIPP, we assume you’re comfortable with:

• Azure Functions: Learn more

• Azure Static Web Apps: Learn more

• Azure Key Vault: Learn more

• Azure Cost Management: Learn more

• Azure Storage (Tables, Blobs, Files): Learn more

The linked resources above will help you understand the Azure services CIPP depends on that you will be required to configure and maintain. If you’re missing any of these skills, we suggest reviewing these before proceeding. Proper knowledge ensures a smooth deployment and ongoing maintenance.

Failing to understand proper deployment and maintenence of an application deployed to Azure can lead to ballooning costs.

7

GitHub Expertise (Assumed)

For the installation and maintenance of CIPP, understanding how to manage a GitHub repository and app deployment is crucial for the ongoing performance of CIPP. The issues that you can run into with app deployment and updates can be quite numerous and not being familiar with how to troubleshoot those issues can cause you to have your application fail to update. Of course, if you get stuck you can ask in #cipp-community-help in Discord.

---

You’re Ready for Installation Once you’ve checked off these prerequisites, move on to the next page to set up your self-hosted instance. Happy CIPPing!