---
title: "Installs and Upgrades"
slug: "installation-instructions"
tags: ["Events"]
updated: 2025-04-07T15:53:03Z
published: 2025-04-07T15:53:03Z
canonical: "docs.blackthorn.io/installation-instructions"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackthorn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installs and Upgrades

## Install an App for the First Time

If you are using the Candy Shop for the first time, please review the instructions below. This example follows a user installing Events, but the steps are the same for Payments, Compliance, and Messaging.

          **Are you a Government Cloud user?**

          

If you are a Government Cloud user setting up Events or PayLink for the first time or creating a new Sandbox, please contact [Blackthorn Support](https://community.blackthorn.io/s/support) before starting the process.

---

If you are installing Events for the first time, the installer will automatically install the Base Package first, then Payments, and lastly Events. If either Base Package or Payments are already installed, the installer will ensure the correct versions are installed or upgraded before installing Events.

1. Go to the Blackthorn [Candy Shop](https://candyshop.blackthorn.io/products)[](https://candyshop.blackthorn.io/products).

2. Click **Blackthorn Events**.

![Events Install new icons](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Events%20Install%20new%20icons.png)

3. Click **Install Blackthorn Events - Click Here for Details**.

![Events Click here for Details New image](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Events%20Click%20here%20for%20Details%20New%20image.png)

4. Click **Log In to Install**.

5. Select **Sandbox** or **Production** or **Developer Org** (we recommend starting with Sandbox, but you can start directly in Production).

6. Log into your Salesforce org.

7. Click **Allow**.

![Allow Access](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Allow%20Access(1).png)

8. Click **Install**.

9. Agree to the Product Terms of Use and Licenses.

10. As each step is completed, a green checkmark will appear in the Install column. You’ll also receive an email to confirm the successful installation.

![Successful Install new image](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Successful%20Install%20new%20image.png)

11. Click **View Org** to go to your Salesforce Org.

## Upgrade an App

1. Go to the [Candy Shop](https://candyshop.blackthorn.io/products). For the following steps, we will use the Events app, but the steps are the same for the other apps.
2. Click **Blackthorn Events**.  

![Events Install new icons](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Events%20Install%20new%20icons.png)
3. Click **Product Upgrade**.  

![CandyShop_upgradeapps_clickupgrade](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CandyShop_upgradeapps_clickupgrade.png)
4. Click **Log in to Install**.  

![CandyShop_upgrade_clicklogin](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CandyShop_upgrade_clicklogin.png)
5. Select a **Production or Developer Org** or a **Sandbox or Scratch Org**.  

![CandyShop_upgrade_selectorg](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CandyShop_upgrade_selectorg.png)
6. Log into your org.
7. Click **Install**. As each step is completed, a green checkmark will appear in the Install column. You’ll also receive an email to confirm the successful installation.  

![CandyShop_upgrade_Install](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CandyShop_upgrade_Install.png)
8. Click **View Org** to go to your Salesforce Org.

After performing the upgrade, check the [Blackthorn | Events Admin tab’s Upgrade tab](https://docs.blackthorn.io/docs/events-admin-tab-upgrade) and [Blackthorn | Payments Admin tab’s Upgrade tab](https://docs.blackthorn.io/docs/blackthorn-payments-admin#upgrade) for additional metadata changes.