> For the complete documentation index, see [llms.txt](https://docs.pharos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pharos.ai/configuration-guide/the-basics.md).

# The Basics

Essential prerequisites for getting Pharos up and running in your Salesforce org.

Before you begin configuring Pharos, two foundational steps must be in place: the managed package must be installed, and a running user must be designated. Everything else in this guide builds on these prerequisites.

***

## What You'll Set Up

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>📥 Package Installation</strong></td><td>Deploys the Pharos managed package into your Salesforce org (~10 minutes).</td><td><a href="https://docs.pharos.ai/configuration-guide/the-basics/package-installation.md">Package Installation</a></td></tr><tr><td><strong>👤 Pharos Running User</strong></td><td>Designates the user identity under which Pharos executes background processes (~5 minutes).</td><td><a href="https://docs.pharos.ai/configuration-guide/the-basics/pharos-running-user.md">Pharos Running User</a></td></tr><tr><td><strong>⬆️ Upgrade</strong></td><td>Upgrade an existing installation to a new major release — package, permission sets, running user, Triton subscriber.</td><td><a href="https://docs.pharos.ai/configuration-guide/the-basics/upgrade.md">Upgrade</a></td></tr><tr><td><strong>🗑️ Uninstall</strong></td><td>Cleanly remove Pharos — delete the email service, then uninstall the package.</td><td><a href="https://docs.pharos.ai/configuration-guide/the-basics/uninstall.md">Uninstall</a></td></tr></tbody></table>

{% hint style="warning" %}
**Decide the running user before opening Pharos Admin.** The first user to open the Pharos Admin page becomes the running user by default. Log in as the intended user (or create a dedicated integration user) before you open Pharos Admin for the first time.
{% endhint %}

***

## Installing the Pharos Package

You can obtain the Pharos managed package through one of the following options:

| Option                          | Link                                                                                                     | Use Case                                                                       |
| ------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Pharos Free**                 | [Sign up from our website](https://pharos.ai/pricing/102)                                                | Free edition — no cost, no hidden fees                                         |
| **AppExchange**                 | [AppExchange listing](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMhhvUAD) | By default, installs the free (Core) edition — click **Get It Now** to install |
| **Paid Edition Trials**         | [pharos.ai/pricing](https://pharos.ai/pricing)                                                           | Growth, Professional, and Enterprise trial links                               |
| **Direct Install — Production** | [resources.pharos.ai/pharos-prod](https://resources.pharos.ai/pharos-prod)                               | Install straight into a production or Developer Edition org                    |
| **Direct Install — Sandbox**    | [resources.pharos.ai/pharos-sandbox](https://resources.pharos.ai/pharos-sandbox)                         | Install straight into a sandbox                                                |

<details>

<summary>Paid edition trial links</summary>

* [Growth trial](https://pharos.ai/pricing/104) — up to 500 users
* [Professional trial](https://pharos.ai/pricing/103) — up to 1,000 users
* [Enterprise proof of concept](https://pharos.ai/pricing/105) — custom pricing

</details>

When you sign up for the free edition or submit a paid trial form on the Pharos website, you will receive a direct install link by email. AppExchange provides the link immediately when you click **Get It Now**. The installation flow follows the standard Salesforce package installer; the entire process typically takes about 10 minutes, depending on how quickly the package deploys in your org.

{% hint style="info" %}
**Pharos Free Edition** is completely free — now and forever. No hidden fees. This is our contribution to the Salesforce community.
{% endhint %}

***

## Before You Begin

Make sure you have the following ready:

* **System Administrator access** (or a profile with **Customize Application** and **View All Data**) to the target Salesforce org
* **Your installation source** — choose [Pharos Free](https://pharos.ai/pricing/102), the [AppExchange listing](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMhhvUAD) (free by default), or [paid edition trials](https://pharos.ai/pricing) to obtain your installation URL, or use the direct install link for [production](https://resources.pharos.ai/pharos-prod) or [sandbox](https://resources.pharos.ai/pharos-sandbox)
* **A user account** for the Pharos running user — by default, this is the user who first opens Pharos Admin (can be your admin account or a dedicated integration user)

{% hint style="info" %}
**Production and Sandbox:** You'll install Pharos separately in each environment, using the matching install link — [pharos-prod](https://resources.pharos.ai/pharos-prod) for production, [pharos-sandbox](https://resources.pharos.ai/pharos-sandbox) for sandboxes. Production and sandbox orgs each require their own installation and running user configuration.
{% endhint %}

***

## Recommended Order

1. **Install the package** — this deploys the custom objects, components, and configuration interfaces
2. **Designate the running user** — by default, the user who first opens Pharos Admin becomes the running user; this is confirmed when you run the [Quick Start](https://docs.pharos.ai/configuration-guide/quick-start.md) wizard

Once both steps are complete, proceed to the [Quick Start](https://docs.pharos.ai/configuration-guide/quick-start.md) wizard to activate error tracking, set up your connected org, and configure remote site settings.

{% hint style="success" %}
**Next Step:** Start with [Package Installation](https://docs.pharos.ai/configuration-guide/the-basics/package-installation.md) to deploy Pharos into your org.
{% endhint %}
